Easy and fast file sharing from the command-line.
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
Easy and fast file sharing from the command-line. This code contains the server with everything you need to create your own instance.
Transfer.sh currently supports the s3 (Amazon S3), gdrive (Google Drive) providers, and local file system (local).
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt
$ cat /tmp/hello.txt|gpg -ac -o-|curl -X PUT --upload-file "-" https://transfer.sh/test.txt
$ curl https://transfer.sh/1lDau/test.txt|gpg -o- \> /tmp/hello.txt
$ curl -X PUT --upload-file nhgbhhj https://transfer.sh/test.txt/virustotal
$ curl -X DELETE <x-url-delete response header url> </x-url-delete>
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Downloads: 1" # Limit the number of downloads
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Days: 1" # Set the number of days before deletion
The URL used to request the deletion of a file. Returned as a response header.
bash curl -sD - --upload-file ./hello https://transfer.sh/hello.txt | grep 'X-Url-Delete' X-Url-Delete: https://transfer.sh/hello.txt/BAYh0/hello.txt/PDw0NHPcqU
See good usage examples on examples.md
Create direct download link:
Parameter | Description | Value | Env --- | --- | --- | --- listener | port to use for http (:80) | | LISTENER | profile-listener | port to use for profiler (:6060) | | PROFILE_LISTENER | force-https | redirect to https | false | FORCE_HTTPS tls-listener | port to use for https (:443) | | TLS_LISTENER | tls-listener-only | flag to enable tls listener only | | TLS_LISTENER_ONLY | tls-cert-file | path to tls certificate | | TLS_CERT_FILE | tls-private-key | path to tls private key | | TLS_PRIVATE_KEY | http-auth-user | user for basic http auth on upload | | HTTP_AUTH_USER | http-auth-pass | pass for basic http auth on upload | | HTTP_AUTH_PASS | ip-whitelist | comma separated list of ips allowed to connect to the service | | IP_WHITELIST | ip-blacklist | comma separated list of ips not allowed to connect to the service | | IP_BLACKLIST | temp-path | path to temp folder | system temp | TEMP_PATH | web-path | path to static web files (for development or custom front end) | | WEB_PATH | proxy-path | path prefix when service is run behind a proxy | | PROXY_PATH | proxy-port | port of the proxy when the service is run behind a proxy | | PROXY_PORT | ga-key | google analytics key for the front end | | GA_KEY | uservoice-key | user voice key for the front end | | USERVOICE_KEY | provider | which storage provider to use | (s3, gdrive or local) | PROVIDER | aws-access-key | aws access key | | AWS_ACCESS_KEY | aws-secret-key | aws access key | | AWS_SECRET_KEY | bucket | aws bucket | | BUCKET | s3-endpoint | Custom S3 endpoint. | | S3_ENDPOINT | s3-region | region of the s3 bucket | eu-west-1 | S3_REGION | s3-no-multipart | disables s3 multipart upload | false | S3_NO_MULTIPART | s3-path-style | Forces path style URLs, required for Minio. | false | S3_PATH_STYLE | basedir | path storage for local/gdrive provider | | BASEDIR | gdrive-client-json-filepath | path to oauth client json config for gdrive provider | | GDRIVE_CLIENT_JSON_FILEPATH | gdrive-local-config-path | path to store local transfer.sh config cache for gdrive provider| | GDRIVE_LOCAL_CONFIG_PATH | gdrive-chunk-size | chunk size for gdrive upload in megabytes, must be lower than available memory (8 MB) | | GDRIVE_CHUNK_SIZE | lets-encrypt-hosts | hosts to use for lets encrypt certificates (comma seperated) | | HOSTS | log | path to log file| | LOG | cors-domains | comma separated list of domains for CORS, setting it enable CORS | | CORS_DOMAINS | clamav-host | host for clamav feature | | CLAMAV_HOST | rate-limit | request per minute | | RATE_LIMIT |
If you want to use TLS using lets encrypt certificates, set lets-encrypt-hosts to your domain, set tls-listener to :443 and enable force-https.
If you want to use TLS using your own certificates, set tls-listener to :443, force-https, tls-cert-file and tls-private-key.
Switched to GO111MODULE
go run main.go --provider=local --listener :8080 --temp-path=/tmp/ --basedir=/tmp/
If on go < 1.11
bash go get -u -v ./...
go build -o transfersh main.go
For easy deployment, we've created a Docker container.
docker run --publish 8080:8080 dutchcoders/transfer.sh:latest --provider local --basedir /tmp/
For the usage with a AWS S3 Bucket, you just need to specify the following options: - provider - aws-access-key - aws-secret-key - bucket - s3-region
If you specify the s3-region, you don't need to set the endpoint URL since the correct endpoint will used automatically.
To use a custom non-AWS S3 provider, you need to specify the endpoint as definied from your cloud provider.
For the usage with Google drive, you need to specify the following options: - provider - gdrive-client-json-filepath - gdrive-local-config-path - basedir
You need to create a Oauth Client id from console.cloud.google.com download the file and place into a safe directory
go run main.go --provider gdrive --basedir /tmp/ --gdrive-client-json-filepath /[credential\_dir] --gdrive-local-config-path [directory\_to\_save\_config]
Contributions are welcome.
Code and documentation copyright 2011-2018 Remco Verhoef. Code released under the MIT license.