# 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](.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= APP_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 ` | 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//`: 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//files/?offset=` ü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//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.