Very simple REST based File Storage Server
If you already run Go,
go install github.com/gildas/cantina@latestUsing Docker:
docker run -d -p 80:8080 -v /path/to/storage:/var/storage gildas/cantinaYou can access cantina via simple REST commands in order to upload, delete, download files.
Typically, downloads are anonymous and uploads/deletes are secured by keys.
Downloading content is very easy and does not require any credential (by default):
Using httpie:
http --download http://cantina/api/v1/files/picture.pngCurl:
curl -sSLO http://cantina/api/v1/files/picture.pngOr with PowerShell:
Invoke-RestMethod https://cantina/api/v1/files/picture.png -OutFile picture.pngIf the file is protected by a password, you will need to provide it, either in the query (not really secure!) or in the headers (Authorization header):
http --download http://cantina/api/v1/files/picture.png?password=secret
http --auth-type=bearer --auth=secret --download http://cantina/api/v1/files/picture.pngcurl -sSLO http://cantina/api/v1/files/picture.png?password=secret
curl -sSLO http://cantina/api/v1/files/picture.png -H 'Authorization: bearer secret'Invoke-RestMethod https://cantina/api/v1/files/picture.png?password=secret `
-OutFile picture.png
Invoke-RestMethod https://cantina/api/v1/files/picture.png `
-OutFile picture.png `
-Headers @{ 'Authorization='bearer secret' }If the file has versions, you can specify the version you want to download:
http --download http://cantina/api/v1/files/picture.png?version=1curl -sSLO http://cantina/api/v1/files/picture.png?version=1Invoke-RestMethod https://cantina/api/v1/files/picture.png?version=1 `
-OutFile picture.pngYou can ask for the latest version as well.
Upload stuff using httpie:
http --auth-type=bearer --auth=12345678 --form POST http://cantina/api/v1/files file@~/Downloads/picture.png
http --form POST http://cantina/api/v1/files X-Key:12345678 file@~/Downloads/picture.pngYou can also pass your key in the query, which is less secure:
http --form POST http://cantina/api/v1/files?key=12345678 file@~/Downloads/picture.pngCurl:
curl -H 'Authorization: bearer 12345678' -F 'file=@myfile-0.0.1.min.js' https://cantina/upload
curl -H 'X-key:12345678' -F 'file=@myfile-0.0.1.min.js' https://cantina/upload
curl -F 'file=@myfile-0.0.1.min.js' https://cantina/upload?key=12345678Or with PowerShell:
Invoke-RestMethod https://cantina/api/v1/files `
-Method Post `
-Headers @{ 'Authorization' = 'bearer 12345678' } `
-Form @{ file = Get-Item ./picture.png }
Invoke-RestMethod https://cantina/api/v1/files `
-Method Post `
-Headers @{ 'X-Key' = '12345678' } `
-Form @{ file = Get-Item ./picture.png }You can also set a time for the file to be automatically deleted (purged):
- The form value
purgeAfterwill delete the file after the given delay.
Synonyms: purgeIn, deleteAfter, deleteIn. - The form value
purgeOnwill delete the file on the give datetime.
Synonyms: purgeAt, deleteAt
For example:
http --form POST http://cantina/api/v1/files \
X-Key:12345678 \
file@~/Downloads/picture.png \
purgeIn=1hcurl -H 'X-key:12345678' \
-F 'file=@myfile-0.0.1.min.js' \
-F 'purgeIn=1h' \
https://cantina/uploadInvoke-RestMethod https://cantina/api/v1/files `
-Method Post `
-Headers @{ 'X-Key' = '12345678' } `
-Form @{ file = Get-Item ./picture.png; purgeIn = '1h' }You can also set a key or a password to protect the file:
- The form value
passwordwill protect the file with the given password.
For example:
http --form POST http://cantina/api/v1/files \
X-Key:12345678 \
file@~/Downloads/picture.png \
password=secretcurl -H 'X-key:12345678' \
-F 'password=secret' \
https://cantina/uploadInvoke-RestMethod https://cantina/api/v1/files `
-Method Post `
-Headers @{ 'X-Key' = '12345678' } `
-Form @{ file = Get-Item ./picture.png; password='secret' }You can configure the purge delay and the password after the file has been uploaded using the PATCH method:
http --form PATCH http://cantina/api/v1/files/picture.png \
X-Key:12345678 \
purgeAfter=1h
password=secretcurl -H 'X-key:12345678' \
-F 'purgeIn=1h' \
-F 'password=secret' \
https://cantina/upload/picture.pngInvoke-RestMethod https://cantina/api/v1/files/picture.png `
-Method Patch `
-Headers @{ 'X-Key' = '12345678' } `
-Form @{ purgeAt = '2024-12-31T23:59:59'; password='secret' }You can also set the maximum number of downloads for the file, after which it will be deleted:
http --form POST http://cantina/api/v1/files \
X-Key:12345678 \
file@~/Downloads/picture.png \
maxDownloads=10curl -H 'X-key:12345678' \
-F 'maxDownloads=10' \
https://cantina/uploadInvoke-RestMethod https://cantina/api/v1/files `
-Method Post `
-Headers @{ 'X-Key' = '12345678' } `
-Form @{ file = Get-Item ./picture.png; maxDownloads=10 }You can change that value with the PATCH method.
Deleting stuff using httpie:
http DELETE http://cantina/api/v1/files/picture.png X-Key:12345678Curl:
curl -H 'X-key:12345678' -X DELETE https://cantina/upload/picture.pngOr with PowerShell:
Invoke-RestMethod https://cantina/api/v1/files/picture.png `
-Method Delete `
-Headers @{ 'X-Key' = '12345678' } `Note: If the file had a thumbnail (images, etc), it is also deleted.