Hochladen mit Upload-Code, kurzer Link zum Herunterladen, automatische Löschung nach Ablauf der Frist. Node.js ohne zusätzliche Pakete. - src/: HTTP-Server, Ablage auf der Platte, Zugriffsbegrenzung - pages/, public/: Oberfläche in Deutsch und Englisch - tools/: Transfers auflisten und löschen - test/: 34 automatische Tests - Dockerfile, compose.yaml: Betrieb als Container auf 127.0.0.1:8083 Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
6.7 KiB
FileTransfer
Kleiner, privater Dateitransfer: Dateien hochladen, einen kurzen Link bekommen, weitergeben – wer den Link kennt, kann die Dateien herunterladen. Nach Ablauf der gewählten Frist löscht der Server sie von selbst.
- Hochladen nur mit Upload-Code, Herunterladen ohne Anmeldung über den Link
- Mehrere Dateien je Link, Frist wählbar (Vorgabe: 1, 7 oder 30 Tage)
- 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 |
5GB |
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,7,30 |
wählbare Fristen in Tagen |
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:
-
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 -
.envaus der Vorlage erstellen und nur für root lesbar machen:sudo cp .env.example .env sudo chmod 600 .env -
In der
.envdie Upload-Codes eintragen und am Ende zwei Zeilen mit den Nummern des neuen Benutzers ergänzen (Ausgabe vonid filetransfer):APP_UID=<uid> APP_GID=<gid> -
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:
POST /api/transfersmit Upload-Code und Dateiliste legt den Transfer an und liefert ein Upload-Token und ein Lösch-Token.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.POST /api/transfers/<kennung>/finishschließ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.