diff --git a/docker/nginx/default.conf b/docker/nginx/default.conf index ff19498..5d19d34 100644 --- a/docker/nginx/default.conf +++ b/docker/nginx/default.conf @@ -1,3 +1,35 @@ +# Kanonische Adresse: https://lara-und-felix.de. Der Synology-Reverse-Proxy beendet HTTPS und spricht intern HTTP mit +# diesem Container. Das öffentliche Protokoll steht deshalb in X-Forwarded-Proto, der öffentliche Host in +# X-Forwarded-Host (falls die Synology ihn setzt) oder sonst im Host-Header. +# +# Weitergeleitet werden nur normale Seitenaufrufe (GET und HEAD): +# - www.lara-und-felix.de und www.laraundfelix.de (HTTP und HTTPS, Protokoll egal) -> https://lara-und-felix.de +# - http://lara-und-felix.de, aber nur wenn X-Forwarded-Proto ausdrücklich "http" lautet. Fehlt der Header +# (direkter Zugriff, Health-Check auf 127.0.0.1), wird nie weitergeleitet. Das verhindert Schleifen, falls ein +# HTTPS-Aufruf ohne den Header ankommt. +# Nicht weitergeleitet werden: alle anderen Methoden (POST, zum Beispiel der Stripe-Webhook), die ACME-Prüfung unter +# /.well-known/acme-challenge/, dev.laraundfelix.de und alles, was nicht in der Liste steht. +# Das Ziel ist fest; Pfad und Query-String bleiben über $request_uri erhalten. +map $http_x_forwarded_host $luf_forwarded_host { + default ""; + "~*^\s*(?[^,\s:]+)" $luf_fh; +} + +map $luf_forwarded_host $luf_public_host { + "" $host; + default $luf_forwarded_host; +} + +# Schlüssel: Methode|X-Forwarded-Proto|öffentlicher Host|Pfad. Die Einträge werden der Reihe nach geprüft, der erste +# Treffer gilt: die ACME-Ausnahme steht deshalb vor den Weiterleitungen. +map "$request_method|$http_x_forwarded_proto|$luf_public_host|$uri" $luf_canonical_redirect { + default 0; + "~*^[^|]*\|[^|]*\|[^|]*\|/\.well-known/acme-challenge/" 0; + "~*^(GET|HEAD)\|[^|]*\|www\.lara-und-felix\.de\.?\|" 1; + "~*^(GET|HEAD)\|[^|]*\|www\.laraundfelix\.de\.?\|" 1; + "~*^(GET|HEAD)\|\s*http\s*(,[^|]*)?\|lara-und-felix\.de\.?\|" 1; +} + server { listen 80; server_name _; @@ -9,6 +41,11 @@ server { # alte Adresse und antwortet mit 502 – etwa bei einem erneuten Deploy-Lauf nach einer Änderung der Env-Datei. resolver 127.0.0.11 valid=10s ipv6=off; + # Läuft vor der Auswahl der location (Rewrite-Phase des Servers), daher steckt die ACME-Ausnahme in der map oben. + if ($luf_canonical_redirect) { + return 301 https://lara-und-felix.de$request_uri; + } + client_max_body_size 2048m; client_body_timeout 3600s; send_timeout 3600s; diff --git a/docs/betrieb/DEPLOYMENT.md b/docs/betrieb/DEPLOYMENT.md index cbf79ab..bc2035c 100644 --- a/docs/betrieb/DEPLOYMENT.md +++ b/docs/betrieb/DEPLOYMENT.md @@ -99,6 +99,28 @@ ## Medien-Ablage auf dem NAS - Die CI-Tests mounten keine Medien (`Storage::fake()`). - Datensicherung: Originale sind laut `11_Betrieb_Sicherheit_Datenschutz.md` kritisch (NAS und außer Haus). Snapshots und Replikation für `luf_media` sind Sache des NAS und noch nicht eingerichtet. +## Kanonische Adresse und Weiterleitungen (Nginx im Shop-Container) + +Die Shop-Adresse ist `https://lara-und-felix.de`. Der Nginx des Containers (`docker/nginx/default.conf`) leitet normale Seitenaufrufe (`GET`, `HEAD`) mit `301` auf diese feste Adresse um, Pfad und Query-String bleiben erhalten. Die Entscheidung trifft eine `map` über Methode, `X-Forwarded-Proto`, öffentlichen Host und Pfad. + +| Aufruf (Methode `GET`/`HEAD`) | Verhalten | +|---|---| +| `http://lara-und-felix.de` (nur bei `X-Forwarded-Proto: http`) | `301` auf `https://lara-und-felix.de` | +| `http://` und `https://www.lara-und-felix.de` | `301` direkt auf `https://lara-und-felix.de` | +| `http://` und `https://www.laraundfelix.de` | `301` direkt auf `https://lara-und-felix.de` | +| `https://lara-und-felix.de` | Shop | +| `dev.laraundfelix.de` | Testinstanz, unverändert | +| `laraundfelix.de` ohne `www` | nicht betroffen, die STRATO-Weiterleitung übernimmt | + +- **Öffentlicher Host:** erster Wert von `X-Forwarded-Host`, sonst der `Host`-Header (ohne Port, Groß-/Kleinschreibung egal). Eine Adresse ohne Proxy (`127.0.0.1:3010`, `192.168.2.144:3011`) trifft keine Regel. +- **Öffentliches Protokoll:** nur `X-Forwarded-Proto`, nie das lokale Schema. Fehlt der Header, wird `lara-und-felix.de` **nicht** weitergeleitet. Dadurch gibt es keine Schleife, falls ein HTTPS-Aufruf ohne den Header ankäme, und der Health-Check des Deploys (`http://127.0.0.1:$WEB_PORT/up`) bleibt unberührt. Die `www`-Adressen werden unabhängig vom Protokoll weitergeleitet. +- **Andere Methoden:** `POST` und alle übrigen Methoden bekommen nie ein `301`, sondern gehen wie bisher an die Anwendung (Stripe-Webhook `/stripe/webhook` ist ein `POST`). Im Repository ist keine Webhook-Adresse hinterlegt; welche Adresse im Stripe-Dashboard steht, ist [?] nicht geprüft. Sie funktioniert in jedem Fall weiter, auch wenn sie auf einen Alias-Host zeigt. +- **ACME:** `/.well-known/acme-challenge/` wird nie umgeleitet (Ausnahme zuerst in der `map`), auch nicht auf den `www`-Hosts. Der Shop beantwortet diesen Pfad selbst nicht (Laravel liefert 404); das Zertifikat holt die Synology, sie muss die Prüfung also selbst beantworten und darf sie nicht an den Shop weiterreichen. [?] Beim ersten Erneuern beobachten. +- **Signierte URLs:** `App\Http\SignedLink` signiert nur den Pfad (relative Signatur), der Host fließt nicht ein. Ein Wechsel zwischen den Alias-Hosts macht Links also nicht ungültig. Im Repository kommt kein Alias-Host vor; Stripe-Rücksprungadressen entstehen aus `route()` und damit aus `APP_URL` bzw. dem Anfrage-Host. +- **Synology:** Setzt der Reverse-Proxy `X-Forwarded-Proto` nicht von selbst, dann einen eigenen Kopfzeilen-Eintrag `X-Forwarded-Proto` mit dem Wert `$scheme` anlegen. Für die Testinstanz ist belegt, dass Protokoll und Host der Synology in der Anwendung ankommen (Stand 2026-11-22: `https://dev.laraundfelix.de/verwaltung` leitet auf `https://dev.laraundfelix.de/verwaltung/login`). Für die Prod-Regeln ist das [?] nicht geprüft. +- **Prüfung:** Die Fälle der Tabelle, `HEAD`, Pfad mit Query, Großschreibung, Port im Host, `X-Forwarded-Host`, `POST`/`PUT`, direkter Zugriff und ACME wurden 2026-11-22 mit Windows-nginx 1.27.5 (nicht das Alpine-Image) und `php-cgi` als Upstream durchgespielt (30 Fälle). Reihenfolge und Zusagen der Konfiguration sichert `tests/Unit/NginxConfigTest.php`. +- **Nach dem Deploy auf Test** (Lars oder Claude, nur gegen `192.168.2.144:3011`, nie gegen Prod): `curl -sI -H 'Host: www.laraundfelix.de' -H 'X-Forwarded-Proto: https' 'http://192.168.2.144:3011/a?b=1'` muss `301` mit `Location: https://lara-und-felix.de/a?b=1` liefern. + ## Einmalig auf llm-node vorzubereiten (nicht automatisiert, braucht `sudo`) 1. `sudo mkdir -p /etc/luf && sudo chown llmadmin:llmadmin /etc/luf && sudo chmod 750 /etc/luf` diff --git a/tests/Unit/NginxConfigTest.php b/tests/Unit/NginxConfigTest.php index c5c6a06..a0ece8e 100644 --- a/tests/Unit/NginxConfigTest.php +++ b/tests/Unit/NginxConfigTest.php @@ -7,16 +7,116 @@ /** * Der Web-Container (nginx) muss den App-Container zur Laufzeit über Dockers DNS finden. Mit einer festen Adresse * beim Start antwortete Prod nach einem erneuten Deploy-Lauf mit 502 (App neu erzeugt, nginx nicht). + * + * Außerdem leitet er die Alias-Adressen auf https://lara-und-felix.de weiter. Das Verhalten wurde mit nginx selbst + * geprüft (Ergebnis in docs/betrieb/DEPLOYMENT.md). Diese Tests sichern die Zusagen der Konfiguration gegen + * versehentliche Änderungen, denn im CI-Container läuft kein nginx. */ class NginxConfigTest extends TestCase { + private function config(): string + { + return (string) file_get_contents(dirname(__DIR__, 2).'/docker/nginx/default.conf'); + } + + /** + * Zeilen der Weiterleitungs-map in der Reihenfolge der Datei (nginx wertet sie in dieser Reihenfolge aus). + * + * @return list + */ + private function redirectMap(): array + { + $found = preg_match('/^map\s+"[^"]*"\s+\$luf_canonical_redirect\s*\{(.*?)^\}/ms', $this->config(), $match); + $this->assertSame(1, $found, 'Die map $luf_canonical_redirect fehlt.'); + + return array_values(array_filter(array_map('trim', explode("\n", $match[1])))); + } + + /** + * @return list Zeilen der map, die weiterleiten (Wert 1) + */ + private function redirectRules(): array + { + return array_values(array_filter($this->redirectMap(), fn (string $line) => str_ends_with($line, '" 1;'))); + } + public function test_nginx_resolves_the_app_container_at_request_time(): void { - $config = (string) file_get_contents(dirname(__DIR__, 2).'/docker/nginx/default.conf'); + $config = $this->config(); $this->assertMatchesRegularExpression('/^\s*resolver\s+127\.0\.0\.11\b[^;]*valid=\d+s[^;]*;/m', $config); $this->assertMatchesRegularExpression('/^\s*set\s+\$php_upstream\s+app:9000;/m', $config); $this->assertMatchesRegularExpression('/^\s*fastcgi_pass\s+\$php_upstream;/m', $config); $this->assertDoesNotMatchRegularExpression('/^\s*fastcgi_pass\s+app:9000;/m', $config); } + + public function test_nginx_keeps_the_fastcgi_and_timeout_settings(): void + { + $config = $this->config(); + + $this->assertMatchesRegularExpression('/^\s*fastcgi_read_timeout\s+3600s;/m', $config); + $this->assertMatchesRegularExpression('/^\s*fastcgi_send_timeout\s+3600s;/m', $config); + $this->assertMatchesRegularExpression('/^\s*client_max_body_size\s+2048m;/m', $config); + $this->assertMatchesRegularExpression('/^\s*fastcgi_param\s+HTTP_X_FORWARDED_PROTO\s+\$forwarded_proto;/m', $config); + $this->assertStringContainsString('try_files $uri $uri/ /index.php?$query_string;', $config); + $this->assertStringContainsString('location ~ /\.(?!well-known) {', $config); + } + + public function test_alias_hosts_are_redirected_to_the_fixed_canonical_domain(): void + { + $config = $this->config(); + + $this->assertStringContainsString('if ($luf_canonical_redirect) {', $config); + $this->assertStringContainsString('return 301 https://lara-und-felix.de$request_uri;', $config, 'Fest verdrahtetes Ziel, Pfad und Query-String aus $request_uri.'); + $this->assertSame(1, preg_match_all('/^\s*return\s+30\d\s/m', $config), 'Es gibt genau eine Weiterleitung.'); + $this->assertDoesNotMatchRegularExpression('/return\s+30\d\s+[^;]*\$(host|http_host|http_x_forwarded_host|scheme)/', $config, 'Das Ziel darf nicht aus Anfragewerten entstehen.'); + } + + public function test_redirect_rules_cover_both_www_aliases_and_the_http_apex_only(): void + { + $rules = implode("\n", $this->redirectRules()); + + $this->assertCount(3, $this->redirectRules()); + $this->assertStringContainsString('www\.lara-und-felix\.de', $rules); + $this->assertStringContainsString('www\.laraundfelix\.de', $rules); + $this->assertStringContainsString('\|\s*http\s*(,[^|]*)?\|lara-und-felix\.de', $rules, 'Der Apex wird nur bei ausdrücklichem X-Forwarded-Proto http weitergeleitet.'); + $this->assertStringNotContainsString('dev.', $rules, 'dev.laraundfelix.de bleibt unverändert.'); + $this->assertStringNotContainsString('|laraundfelix', $rules, 'laraundfelix.de ohne www übernimmt die STRATO-Weiterleitung.'); + $this->assertStringContainsString('default 0;', implode("\n", $this->redirectMap())); + } + + public function test_only_get_and_head_are_redirected(): void + { + foreach ($this->redirectRules() as $rule) { + $this->assertStringContainsString('"~*^(GET|HEAD)\|', $rule, 'POST (zum Beispiel der Stripe-Webhook) darf kein 301 bekommen: '.$rule); + } + } + + public function test_acme_challenge_is_excluded_before_any_redirect_rule(): void + { + $acme = null; + $firstRedirect = null; + foreach ($this->redirectMap() as $index => $line) { + if ($acme === null && str_contains($line, '/\.well-known/acme-challenge/') && str_ends_with($line, '" 0;')) { + $acme = $index; + } + if ($firstRedirect === null && str_ends_with($line, '" 1;')) { + $firstRedirect = $index; + } + } + + $this->assertNotNull($acme, 'Die ACME-Ausnahme fehlt.'); + $this->assertNotNull($firstRedirect); + $this->assertLessThan($firstRedirect, $acme, 'nginx wertet map-Einträge der Reihe nach aus: die Ausnahme muss vorn stehen.'); + } + + public function test_redirect_decision_uses_forwarded_headers_and_never_the_local_scheme(): void + { + $config = $this->config(); + + $this->assertStringContainsString('map "$request_method|$http_x_forwarded_proto|$luf_public_host|$uri" $luf_canonical_redirect {', $config); + $this->assertStringContainsString('map $http_x_forwarded_host $luf_forwarded_host {', $config); + $this->assertMatchesRegularExpression('/^\s*""\s+\$host;/m', $config, 'Ohne X-Forwarded-Host gilt der Host-Header.'); + $this->assertStringNotContainsString('$scheme|', $config, 'Ohne X-Forwarded-Proto darf nie weitergeleitet werden (direkter Zugriff, Health-Check).'); + } }