Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
4248ecffb8 | ||
|
|
759b3e1c02 | ||
|
|
57b2131632 |
No files matched your search
@@ -1,42 +1,3 @@
|
||||
# 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.
|
||||
# Ebenfalls nur bei ausdrücklichem X-Forwarded-Proto "http", auf genau diesen drei Hostnamen (lara-und-felix.de,
|
||||
# www.lara-und-felix.de, www.laraundfelix.de): alle anderen Methoden (POST, PUT, DELETE, ...) enden hier mit 403 und
|
||||
# erreichen Laravel nicht. Ein 301 wäre für sie falsch (der Client schickte den Inhalt erneut oder als GET), und über
|
||||
# unverschlüsseltes HTTP sollen keine Eingaben oder Zugangsdaten ankommen. Über HTTPS (zum Beispiel der Stripe-Webhook)
|
||||
# und ohne X-Forwarded-Proto (direkter Zugriff, Health-Check) ändert sich nichts.
|
||||
# Nie angefasst werden: die ACME-Prüfung unter /.well-known/acme-challenge/ (jede Methode), 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*(?<luf_fh>[^,\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 vor den Weiterleitungen (1), diese vor der Sperre für andere Methoden (2).
|
||||
# Die Sperre braucht deshalb keine Methodenliste: GET und HEAD sind in den Zeilen davor bereits entschieden.
|
||||
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;
|
||||
"~*^[^|]*\|\s*http\s*(,[^|]*)?\|(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de\.?\|" 2;
|
||||
}
|
||||
|
||||
server {
|
||||
listen 80;
|
||||
server_name _;
|
||||
@@ -48,14 +9,6 @@ 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 = 1) {
|
||||
return 301 https://lara-und-felix.de$request_uri;
|
||||
}
|
||||
if ($luf_canonical_redirect = 2) {
|
||||
return 403;
|
||||
}
|
||||
|
||||
client_max_body_size 2048m;
|
||||
client_body_timeout 3600s;
|
||||
send_timeout 3600s;
|
||||
|
||||
@@ -99,29 +99,6 @@ ## 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 |
|
||||
| Jede andere Methode (`POST`, `PUT`, `DELETE` …) auf den drei Shop-Hosts, nur bei `X-Forwarded-Proto: http` | `403` im Nginx, die Anfrage erreicht Laravel nicht |
|
||||
|
||||
- **Ö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:** Auf `lara-und-felix.de`, `www.lara-und-felix.de` und `www.laraundfelix.de` endet jede Methode außer `GET`/`HEAD` mit `403` im Nginx, **wenn** der Proxy ausdrücklich `X-Forwarded-Proto: http` setzt (erster Wert der Liste). Ein `301` wäre für sie falsch, und über unverschlüsseltes HTTP sollen keine Eingaben ankommen. Unverändert an die Anwendung gehen: alle Methoden über HTTPS (der Stripe-Webhook `/stripe/webhook` ist ein `POST` und muss als `https://` in Stripe eingetragen sein), alle Methoden ohne `X-Forwarded-Proto` (direkter Zugriff, Health-Check) und `dev.laraundfelix.de`. Im Repository ist keine Webhook-Adresse hinterlegt; welche Adresse im Stripe-Dashboard steht, ist [?] nicht geprüft. **Vor dem Aktivieren der HTTP-Regeln prüfen:** Steht dort `http://…`, würde der Webhook mit `403` abgewiesen und muss auf `https://` umgestellt werden.
|
||||
- **ACME:** `/.well-known/acme-challenge/` wird nie umgeleitet oder gesperrt, für jede Methode (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`
|
||||
|
||||
@@ -7,151 +7,16 @@
|
||||
/**
|
||||
* 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<string>
|
||||
*/
|
||||
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<string> 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 = $this->config();
|
||||
$config = (string) file_get_contents(dirname(__DIR__, 2).'/docker/nginx/default.conf');
|
||||
|
||||
$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 = 1) {', $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->assertSame(2, preg_match_all('/^\s*return\s+\d{3}\b/m', $config), 'Nur Weiterleitung und Sperre antworten selbst.');
|
||||
$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);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @return list<string> Zeilen der map, die andere Methoden sperren (Wert 2)
|
||||
*/
|
||||
private function blockRules(): array
|
||||
{
|
||||
return array_values(array_filter($this->redirectMap(), fn (string $line) => str_ends_with($line, '" 2;')));
|
||||
}
|
||||
|
||||
public function test_other_methods_on_the_three_shop_hosts_end_at_nginx_when_proxy_says_http(): void
|
||||
{
|
||||
$config = $this->config();
|
||||
$rules = $this->blockRules();
|
||||
|
||||
$this->assertCount(1, $rules);
|
||||
$rule = $rules[0];
|
||||
$this->assertStringStartsWith('"~*^[^|]*\|', $rule, 'Jede Methode, die nicht vorher als GET/HEAD entschieden wurde.');
|
||||
$this->assertStringContainsString('\|\s*http\s*(,[^|]*)?\|', $rule, 'Nur bei ausdrücklichem X-Forwarded-Proto http (erster Wert).');
|
||||
foreach (['www\.lara-und-felix', 'www\.laraundfelix', '(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de'] as $host) {
|
||||
$this->assertStringContainsString($host, $rule);
|
||||
}
|
||||
$this->assertStringNotContainsString('dev', $rule, 'dev.laraundfelix.de bleibt unverändert.');
|
||||
$this->assertStringNotContainsString('https', $rule);
|
||||
$this->assertMatchesRegularExpression('/^\s*if\s*\(\$luf_canonical_redirect = 2\)\s*\{\s*return\s+403;\s*\}/m', $config, 'Die Sperre antwortet in nginx, bevor die Anfrage Laravel erreicht.');
|
||||
$this->assertDoesNotMatchRegularExpression('/\$luf_canonical_redirect = 2\)\s*\{[^}]*(fastcgi_pass|proxy_pass)/', $config);
|
||||
}
|
||||
|
||||
public function test_block_rule_comes_after_acme_exception_and_the_redirects(): void
|
||||
{
|
||||
// nginx nimmt den ersten passenden Regex-Eintrag: Ausnahme, dann GET/HEAD-Weiterleitungen, zuletzt die Sperre.
|
||||
$values = array_map(fn (string $line) => rtrim(substr($line, (int) strrpos($line, ' ') + 1), ';'), $this->redirectMap());
|
||||
|
||||
$this->assertSame(['0', '0', '1', '1', '1', '2'], $values, 'Reihenfolge: default, ACME, drei Weiterleitungen, Sperre.');
|
||||
}
|
||||
|
||||
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;') || str_ends_with($line, '" 2;'))) {
|
||||
$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).');
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user