0x0/README.rst

82 lines
2.2 KiB
ReStructuredText
Raw Permalink Normal View History

2016-11-01 05:17:54 +01:00
The Null Pointer
================
This is a no-bullshit file hosting and URL shortening service that also runs
2020-03-10 20:49:14 +01:00
`null.101010.fr <https://null.101010.fr>`_. Use with uWSGI.
2016-11-01 05:17:54 +01:00
If you are running nginx, you should use the ``X-Accel-Redirect`` header.
To make it work, include this in your nginx configs ``server`` block::
location /up {
internal;
}
where ``/up`` is whatever youve configured as ``FHOST_STORAGE_PATH``
in ``fhost.py``.
For all other servers, set ``FHOST_USE_X_ACCEL_REDIRECT`` to ``False`` and
``USE_X_SENDFILE`` to ``True``, assuming your server supports this.
Otherwise, Flask will serve the file with chunked encoding, which sucks and
should be avoided at all costs.
To make files expire, simply create a cronjob that runs ``cleanup.py`` every
now and then.
Before running the service for the first time, run ``./fhost.py db upgrade``.
2017-10-27 05:22:11 +02:00
NSFW Detection
--------------
0x0 supports classification of NSFW content via Yahoos open_nsfw Caffe
neural network model. This works for images and video files and requires
the following:
* Caffe Python module (built for Python 3)
* ``ffmpegthumbnailer`` executable in ``$PATH``
EXIF Stripping
--------------
When ``STRIP_IMAGE_EXIF`` is enabled, all images uploaded will be
processed through exiftool to strip all EXIF data except the orientation
tag.
Requires the ``exiftool`` script in ``$PATH``.
2019-06-30 04:22:52 +02:00
INSTALL
-------
2019-06-30 04:46:02 +02:00
::
2019-06-30 04:48:13 +02:00
2019-06-30 04:25:34 +02:00
apt update
apt install python3-pip nginx uwsgi uwsgi-plugin-python3 certbot
2020-03-10 20:49:14 +01:00
git clone https://git.101010.fr/101010/0x0 /srv/0x0
2019-06-30 04:46:02 +02:00
2019-06-30 04:25:34 +02:00
cd /srv/0x0
pip3 install --user `cat requirements.txt`
2019-06-30 04:46:02 +02:00
./fhost.py db upgrade
2019-06-30 04:25:34 +02:00
2019-06-30 04:22:52 +02:00
2016-11-01 05:17:54 +01:00
FAQ
---
Q:
What about file management? Will I be able to register an account at some
point?
A:
No.
Q:
Why are you storing IP addresses with each uploaded file?
A:
This is done to make dealing with legal claims and accidental uploads
easier, e.g. when a user requests removal of all text files uploaded from
a certain address within a given time frame (it happens).
Q:
Do you accept donations?
A:
Only if you insist. Ive spent very little time and effort on this service
and I dont feel like I should be taking money for it.