Files
DerSchandfleckandClaude Fable 5.2 90500811df Vorgaben: 20 GB je Transfer, Frist 1 Tag
Bei nur einer Frist entfällt das Auswahlfeld; die Frist steht dann im
Hinweis unter der Dateiauswahl. Ohne DEFAULT_EXPIRY_DAYS ist die
kürzeste Frist vorausgewählt.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-16 01:32:07 +01:00

6.8 KiB
Raw Permalink Blame History

FileTransfer

Kleiner, privater Dateitransfer: Dateien hochladen, einen kurzen Link bekommen, weitergeben – wer den Link kennt, kann die Dateien herunterladen. Nach Ablauf der Frist löscht der Server sie von selbst.

  • Hochladen nur mit Upload-Code, Herunterladen ohne Anmeldung über den Link
  • Mehrere Dateien je Link; nach einem Tag werden sie gelöscht (Frist einstellbar, auf Wunsch mehrere zur Auswahl)
  • Große Dateien werden in Stücken übertragen; reißt die Verbindung ab, macht der Browser an derselben Stelle weiter
  • Oberfläche auf Deutsch und Englisch, hell oder dunkel je nach Gerät
  • Keine Cookies, keine Analyse, nichts von fremden Servern
  • Node.js ohne zusätzliche Pakete – es gibt nichts zu installieren und nichts zu bauen

Lokal ausprobieren

Voraussetzung: Node.js ab Version 22.

cp .env.example .env

In der .env bei UPLOAD_CODES einen Code eintragen, dann:

npm start

Die Seite läuft danach unter http://localhost:8083. Mit npm run dev startet der Dienst bei Änderungen am Code neu und liest Seiten und Skripte bei jedem Aufruf frisch von der Platte.

Einstellungen

Alle Einstellungen sind Umgebungsvariablen; liegt neben server.js eine Datei .env, wird sie gelesen. Die vollständige Liste mit Erklärungen steht in .env.example. Die wichtigsten:

Variable Vorgabe Bedeutung
UPLOAD_CODES leer name:code, mehrere durch Komma getrennt. Leer = Hochladen gesperrt
MAX_TRANSFER_SIZE 20GB größte Gesamtgröße eines Transfers
STORAGE_QUOTA 50GB so viel dürfen alle Transfers zusammen belegen
MIN_FREE_SPACE 5GB so viel muss auf der Platte frei bleiben
EXPIRY_DAYS 1 Frist in Tagen; mehrere Werte (1,7,30) lassen die Wahl
SITE_NAME shiuuji.de Name oben links auf der Seite
TRUST_PROXY 0 1, wenn ein Reverse-Proxy davorsteht

Einen Upload-Code nimmst du zurück, indem du ihn aus UPLOAD_CODES löschst und den Dienst neu startest. Bereits hochgeladene Dateien bleiben bis zu ihrer Frist.

Betrieb auf dem Server (Docker)

Der Dienst läuft als Container und ist nur auf dem Server selbst unter 127.0.0.1:8083 erreichbar. Nach außen gehört ein Reverse-Proxy mit HTTPS davor (zum Beispiel Caddy), der Anfragen an diesen Port weiterreicht.

Einmalig einrichten, im Ordner des Repositorys:

  1. Eigenen Benutzer für den Dienst anlegen und den Datenordner erstellen:

    sudo useradd --system --no-create-home --shell /usr/sbin/nologin filetransfer
    sudo install -d -o filetransfer -g filetransfer -m 700 data
    
  2. .env aus der Vorlage erstellen und nur für root lesbar machen:

    sudo cp .env.example .env
    sudo chmod 600 .env
    
  3. In der .env die Upload-Codes eintragen und am Ende zwei Zeilen mit den Nummern des neuen Benutzers ergänzen (Ausgabe von id filetransfer):

    APP_UID=<uid>
    APP_GID=<gid>
    
  4. Starten:

    sudo docker compose up -d --build
    

Später:

Zweck Befehl
Status sudo docker compose ps
Protokoll sudo docker compose logs --tail 50
Neue Version einspielen sudo git pull && sudo docker compose up -d --build
Node.js im Image aktualisieren sudo docker compose build --pull && sudo docker compose up -d
Transfers auflisten sudo docker compose exec filetransfer node tools/transfers.js list
Einen Transfer löschen sudo docker compose exec filetransfer node tools/transfers.js delete <kennung>

Die Kennung sind die zehn Zeichen hinter /d/ im Link. Im Protokoll steht zu jedem Transfer, mit welchem Upload-Code (Name) er angelegt wurde.

Hinweise für den Reverse-Proxy: Anfragen dürfen nicht zwischengespeichert (gepuffert) werden und müssen Körper bis 8 MB durchlassen – so groß ist ein Stück beim Hochladen. Caddy macht beides von Haus aus richtig.

Wie es funktioniert

server.js          Start: Einstellungen lesen, Dienst hochfahren
src/config.js      Einstellungen aus Umgebungsvariablen
src/app.js         HTTP-Server, Routen, Schutz-Header
src/store.js       Ablage der Transfers auf der Platte, Aufräumen
src/limiter.js     Zugriffsbegrenzung je Adresse
src/pages.js       lädt pages/ und public/ in den Arbeitsspeicher
pages/             HTML-Seiten (beide Sprachen stehen im selben Dokument)
public/            Gestaltung und Skripte für den Browser
tools/transfers.js Auflisten und Löschen von der Kommandozeile
test/              automatische Tests (npm test)

Ein Transfer liegt unter data/transfers/<kennung>/: die Dateien nach Position benannt (0, 1, …) und daneben meta.json mit Namen, Größen und Frist. Die Dateinamen der Nutzer werden nie als Pfad verwendet.

Ablauf eines Uploads:

  1. POST /api/transfers mit Upload-Code und Dateiliste legt den Transfer an und liefert ein Upload-Token und ein Lösch-Token.
  2. PUT /api/transfers/<kennung>/files/<nr>?offset=<n> überträgt die Dateien in Stücken von 8 MB. Der Server nimmt ein Stück nur an, wenn es genau an das bisher Empfangene anschließt; deshalb lässt sich jedes Stück gefahrlos wiederholen.
  3. POST /api/transfers/<kennung>/finish schließt ab. Erst jetzt ist der Link gültig und die Frist beginnt.

Das Lösch-Token merkt sich der Browser, damit man eigene Transfers auf der Startseite unter „Zuletzt hochgeladen“ vorzeitig löschen kann.

Sicherheit

  • Upload-Codes werden zeitunabhängig verglichen; nach 10 falschen Versuchen ist eine Adresse für 10 Minuten gesperrt. Auch das Durchprobieren von Links wird gebremst.
  • Kennungen sind 10 zufällige Zeichen (rund 8 × 10¹⁴ Möglichkeiten). Wer den Link hat, hat Zugriff – Links also nur an die richtigen Leute geben.
  • Hochgeladene Dateien werden ausschließlich als Download ausgeliefert (Content-Disposition: attachment, nosniff, eigene Content-Security-Policy), nie als Seite im Browser ausgeführt.
  • Die Dateien liegen unverschlüsselt auf dem Server. Wer Zugriff auf den Server hat, kann sie lesen.
  • Im Protokoll stehen keine IP-Adressen und keine Dateinamen.

Tests

npm test

Die Tests starten den Dienst mit einem eigenen, leeren Datenordner im Temp-Verzeichnis und räumen ihn danach wieder weg.