fix: sechs Befunde aus dem ersten Start des Servers

Das Grundgeruest war typgeprueft, aber nie gelaufen. Beim ersten Start
haben sich sechs Dinge gezeigt, alle nachgemessen statt vermutet:

1. Die Token-Pruefung hing an '*' und galt damit auch fuer /api/dash/*,
   das daneben liegt. Das Dashboard bekam "Token fehlt oder ist
   unbekannt" auf die Anmeldung, obwohl es nie einen Token haben kann.
   Sie haengt jetzt an den drei eigenen Pfaden.

2. DELETE /api/media/... und GET /api/exists/... sahen am Ziel vorbei.
   c.req.path traegt den Einhaengepunkt mit, das replace(/^\/media\//)
   schnitt ihn nicht weg -- aus vehicles/adder.png wurde
   api/media/vehicles/adder.png. Loeschen fand nie etwas, exists meldete
   immer false. Jetzt :pfad{.+}; Hono liefert den Parameter fertig
   dekodiert (an einer Probe gemessen), ein zweites decodeURIComponent
   waere eine Dekodierung zu viel.

3. Verzeichnisdurchstieg in der SPA-Rueckfallroute: GET /..%5Cpackage.json
   hat unter Windows die Datei ausgeliefert. Hono reicht %5C durch,
   path.join behandelt den Backslash dort als Trenner, und eine
   Eindaemmung gab es nicht. Unter Linux traegt genau dieser Angriff
   nicht -- Glueck, keine Abwehr. Jetzt dieselbe resolve-Pruefung wie in
   storage.ts.

4. Die Auskunft "Oberflaeche ist nicht gebaut" war unerreichbar.
   createReadStream meldet eine fehlende Datei asynchron, das try/catch
   darum fing nichts. Ergebnis war ein leerer 200 samt ENOENT im Log.

5. CSS und JS kamen als application/octet-stream -- die MIME-Tabelle
   kennt nur Medientypen, das Dashboard haette weder Stylesheet noch
   Modul geladen. Die Oberflaeche bekommt eine eigene Tabelle: in der
   geteilten fehlt html mit Absicht, sonst koennte jeder mit einem
   Upload-Token eine Seite unter fivecdn.d4rkst3r.de veroeffentlichen.

6. Kaputtes JSON endete als nackter "Internal Server Error".
   Ausgerechnet das -- ein 500 ohne ein Wort dazu ist der Fehler, wegen
   dem wir hier neu bauen. Jetzt 400 mit Text.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-11 15:39:33 +02:00
co-authored by Claude Opus 5
parent e36db8c015
commit cfd0f0747a
3 changed files with 138 additions and 42 deletions
+86 -23
View File
@@ -18,7 +18,7 @@
import { createReadStream } from 'node:fs'
import { stat } from 'node:fs/promises'
import { fileURLToPath } from 'node:url'
import { join } from 'node:path'
import { join, resolve, sep } from 'node:path'
import { serve } from '@hono/node-server'
import { Hono } from 'hono'
import { logger } from 'hono/logger'
@@ -120,38 +120,101 @@ app.get('/f/*', (c) => serveFile(c, c.req.path.slice(3)))
// index.html — sonst endet ein Neuladen auf /tokens im 404 statt im Router.
// fileURLToPath und nicht .pathname: unter Windows liefert letzteres
// "/C:/..." und jedes stat() darauf schlaegt fehl.
const webDir = fileURLToPath(new URL('../web/', import.meta.url))
const webDir = resolve(fileURLToPath(new URL('../web/', import.meta.url)))
/** Der absolute Pfad zu einer Datei der Oberflaeche — oder null, wenn er aus
* dem Ordner herauszeigt.
*
* Dieselbe Guertel-und-Hosentraeger-Regel wie in storage.ts, und aus demselben
* Grund: der Pfad kommt vom Aufrufer. Ohne die Pruefung hat
* `GET /..%5Cpackage.json` unter Windows die Datei ausgeliefert — Hono reicht
* %5C unveraendert durch, und path.join behandelt den Backslash dort als
* Trenner. Unter Linux traegt derselbe Angriff nicht, aber das ist Glueck und
* keine Abwehr. */
function webFile(candidate: string): string | null {
const target = resolve(webDir, decodeSafely(candidate).replace(/^[/\\]+/, ''))
if (target !== webDir && !target.startsWith(webDir + sep)) return null
return target
}
/** %5C und Konsorten aufloesen, bevor geprueft wird — sonst prueft die
* Eindaemmung eine andere Zeichenkette als die, die spaeter im Dateisystem
* landet. Ein kaputtes Prozentzeichen ist kein Grund abzustuerzen. */
function decodeSafely(raw: string): string {
try {
return decodeURIComponent(raw)
} catch {
return raw
}
}
/** Die Dateitypen der Oberflaeche — bewusst eine EIGENE Tabelle und nicht die
* aus storage.ts.
*
* Dort fehlen html, css und js mit gutem Grund: eine hochgeladene .html wird
* unter dem Dateihost als application/octet-stream ausgeliefert und damit
* heruntergeladen statt ausgefuehrt. Stuende html in der geteilten Tabelle,
* koennte jeder mit einem Upload-Token eine Seite unter fivecdn.d4rkst3r.de
* veroeffentlichen. Die gebaute Oberflaeche liegt dagegen im Abbild und kommt
* von uns — hier ist der richtige Typ noetig, sonst laedt der Browser weder
* Stylesheet noch Modul. */
const WEB_MIME: Record<string, string> = {
html: 'text/html; charset=utf-8',
css: 'text/css; charset=utf-8',
js: 'text/javascript; charset=utf-8',
mjs: 'text/javascript; charset=utf-8',
map: 'application/json; charset=utf-8',
ico: 'image/x-icon',
woff: 'font/woff',
woff2: 'font/woff2',
ttf: 'font/ttf',
}
const webMimeFor = (path: string) =>
WEB_MIME[path.split('.').pop()?.toLowerCase() ?? ''] ?? mimeFor(path)
app.get('*', async (c) => {
if (c.req.path.startsWith('/api/')) return c.json({ error: 'unbekannt' }, 404)
const candidate = c.req.path === '/' ? '/index.html' : c.req.path
const target = webFile(candidate)
if (target) {
try {
const info = await stat(target)
if (info.isFile()) {
return c.body(createReadStream(target) as any, 200, {
'Content-Type': webMimeFor(candidate),
'Cache-Control': candidate.includes('/assets/')
? 'public, max-age=31536000, immutable'
: 'no-cache',
})
}
} catch {
/* faellt unten auf index.html */
}
}
// Erst nachsehen, dann streamen. createReadStream meldet eine fehlende
// Datei ASYNCHRON ueber ein 'error'-Ereignis — ein try/catch darum faengt
// nichts. Vorher stand hier genau das, und das Ergebnis war bei ungebauter
// Oberflaeche ein leerer 200 samt ENOENT im Log statt der Auskunft unten.
const index = join(webDir, 'index.html')
try {
const target = join(webDir, candidate.replace(/^\//, ''))
const info = await stat(target)
if (info.isFile()) {
return c.body(createReadStream(target) as any, 200, {
'Content-Type': mimeFor(candidate),
'Cache-Control': candidate.includes('/assets/')
? 'public, max-age=31536000, immutable'
: 'no-cache',
if ((await stat(index)).isFile()) {
return c.body(createReadStream(index) as any, 200, {
'Content-Type': 'text/html; charset=utf-8',
'Cache-Control': 'no-cache',
})
}
} catch {
/* faellt unten auf index.html */
/* faellt auf die Auskunft unten */
}
try {
return c.body(createReadStream(join(webDir, 'index.html')) as any, 200, {
'Content-Type': 'text/html; charset=utf-8',
'Cache-Control': 'no-cache',
})
} catch {
return c.text(
'Die Oberflaeche ist nicht gebaut. Der Dienst laeuft trotzdem — ' +
'die API steht unter /api.',
200,
)
}
return c.text(
'Die Oberflaeche ist nicht gebaut. Der Dienst laeuft trotzdem — ' +
'die API steht unter /api.',
200,
)
})
// --------------------------------------------------------------------- Start