2017-03-22 22:48:08 +01:00
|
|
|
# transfer.sh [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/dutchcoders/transfer.sh?utm_source=badge&utm_medium=badge&utm_campaign=&utm_campaign=pr-badge&utm_content=badge) [![Go Report Card](https://goreportcard.com/badge/github.com/dutchcoders/transfer.sh)](https://goreportcard.com/report/github.com/dutchcoders/transfer.sh) [![Docker pulls](https://img.shields.io/docker/pulls/dutchcoders/transfer.sh.svg)](https://hub.docker.com/r/dutchcoders/transfer.sh/) [![Build Status](https://travis-ci.org/dutchcoders/transfer.sh.svg?branch=master)](https://travis-ci.org/dutchcoders/transfer.sh)
|
2014-10-16 20:01:43 +02:00
|
|
|
|
2014-10-20 14:54:42 +02:00
|
|
|
Easy and fast file sharing from the command-line. This code contains the server with everything you need to create your own instance.
|
|
|
|
|
2018-07-01 23:44:54 +02:00
|
|
|
Transfer.sh currently supports the s3 (Amazon S3), gdrive (Google Drive) providers, and local file system (local).
|
2014-10-16 20:01:43 +02:00
|
|
|
|
2014-10-16 20:08:40 +02:00
|
|
|
## Usage
|
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Upload:
|
|
|
|
```bash
|
2014-10-16 20:08:40 +02:00
|
|
|
$ curl --upload-file ./hello.txt https://transfer.sh/hello.txt
|
2018-08-13 22:14:54 +02:00
|
|
|
```
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Encrypt & upload:
|
|
|
|
```bash
|
2014-10-16 20:08:40 +02:00
|
|
|
$ cat /tmp/hello.txt|gpg -ac -o-|curl -X PUT --upload-file "-" https://transfer.sh/test.txt
|
2018-08-13 22:14:54 +02:00
|
|
|
````
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Download & decrypt:
|
|
|
|
```bash
|
2014-10-16 20:08:40 +02:00
|
|
|
$ curl https://transfer.sh/1lDau/test.txt|gpg -o- > /tmp/hello.txt
|
2018-08-13 22:14:54 +02:00
|
|
|
```
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Upload to virustotal:
|
|
|
|
```bash
|
2014-10-16 20:08:40 +02:00
|
|
|
$ curl -X PUT --upload-file nhgbhhj https://transfer.sh/test.txt/virustotal
|
2017-04-25 00:01:39 +02:00
|
|
|
```
|
2018-08-13 22:14:54 +02:00
|
|
|
|
2017-04-25 00:01:39 +02:00
|
|
|
## Add alias to .bashrc or .zshrc
|
2018-08-13 22:14:54 +02:00
|
|
|
|
|
|
|
### Using curl
|
|
|
|
```bash
|
2014-10-16 20:08:40 +02:00
|
|
|
transfer() {
|
2018-08-13 22:14:54 +02:00
|
|
|
curl --progress-bar --upload-file "$1" https://transfer.sh/$(basename $1) | tee /dev/null;
|
2014-10-16 20:08:40 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
alias transfer=transfer
|
2017-04-25 00:01:39 +02:00
|
|
|
```
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Using wget
|
|
|
|
```bash
|
|
|
|
transfer() {
|
|
|
|
wget -t 1 -qO - --method=PUT --body-file="$1" --header="Content-Type: $(file -b --mime-type $1)" https://transfer.sh/$(basename $1);
|
|
|
|
}
|
2018-08-13 08:56:08 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
alias transfer=transfer
|
|
|
|
```
|
2018-08-13 08:56:08 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
## Add alias for fish-shell
|
|
|
|
|
|
|
|
### Using curl
|
|
|
|
```bash
|
|
|
|
function transfer --description 'Upload a file to transfer.sh'
|
|
|
|
if [ $argv[1] ]
|
|
|
|
# write to output to tmpfile because of progress bar
|
|
|
|
set -l tmpfile ( mktemp -t transferXXX )
|
|
|
|
curl --progress-bar --upload-file "$argv[1]" https://transfer.sh/(basename $argv[1]) >> $tmpfile
|
|
|
|
cat $tmpfile
|
|
|
|
command rm -f $tmpfile
|
|
|
|
else
|
|
|
|
echo 'usage: transfer FILE_TO_TRANSFER'
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
funcsave transfer
|
|
|
|
```
|
2018-08-13 08:56:08 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
### Using wget
|
|
|
|
```bash
|
|
|
|
function transfer --description 'Upload a file to transfer.sh'
|
|
|
|
if [ $argv[1] ]
|
2018-09-22 10:46:28 +02:00
|
|
|
wget -t 1 -qO - --method=PUT --body-file="$argv[1]" --header="Content-Type: (file -b --mime-type $argv[1])" https://transfer.sh/(basename $argv[1])
|
2018-08-13 22:14:54 +02:00
|
|
|
else
|
|
|
|
echo 'usage: transfer FILE_TO_TRANSFER'
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
funcsave transfer
|
|
|
|
```
|
2018-08-13 08:56:08 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
Now run it like this:
|
|
|
|
```bash
|
|
|
|
$ transfer test.txt
|
|
|
|
```
|
2018-08-13 08:56:08 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
## Add alias on Windows
|
2017-10-11 10:21:10 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
Put a file called `transfer.cmd` somewhere in your PATH with this inside it:
|
|
|
|
```cmd
|
2017-10-11 10:21:10 +02:00
|
|
|
@echo off
|
|
|
|
setlocal
|
2018-06-18 08:36:44 +02:00
|
|
|
:: use env vars to pass names to PS, to avoid escaping issues
|
|
|
|
set FN=%~nx1
|
|
|
|
set FULL=%1
|
|
|
|
powershell -noprofile -command "$(Invoke-Webrequest -Method put -Infile $Env:FULL https://transfer.sh/$Env:FN).Content"
|
2017-10-11 10:21:10 +02:00
|
|
|
```
|
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
## Link aliases
|
|
|
|
|
|
|
|
Create direct download link:
|
|
|
|
|
|
|
|
https://transfer.sh/1lDau/test.txt --> https://transfer.sh/get/1lDau/test.txt
|
|
|
|
|
|
|
|
Inline file:
|
|
|
|
|
|
|
|
https://transfer.sh/1lDau/test.txt --> https://transfer.sh/inline/1lDau/test.txt
|
|
|
|
|
2017-03-22 22:44:56 +01:00
|
|
|
## Usage
|
2014-10-16 20:01:43 +02:00
|
|
|
|
2017-03-22 22:50:17 +01:00
|
|
|
Parameter | Description | Value | Env
|
|
|
|
--- | --- | --- | ---
|
|
|
|
listener | port to use for http (:80) | |
|
|
|
|
profile-listener | port to use for profiler (:6060)| |
|
|
|
|
force-https | redirect to https | false |
|
|
|
|
tls-listener | port to use for https (:443) | |
|
2018-07-07 19:05:16 +02:00
|
|
|
tls-listener-only | flag to enable tls listener only | |
|
|
|
|
tls-cert-file | path to tls certificate | |
|
2017-03-22 22:50:17 +01:00
|
|
|
tls-private-key | path to tls private key | |
|
2018-06-23 18:46:28 +02:00
|
|
|
http-auth-user | user for basic http auth on upload | |
|
|
|
|
http-auth-pass | pass for basic http auth on upload | |
|
2017-03-22 22:50:17 +01:00
|
|
|
temp-path | path to temp folder | system temp |
|
|
|
|
web-path | path to static web files (for development) | |
|
2018-06-26 18:39:56 +02:00
|
|
|
ga-key | google analytics key for the front end | |
|
|
|
|
uservoice-key | user voice key for the front end | |
|
2018-06-19 15:30:26 +02:00
|
|
|
provider | which storage provider to use | (s3, grdrive or local) |
|
2017-03-22 22:44:56 +01:00
|
|
|
aws-access-key | aws access key | | AWS_ACCESS_KEY
|
|
|
|
aws-secret-key | aws access key | | AWS_SECRET_KEY
|
|
|
|
bucket | aws bucket | | BUCKET
|
2018-06-19 15:30:26 +02:00
|
|
|
basedir | path storage for local/gdrive provider| |
|
2018-09-22 10:55:02 +02:00
|
|
|
gdrive-client-json-filepath | path to oauth client json config for gdrive provider| |
|
|
|
|
gdrive-local-config-path | path to store local transfer.sh config cache for gdrive provider| |
|
2019-03-18 20:52:38 +01:00
|
|
|
gdrive-chunk-size | chunk size for gdrive upload in megabytes, must be lower than available memory (8 MB) | |
|
2018-06-19 15:30:26 +02:00
|
|
|
lets-encrypt-hosts | hosts to use for lets encrypt certificates (comma seperated) | |
|
2018-08-13 08:56:08 +02:00
|
|
|
log | path to log file| |
|
2017-03-22 22:44:56 +01:00
|
|
|
|
|
|
|
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.
|
2014-10-16 20:48:07 +02:00
|
|
|
|
2017-03-22 22:44:56 +01:00
|
|
|
## Development
|
2014-10-16 20:48:07 +02:00
|
|
|
|
2017-03-22 22:44:56 +01:00
|
|
|
Make sure your GOPATH is set correctly.
|
2014-10-16 20:48:07 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
```bash
|
2018-10-26 23:28:47 +02:00
|
|
|
go run main.go --provider=local --listener :8080 --temp-path=/tmp/ --basedir=/tmp/
|
2014-10-16 20:48:07 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
## Build
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
```bash
|
2017-03-22 22:44:56 +01:00
|
|
|
go build -o transfersh main.go
|
2014-10-16 20:48:07 +02:00
|
|
|
```
|
2014-10-16 20:08:40 +02:00
|
|
|
|
2014-11-13 21:41:43 +01:00
|
|
|
## Docker
|
|
|
|
|
2018-07-01 23:44:54 +02:00
|
|
|
For easy deployment, we've created a Docker container.
|
2014-11-13 21:41:43 +01:00
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
```bash
|
2017-03-22 22:44:56 +01:00
|
|
|
docker run --publish 8080:8080 dutchcoders/transfer.sh:latest --provider local --basedir /tmp/
|
2014-11-13 21:41:43 +01:00
|
|
|
```
|
|
|
|
|
2014-10-16 20:08:40 +02:00
|
|
|
## Contributions
|
|
|
|
|
|
|
|
Contributions are welcome.
|
|
|
|
|
2018-08-13 08:56:08 +02:00
|
|
|
## Creators
|
2014-10-16 20:08:40 +02:00
|
|
|
|
|
|
|
**Remco Verhoef**
|
|
|
|
- <https://twitter.com/remco_verhoef>
|
|
|
|
- <https://twitter.com/dutchcoders>
|
|
|
|
|
|
|
|
**Uvis Grinfelds**
|
|
|
|
|
2018-10-27 00:15:55 +02:00
|
|
|
## Maintainer
|
|
|
|
|
|
|
|
**Andrea Spacca**
|
|
|
|
|
2014-10-16 20:08:40 +02:00
|
|
|
## Copyright and license
|
|
|
|
|
2018-08-13 22:14:54 +02:00
|
|
|
Code and documentation copyright 2011-2018 Remco Verhoef.
|
2018-08-13 08:56:08 +02:00
|
|
|
Code released under [the MIT license](LICENSE).
|