D4rkst3randClaude Opus 5
44ad7dc6b3
UMBENENNEN gab es gar nicht -- verschieben ja, umbenennen nirgends. Jetzt fuer
Datei und Ordner. Die WARNUNG ist dabei der eigentliche Teil: beim Verschieben
wandert eine Datei, beim Umbenennen aendert sich IHRE ADRESSE, und die steht
womoeglich in einem Skript, das niemand mehr im Kopf hat. Der Dialog zeigt
deshalb die Abrufzahl und beim Ordner die Zahl der betroffenen Dateien, BEVOR
gedrueckt wird -- eine Datei mit viertausend Abrufen umzubenennen ist etwas
anderes als eine mit null, und der Dienst ist die einzige Stelle, die den
Unterschied kennt.
Am echten Fall geprueft, dem Kollisionsfund: items/coiloverss.png (hielt die
+-Fassung) -> items/coiloverss-plus.png, alte Adresse 404, neue 200 mit 4375 B,
Vorschau mitgewandert. Ordner: probe -> beispiele, 5 Dateien, alle Pfade in
einer Transaktion umgeschrieben.
Ein Fallstrick dabei: thumbPath haengt ".webp" an. Fuer eine Datei richtig, fuer
einen ORDNER Unsinn -- der Vorschauordner heisst thumbs/vehicles und nicht
thumbs/vehicles.webp. Dafuer gibt es jetzt moveFolder.
DIE 93 KOLLISIONEN SIND ERLEDIGT. tools/kollisionen.ps1 rechnet dieselbe
Zaehmung auf der Quelle nach und zeigt, was zusammenfaellt -- es aendert nichts,
damit die Entscheidung auf Zahlen steht. Ergebnis: 91 von 93 sind dieselbe Datei
zweimal (WEAPON_SMG.png und weapon_smg.png, byteweise gleich gross), da fehlte
nichts. Echt verloren waren ZWEI, beide mit + im Namen. Beide nachgeholt.
FIVEMANAGE-SPRACHE. POST /api/image|video|audio (v1) und POST /api/v3/file (v3),
Schluessel nackt im Authorization-Kopf. Auf einem laufenden Server stecken die
Fivemanage-Aufrufe in einem Dutzend fremder Ressourcen; sie alle umzuschreiben
tut niemand, und deshalb bliebe dieser Dienst ungenutzt daneben stehen. So ist
der Umzug eine Zeile je Skript: die Adresse.
Beide Formen sind AUS ECHTEM CODE abgelesen und nicht geraten -- fivemanage/sdk
fuer v3, Awleks/Devm-Camera fuer den aelteren Weg ueber screenshot-basic.
Gemessen: v1 -> {url,id,path}, v3 -> {status:"ok",data:{id,url}}, ohne
Schluessel 401, ein Video an /api/image -> 415 mit Grund.
Dabei bin ich in eine Falle gelaufen, vor der im eigenen Repo ein Kommentar
warnt: die Token-Wache hing an use('*'), und der Einhaengepunkt ist /api -- also
galt sie auch fuer /api/dash daneben. Das Dashboard bekam 401 auf die ANMELDUNG.
Wortwoertlich derselbe Fehler steht in upload.ts als Kommentar, weil er dort
schon einmal passiert ist. Gemerkt hat es der Gegentest, nicht der Kopf.
FREIGABE-LINKS. /s/<schluessel> zeigt einen Ordner ohne Anmeldung. Was dabei
ausdruecklich dabeisteht, in der Karte und in der Rueckfrage vor dem
Zurueckziehen: FREIGEGEBEN WIRD DIE LISTE, NICHT DER INHALT. Die Dateien sind
ohnehin oeffentlich; ein zurueckgezogener Link macht sie nicht wieder privat, er
nimmt nur die Uebersicht weg. Ohne diesen Satz zieht jemand einen Link zurueck
und glaubt, etwas sei verschwunden.
Die Antwort ist abgemessen: Name, Groesse, Art, Adresse, Laenge. NICHT Hash,
Token, Zeitpunkte, Abrufzahlen, IDs -- nichts davon braucht, wer einen Katalog
ansieht, und jedes davon waere eine Auskunft ueber den Betrieb. Ein unbekannter
Schluessel und ein zurueckgezogener geben dieselbe Antwort.
ZAHLEN, DIE SCHON DA WAREN. Sortieren nach Abrufen und nach "zuletzt geholt";
die Kachel zeigt dann auch diese Zahl statt Groesse und Datum, denn nach etwas
zu ordnen, das man nirgends sieht, ist eine Reihenfolge ohne Begruendung. Und je
Token, was damit abgelegt wurde: media.token_id wird seit dem ersten Tag
geschrieben und war NIRGENDS zu sehen. Gemessen: d4rk_photostudio haelt 810
Dateien / 99,5 MB, 3640 liegen ohne Token da.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
241 lines
9.5 KiB
Markdown
241 lines
9.5 KiB
Markdown
# d4rk_media
|
|
|
|
Eigener Medien-Dienst für alle FiveM-Ressourcen: Dateien annehmen, ablegen,
|
|
ausliefern, in einem Dashboard verwalten. **Ein Container**, SQLite, Dateien auf
|
|
einer Platte.
|
|
|
|
Läuft unter **https://fivemanage.d4rkst3r.de** — Dashboard und API an der
|
|
Wurzel, Dateien unter `/f/`.
|
|
|
|
```
|
|
vehicles/adder.webp → https://fivemanage.d4rkst3r.de/f/vehicles/adder.webp
|
|
```
|
|
|
|
**Der Pfad ist der Schlüssel.** `vehicles/adder.webp` bleibt
|
|
`vehicles/adder.webp`, damit die Vorlage in einem Skript schlicht
|
|
`{model}.webp` lauten kann. Die Adressen stehen nirgends in der Datenbank — sie
|
|
werden bei jeder Antwort aus `PUBLIC_URL` gebaut. Ein Umzug auf einen anderen
|
|
Namen ist eine geänderte Variable, kein Datenbankeingriff.
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Anleitung für Skripte** | [Wiki](https://git.d4rkst3r.de/D4rkst3r/d4rk_media/wiki) — Quelle ist `docs/` |
|
|
| **Stand und Reihenfolge** | `ROADMAP.md` |
|
|
| **Arbeitsweise** | `CLAUDE.md` — prüfen statt raten |
|
|
|
|
---
|
|
|
|
## Starten
|
|
|
|
```bash
|
|
cp .env.example .env # PUBLIC_URL und ADMIN_PASSWORD ausfüllen
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Das war es. Ein Container, ein Volume, kein zweiter Dienst.
|
|
|
|
**In Portainer:** Stacks → Add stack → Repository, `Compose path:
|
|
docker-compose.yml`. Die Werte kommen als Stack-Variablen.
|
|
|
|
> **`Compose path` nimmt genau EINE Datei.** Ergänzungen werden stillschweigend
|
|
> übergangen — alle Container gesund, alles 502. Das hat beim Vorgänger einen
|
|
> Nachmittag gekostet.
|
|
|
|
### An der Oberfläche arbeiten
|
|
|
|
```bash
|
|
npm --prefix server/ui install
|
|
npm --prefix server/ui run dev
|
|
```
|
|
|
|
Läuft auf `localhost:5173` und leitet `/api` und `/f` an den Container weiter.
|
|
Dass das Sitzungs-Cookie dabei ankommt, liegt an einer Ausnahme: es trägt
|
|
`Secure`, und ein Browser nimmt so eines über `http` **nur auf localhost** an.
|
|
|
|
---
|
|
|
|
## Was der Dienst kann
|
|
|
|
**Hochladen** — über die Skript-API mit Token (drei Rumpfformen: multipart,
|
|
Base64, rohe Bytes) oder aus dem Dashboard per Ziehen und Ablegen. Bilder,
|
|
Videos, Ton, PDF. Ein **ZIP wird ausgepackt** statt abgelegt, und die Ordner
|
|
darin bleiben erhalten — 3670 Bilder einzeln ins Fenster zu ziehen ist keine
|
|
Bedienung.
|
|
|
|
**Ausliefern** — mit ETag, `304`, Bereichsanfragen und `nosniff`. Vorschaubilder
|
|
werden beim Upload erzeugt (320 px WebP): aus 7,5 MB je Galerieseite werden
|
|
766 KB. Bei **Video** ist es ein Standbild aus dem Clip (ein Zehntel hinein, weil
|
|
viele mit Schwarz beginnen), bei **Ton** das eingebettete Titelbild; die Kachel
|
|
trägt zusätzlich die Laufzeit.
|
|
|
|
**Sparen, ohne Adressen zu ändern** — neben jedem PNG und JPEG liegt eine
|
|
WebP-Fassung, ausgeliefert unter *derselben* Adresse je nach `Accept` des
|
|
Aufrufers. Nachgemessen über den ganzen Bestand: **199 MB → 33 MB**, das sind
|
|
83 %. Für Lua ändert sich nichts — es schickt kein `Accept: image/webp` und
|
|
bekommt weiterhin das Original.
|
|
|
|
**Zurückholen** — Gelöschtes liegt 30 Tage im Papierkorb, danach räumt der
|
|
Dienst selbst auf. Die Datei ist dann nur nicht mehr öffentlich, nicht weg.
|
|
|
|
**Zählen** — wie oft eine Datei geholt wurde und wann zuletzt. Beantwortet die
|
|
Frage, die ein Aufbewahrungsbericht sonst nicht beantworten kann: *braucht das
|
|
noch jemand?*
|
|
|
|
**Verwalten** — Galerie mit Ordnerbaum, Suche, Filter nach Medienart,
|
|
Sortierung, Mehrfachauswahl, Verschieben, Löschen.
|
|
|
|
**Ansehen ohne neuen Tab** — Bild, Video, Ton, PDF und alles Lesbare:
|
|
Markdown wird gesetzt, `.lua` und `.json` eingefärbt, CSV als Tabelle,
|
|
alles andere mit Zeilennummern. Video und Ton mit gemerkter Lautstärke und
|
|
„weiter zum nächsten Stück"; Leertaste hält an, die Pfeile springen fünf
|
|
Sekunden, mit Umschalt wechseln sie die Datei.
|
|
|
|
Markdown wird **ohne Bibliothek** dargestellt, und das ist kein Geiz: der
|
|
übliche Weg endet bei `dangerouslySetInnerHTML`, und die Sicherheit hängt dann
|
|
an einer Filterliste. Hier entsteht nie eine HTML-Zeichenkette — der Text wird
|
|
zu React-Knoten, ein `<script>` in einer hochgeladenen `.md` erscheint als die
|
|
acht Zeichen, die es ist.
|
|
|
|
**Umbenennen** — Datei und Ordner, mit der Warnung, die dazugehört: die Adresse
|
|
ändert sich, und der Dialog sagt vorher, wie oft die Datei geholt wurde bzw.
|
|
wie viele Dateien im Ordner betroffen sind.
|
|
|
|
**Nachvollziehen** — ein Verlauf: wer hat wann was abgelegt, ersetzt,
|
|
verschoben oder gelöscht. Dazu: nach Abrufen sortieren, und je Token sehen, was
|
|
damit abgelegt wurde.
|
|
|
|
**Umziehen von Fivemanage** — der Dienst spricht deren Sprache
|
|
(`/api/image`, `/api/video`, `/api/audio`, `/api/v3/file`, Schlüssel nackt im
|
|
`Authorization`-Kopf). Fremde Skripte ziehen um, indem eine Zeile getauscht
|
|
wird. Siehe `docs/API.md`.
|
|
|
|
**Freigeben** — `/s/<schlüssel>` zeigt einen Ordner ohne Anmeldung, etwa einen
|
|
Fahrzeugkatalog. Freigegeben wird die **Liste**, nicht der Inhalt: die Dateien
|
|
sind ohnehin öffentlich, ein zurückgezogener Link nimmt nur die Übersicht weg.
|
|
|
|
**Anmelden** — über Discord (eine Rolle auf dem Server genügt) oder mit
|
|
Passwort. Das Passwort bleibt als Notausgang.
|
|
|
|
**Sichern** — täglich, geprüft, in die Nextcloud. Und der Dienst meldet nach
|
|
Discord, wenn die Sicherung ausbleibt.
|
|
|
|
---
|
|
|
|
## Die eine Regel
|
|
|
|
**Jeder Knopf gibt Rückmeldung, auch der erfolgreiche.**
|
|
|
|
Das ist der Fehler, an dem der Fivemanage-Anlauf gescheitert ist: dessen
|
|
`http-util.ts` warf jeden Fehlschlag als `new Error(…)`, die Hooks prüften auf
|
|
`instanceof ApiError` — und damit verschwand **jeder** Fehler lautlos. `Create
|
|
organization` gab weder Erfolg noch Misserfolg zurück; das Ergebnis waren
|
|
neunzehn gleichnamige Organisationen.
|
|
|
|
Deshalb hier:
|
|
|
|
- In `server/ui/src/api.ts` steht der **einzige** `fetch` und **genau eine**
|
|
Fehlerklasse.
|
|
- In `store.ts` steht `run()`: Aktion rein, Erfolgstext rein — es meldet bei
|
|
Erfolg diesen und bei Fehlschlag den Text **des Dienstes**. Wer darüber geht,
|
|
kann keinen stillen Knopf bauen.
|
|
- Jeder wartende Knopf ist gesperrt und zeigt einen Kreisel.
|
|
- Fehlermeldungen bleiben stehen, bis jemand sie wegklickt.
|
|
- Der Dienst hat eine Auffanglinie (`app.onError`): auch ein unerwarteter
|
|
Fehler bekommt einen Satz statt eines nackten `Internal Server Error`.
|
|
|
|
---
|
|
|
|
## Betrieb
|
|
|
|
### Sicherung
|
|
|
|
`tools/sichern.ps1`, täglich 04:30 als geplante Aufgabe.
|
|
|
|
Die Datenbank wird **nicht kopiert**, sondern über SQLites eigene
|
|
Sicherungsschnittstelle herausgeholt — im WAL-Modus liegt das Zuletzte noch
|
|
nicht in `media.db`. Die Bilder kommen aus einem **nur lesend** eingehängten
|
|
Volume dazu, alles in ein `tar.gz`.
|
|
|
|
**Und sie prüft sich selbst:** auspacken, Datenbank öffnen, Medien, Token und
|
|
Benutzer zählen, mit dem laufenden Dienst vergleichen. Danach geht sie per
|
|
WebDAV in die Nextcloud und wird **von dort zurückgeholt und die Prüfsumme
|
|
verglichen** — ein `PUT`, der 201 sagt, hat nichts bewiesen.
|
|
|
|
Zugangsdaten und Aufbewahrung stehen im Panel unter *Einstellungen*.
|
|
|
|
### Wiki
|
|
|
|
```bash
|
|
pwsh -File tools\wiki.ps1
|
|
```
|
|
|
|
Trägt `docs/*.md` ins Gitea-Wiki. **Einseitig** — `docs/` ist die Quelle, das
|
|
Wiki die Kopie. Wer dort tippt, verliert es beim nächsten Lauf.
|
|
|
|
### Zurückspielen
|
|
|
|
```bash
|
|
tar xzf d4rk_media-JJJJ-MM-TT-HHMM.tar.gz
|
|
```
|
|
|
|
Ergibt `media.db` und `files/`. Beides ins Volume legen, während der Container
|
|
steht. Vorschaubilder und WebP-Fassungen sind **nicht** im Archiv — beides ist
|
|
abgeleitet und wird mit zwei Knöpfen unter *Speicher → Wartung* neu gerechnet.
|
|
Der Papierkorb ist ebenfalls nicht drin: was dort liegt, ist gelöscht.
|
|
|
|
---
|
|
|
|
## Was hier bewusst fehlt
|
|
|
|
**Logging.** Genau dafür schleppt Fivemanage ClickHouse mit, und genau da ist
|
|
der Wartungsaufwand echt. Der Verlauf im Dashboard beantwortet „wer war das" —
|
|
mehr braucht es hier nicht.
|
|
|
|
**Mandanten, Rollen, Teams.** Ein Dienst, den eine Person betreibt.
|
|
|
|
**Automatisches Löschen.** Vorbereitet ist der Bericht davor: wie viel ist
|
|
älter als 7/30/90/365 Tage, was liegt doppelt. Eine Regel zu bauen, bevor man
|
|
weiß, was da liegt, ist der Weg, wie man Daten verliert.
|
|
|
|
**Spielerportal.** Setzt voraus, dass Spieler hochladen. Der richtige Weg wäre
|
|
dann `presigned URLs` — kurzlebige signierte Adressen, mit denen ein Client
|
|
hochlädt, ohne je einen Token zu sehen.
|
|
|
|
---
|
|
|
|
## Zwei Dinge, die Zeit gekostet haben
|
|
|
|
**Der Proxy hielt Bilder fest.** NPMs `assets.conf` greift über eine Regex auf
|
|
*jede* URL, die auf `.webp`, `.png`, `.js`, `.css` endet, legt die Antwort 30
|
|
Minuten weg und ignoriert dabei unsere Kopfzeilen. Ein überschriebenes Bild
|
|
blieb damit eine halbe Stunde alt — und `/api/exists/…webp` wurde
|
|
zwischengespeichert und danach **auch ohne Token** ausgeliefert.
|
|
|
|
Behoben mit drei Blöcken in der *Custom Nginx Configuration* des Proxy-Hosts:
|
|
|
|
```nginx
|
|
location ^~ /api/ { proxy_cache off; include conf.d/include/proxy.conf; }
|
|
location ^~ /f/ { proxy_cache off; include conf.d/include/proxy.conf; }
|
|
location ^~ /t/ { proxy_cache off; include conf.d/include/proxy.conf; }
|
|
```
|
|
|
|
Das `^~` ist der ganze Trick: eine gewöhnliche Präfix-Regel **verliert** gegen
|
|
die Regex. In einem Wegwerf-Nginx nachgemessen.
|
|
|
|
**Node 22 ist festgenagelt.** `better-sqlite3` 11.10.0 liefert fertige
|
|
Binärdateien für ABI 115 (Node 20) und 127 (Node 22) — **Node 24 hat ABI 137
|
|
und fehlt**. Der Griff zur neuesten Version fällt auf `node-gyp` zurück und
|
|
braucht python3, make und g++ im Abbild.
|
|
|
|
---
|
|
|
|
## Herkunft
|
|
|
|
Der Vorgänger war **Fivemanage Lite** mit PostgreSQL, MinIO und ClickHouse. Der
|
|
Stack lief; woran er gescheitert ist, steht oben unter *Die eine Regel* und
|
|
ausführlich in `ROADMAP.md`. Von dem, was er über eine Dateiablage hinaus kann,
|
|
haben wir nichts gebraucht und alles mitgeschleppt.
|
|
|
|
Seine Compose-Dateien liegen in `legacy/`, als Beleg und wegen der Kommentare —
|
|
nichts davon wird noch gestartet.
|