dutchcoders /transfer.sh

Easy and fast file sharing from the command-line.

★ 15,911⑂ 1,580👁 200⑃ 266● 408▤ 19
GoMITCreated 2014-10-09github.com/dutchcoders/transfer.sh
下载:v1.6.1v1.6.1 ↓1.6.12023-12-04
-1
日增长
15,911
stars
1,580
forks
200
watchers
266
prs
408
issues
19
releases

README

Policy on providing or accepting a fix for a Vulnerability

Any vulnerability discovered through LLM analysis, or other equivalent fashion, is totally up to my discretion to be fixed or a fix for it to be accepted. People relying to such technologies for finding vulnerabilities are the only people holding liabilities for eventually dooming the project for a vulnerability that won't be fixed. So, FYI, just behave and don't rush exploiting world resources to be sure a service will run forever unflawed, when no more humankind will be left to actually use the service: I'm not going to be an accomplice of any "lemmings" frenzy around here.

 SECURITY WARNING

IP filter and HTTP auth bypass via unauthenticated X-Forwarded-For header spoofing


 transfer.sh  

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), storj (Storj) providers, and local file system (local).



---



 Disclaimer

@stefanbenten happens to be a maintainer of this repository _and_ the person who host a well known public installation of the software in the repo.

The two are anyway unrelated, and the repo is not the place to direct requests and issues for any of the pubblic installation.

No third-party public installation of the software in the repo will be advertised or mentioned in the repo itself, for security reasons.

The official position of me, @francescayeye, as maintainer of the repo, is that if you want to use the software you should host your own installation.



---



 Usage

This section outlines how to use transfer.sh



 Upload

bash
$ curl -v --upload-file ./hello.txt https://transfer.sh/hello.txt




 Encrypt & Upload

bash
$ gpg --armor --symmetric --output - /tmp/hello.txt | curl --upload-file - https://transfer.sh/test.txt




 Download & Decrypt

bash
$ curl https://transfer.sh/1lDau/test.txt | gpg --decrypt --output /tmp/hello.txt




 Upload to Virustotal

bash
$ curl -X PUT --upload-file nhgbhhj https://transfer.sh/test.txt/virustotal




 Deleting

bash
$ curl -X DELETE 




---



 Request Headers

This section explains how to handle request headers with curl:



 Max-Downloads

bash
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Downloads: 1"  Limit the number of downloads




 Max-Days

bash
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt -H "Max-Days: 1"  Set the number of days before deletion




 X-Encrypt-Password

 Beware, use this feature only on your self-hosted server: trusting a third-party service for server side encryption is at your own risk
bash
$ curl --upload-file ./hello.txt https://your-transfersh-instance.tld/hello.txt -H "X-Encrypt-Password: test"  Encrypt the content server side with AES256 using "test" as password




 X-Decrypt-Password
 Beware, use this feature only on your self-hosted server: trusting a third-party service for server si

Top issues

Latest release

v1.6.1 v1.6.1 2023-12-04
Security alert
The fix introduced on v1.6.0 (https://github.com/dutchcoders/transfer.sh/pull/564) still had a bug allowing any IP to bypass basic http auth in case an IP whitelist was set, regardless the IP was matching the IP or not. This release include the fix for the bug.

 What's Changed
 server/server.go: use TLS config provided by acme/autocert by @stefanbenten in https://github.com/dutchcoders/transfer.sh/pull/567
 Bump golang.org/x/net from 0.8.0 to 0.17.0 by @dependabot in https://github.com/dutchcoders/transfer.sh/pull/581
 deps: remove ioutil package by @ginglis13 in https://

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON