4 releases (2 breaking)
| 0.13.2 | Mar 27, 2022 |
|---|---|
| 0.12.0 | Oct 20, 2021 |
| 0.10.1 | Aug 17, 2021 |
| 0.10.0 | Jul 26, 2021 |
#1180 in Database interfaces
455KB
28K
SLoC
_ __ __ _ ___| |_ ___ _ __
| '_ \ / _` / __| __/ _ \| '__|
| |_) | (_| \__ \ || (_) | |
| .__/ \__,_|___/\__\___/|_|
|_|
The pastebin that hopefully doesn't suck
Description
===========
pastor was born out of frustration with other pastebins and their shortcomings
- require an external database, hassel to set up.
- have very unreliable mime type parsing leading to
files being returned with the wrong mime type
- won't show files in the browser but only prompt to download
pastor tries to do better
- ensure content-disposition headers are set to inline to display in browser
- only interfere with mimetypes where needed
- sets all text/* mime types to text/plain to avoid inline
rendering of e.g. html and thus injection of external resources.
- file extensions are for squishy humans
- try to guess an extension based on the mime type
but only if absolutely sure it's the correct one
- file extensions can be set to whatever the user desires,
they are ignored when accessing the paste.
- easy to set up, single binary, no external dependencies
- release binaries are staticly deployed, container image provided.
- uses an embedded database, sled, to store paste metadata.
- various templates like this page are compiled in by default
but can be customized by providing external files.
Installation
============
To run pastor with docker or podman:
podman run -p 80:8000 -v <storage path>:/storage kube.cat/cocainefarm/pastor:latest
To run pastor using the binary:
curl -Lo pastor https://gitlab.com/api/v4/projects/17469937/packages/generic/pastor/0.13.0/pastor_amd64_static
chmod +x pastor
ROCKET_STORAGE_DIR=<storage path> ./pastor
Usage
=====
Files
-----
Upload
Upload files:
-----------------------------------------------------------------------------------
$ curl -F a=@vim.png b=@vim2.png https://{{ url }}/
https://{{ url }}/picturedsalters aloofgremlins
-----------------------------------------------------------------------------------
The second string is a token needed to authenticate for
modifying or deleteing your uploads.
Retrieve
Retrieve file:
-----------------------------------------------------------------------------------
GET https://{{ url }}/picturedsalters
-----------------------------------------------------------------------------------
View file with syntax highlighting:
-----------------------------------------------------------------------------------
GET https://{{ url }}/picturedsalters?lang=rust
GET https://{{ url }}/picturedsalters?lang=auto (attempts detection)
-----------------------------------------------------------------------------------
Delete
Delete file:
-----------------------------------------------------------------------------------
$ curl -X DELETE https://{{ url }}/picturedsalters?token=aloofgremlins
or
GET https://{{ url }}/delete/picturedsalters?token=aloofgremlins
-----------------------------------------------------------------------------------
Expiry
======
Files expire after an mount of time calculated based on the following formula:
min_age + (-max_age + min_age) * (size / max_size - 1)^3
Where min_age is 5 days, max_age is 365 days, and the maximum size is 512MiB.
days
350 |.
| ..
| ..
300 |- ..
| ..
250 |- .
| ..
| ..
200 |- ..
| ..
| ..
150 |- ...
| ...
| ...
100 |- ...
| ....
50 |- ......
| ......
| ............................
0 +------------|-------------|------------|-------------|------------|-+
0 100 200 300 400 500 MiB
GUI
=====
A graphical user interface is available at: https://{{ url }}/gui
Source
=====
The source code can be found at: https://gitlab.com/cocainefarm/pastor
Dependencies
~27–60MB
~1M SLoC