Dateitransfer: Server, Seiten, Tests und Docker-Dateien
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>
This commit is contained in:
1 parent
51ff6f9d40
commit
278194b707
31 files changed
+5099
No files matched your search
@@ -1,2 +1,160 @@
|
||||
# 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](.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:
|
||||
|
||||
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.
|
||||
Reference in new issue
Block a user