### Verschlüsseln & Hochladen```bash
$ gpg --armor --symmetric --output - /tmp/hello.txt | curl --upload-file - https://transfer.sh/test.txt

### Hochladen zu Virustotal```bash
$ curl -X PUT --upload-file nhgbhhj https://transfer.sh/test.txt/virustotal

<br />

---

<br />

## Anforderungs-Header

Dieser Abschnitt erklärt, wie Sie mit curl Anforderungs-Header verarbeiten können:

<br />

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

<br />

### X-Encrypt-Password

#### Vorsicht, verwenden Sie diese Funktion nur auf Ihrem selbst gehosteten Server: Die Nutzung eines Drittanbieterdienstes für serverseitige Verschlüsselung erfolgt auf eigenes Risiko```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

<br />

---

<br />

## Antwort-Header

In diesem Abschnitt wird erläutert, wie Antwort-Header behandelt werden:

<br />

### X-Url-Delete

Die URL, die zum Anfordern des Löschens einer Datei verwendet wird und als Antwort-Header zurückgegeben wird:```bash
curl -sD - --upload-file ./hello.txt https://transfer.sh/hello.txt | grep -i -E 'transfer\.sh|x-url-delete'
x-url-delete: https://transfer.sh/hello.txt/BAYh0/hello.txt/PDw0NHPcqU
https://transfer.sh/hello.txt/BAYh0/hello.txt

<br />

---

<br />

## Erstellen```bash
$ git clone [email protected]:dutchcoders/transfer.sh.git
$ cd transfer.sh
$ go build -o transfersh main.go

<br />

### Kein Root

Die mit `-noroot` gekennzeichneten Image-Builds laufen mit geringsten Privilegien, um die Angriffsfläche zu reduzieren, falls eine Anwendung kompromittiert wird.

> [!NOTE]
> Die Verwendung von `-noroot` wird **empfohlen**

<br />

Der mit dem Suffix `-noroot` getaggte verwendet `5000` sowohl als UID als auch GID:```bash
docker run --publish 8080:8080 dutchcoders/transfer.sh:latest-noroot --provider local --basedir /tmp/

<br />

---

<br />

## S3 Verwendung

Für die Verwendung mit einem AWS S3 Bucket müssen Sie lediglich die folgenden Optionen angeben:
- provider `--provider s3`
- aws-access-key _(entweder über Flag oder Umgebungsvariable `AWS_ACCESS_KEY`)_
- aws-secret-key _(entweder über Flag oder Umgebungsvariable `AWS_SECRET_KEY`)_
- bucket _(entweder über Flag oder Umgebungsvariable `BUCKET`)_
- s3-region _(entweder über Flag oder Umgebungsvariable `S3_REGION`)_

Wenn Sie die s3-region angeben, müssen Sie die Endpunkt-URL nicht festlegen, da der korrekte Endpunkt automatisch verwendet wird.

<br />

### Benutzerdefinierte S3-Anbieter

Um einen benutzerdefinierten Nicht-AWS S3-Anbieter zu verwenden, müssen Sie den von Ihrem Cloud-Anbieter definierten Endpunkt angeben.

<br />

---

<br />

## Storj Netzwerkanbieter

Um das Storj-Netzwerk als Speicheranbieter zu verwenden, müssen Sie die folgenden Flags angeben:
- provider `--provider storj`
- storj-access _(entweder über Flag oder Umgebungsvariable STORJ_ACCESS)_
- storj-bucket _(entweder über Flag oder Umgebungsvariable STORJ_BUCKET)_

<br />

### Bucket und Bereich erstellen

Sie müssen im Voraus einen Zugriffsgrant (oder aus der Uplink-Konfiguration kopieren) und einen Bucket erstellen.

Um zu beginnen, melden Sie sich bei Ihrem Konto an, gehen Sie zum Menü für Zugriffsgrants und starten Sie den Assistenten oben rechts.

Geben Sie Ihren gewünschten Zugriffsgrant-Namen ein, klicken Sie auf *Weiter* und schränken Sie ihn nach Bedarf/Präferenz ein.
Fahren Sie danach entweder in der CLI oder im Browser fort. Als Nächstes werden Sie nach einer Passphrase gefragt, die als Verschlüsselungsschlüssel dient.
**Stellen Sie sicher, dass Sie sie an einem sicheren Ort aufbewahren. Ohne sie verlieren Sie die Fähigkeit, Ihre Dateien zu entschlüsseln!**

Danach können Sie den Zugriffsgrant kopieren und dann den Start des transfer.sh-Endpunkts beginnen.
Es wird empfohlen, sowohl den Zugriffsgrant als auch den Bucket-Namen als Umgebungsvariablen für erhöhte Sicherheit anzugeben.

Beispiel:```
export STORJ_BUCKET=<BUCKET NAME>
export STORJ_ACCESS=<ACCESS GRANT>
transfer.sh --provider storj

transfer() (if [ $# -eq 0 ]; then printf "Keine Argumente angegeben.\nVerwendung:\n transfer <datei|verzeichnis>\n ... | transfer <dateiname>\n">&2; return 1; fi; file_name=$(basename "$1"); if [ -t 0 ]; then file="$1"; if [ ! -e "$file" ]; then echo "$file: Datei oder Verzeichnis nicht gefunden">&2; return 1; fi; if [ -d "$file" ]; then cd "$file" || return 1; file_name="$file_name.zip"; set -- zip -r -q - .; else set -- cat "$file"; fi; else set -- cat; fi; url=$("$@" | curl --silent --show-error --progress-bar --upload-file "-" "https://transfer.sh/$file_name"); echo "$url"; )```

<br />

#### Now you can use transfer function