gone is an ephemeral content sharing server written in Go.
The primary goal is to enable sharing of a link, document or other file to another device on the network.
- In-memory storage - no file artifacts after program exits
- Share files with upload, download and list functionality
- Files expire (removed) after a number of downloads or duration of time
- JSON-based configuration, logging and server responses
- Token (string-based) authentication
- Request rate and size limits
- Basic user interface without scripts
- Share and clear short text messages
- No third-party dependencies
gone has not yet been subject to security audit and has several obvious vulnerabilities, such as lack of input validation.
Therefore, gone is only intended for use on a secure network with trusted devices, such as a private LAN.
To build the application on Linux:
make build
Binaries are built to release for distribution and installation.
To run the application on Linux:
make run
To run the application on Linux in debug mode:
make debug
Application output is structured in JSON format and can be parsed with jq for convenience, for example:
gone | jq .data
The optional -debug flag can be used for debug mode (additional verbose program output).
gone uses an embedded JSON-based configuration config/defaultSettings.json as default settings.
Copy the JSON file and use the -config flag to set server options:
gone -config=mySettings.json
The server provides a basic user interface for uploading, downloading and listing files at the default path (/):
All features are also available using command line programs such as curl:
Get server status:
curl localhost:8080/heartbeat
Upload file:
curl -F "file=@test.txt" http://localhost:8080/upload
With 3 allowed downloads before file expiration:
curl -F "downloads=3" -F "file=@test.txt" http://localhost:8080/upload
With a 15 minutes file expiration:
curl -F "duration=15m" -F "file=@test.txt" http://localhost:8080/upload
List uploaded files:
curl http://localhost:8080/list
Download file (the default configuration requires basic authentication):
curl -H "X-Auth: mySecret" "http://localhost:8080/download?name=test.txt"
Get static (never expires) content:
curl http://localhost:8080/static
Post a message to index:
curl -s -F 'message=hello, world!' http://localhost:8080 >/dev/null