fix: Bindeadresse war in der Vorlage stillschweigend vorbelegt

.env.example setzte APP_BIND=127.0.0.1 als fertigen Wert, mitten zwischen
lauter anderen fertigen Werten. Wer die Datei kopiert und seinen Reverse
Proxy auf einem anderen Server betreibt, kommt damit nicht an die
Anwendung heran - und der Fehler sieht aus, als laege es am Proxy.

Der sichere Standard bleibt 127.0.0.1. Er wird nur nicht mehr als
"schon erledigt" praesentiert, sondern als Entscheidung mit drei
benannten Faellen: Proxy daneben, Proxy woanders mit privatem Netz,
Proxy woanders ohne. Beim dritten Fall steht die Firewallregel dabei.

Die Installationsanleitung nennt APP_BIND jetzt schon in Schritt 3, wo
die .env ausgefuellt wird - nicht erst in Schritt 7, wo der Proxy
drankommt. Wer der Anleitung von oben nach unten folgt, stolpert sonst
erst vier Schritte spaeter darueber.

Dazu ein eigener Abschnitt in der Fehlersuche mit den zwei curl-Proben,
die den Unterschied zwischen falscher Bindeadresse und Firewall zeigen -
und dem Hinweis, dass dafuer kein Neubau noetig ist.

Am Programm aendert sich nichts.

Etappe: 8
Phase: Haertung
This commit is contained in:
Florian Wilde
2026-08-22 14:22:38 +02:00
parent 232543e2aa
commit 9365645f72
5 changed files with 102 additions and 10 deletions
+43
View File
@@ -205,6 +205,14 @@ S3_SECRET_ACCESS_KEY=<aus Schritt 2>
# --- Sicherung ---
SICHERUNG_PASSWORT=<aus Schritt 2>
# --- Erreichbarkeit ---
# Steht dein Proxy auf einem ANDEREN Server, muss hier die Adresse hinein,
# ueber die er diesen Server erreicht. Bleibt es bei 127.0.0.1, kommt er
# NICHT heran - und der Fehler sieht aus, als sei der Proxy schuld.
# Welcher Wert der richtige ist, steht in Schritt 7a.
APP_BIND=127.0.0.1
APP_PORT=3000
```
> **`AUTH_URL` muss exakt der Adresse entsprechen**, unter der du die
@@ -875,6 +883,41 @@ Fehlt eine Umgebungsvariable, sagt die Anwendung beim Start, welche.
Die `.env` liegt nicht neben der `docker-compose.yml`, oder die Zeile ist
leer. Prüf mit dem Befehl aus Schritt 3.
### Der Proxy erreicht die Anwendung nicht („502", „Connection refused")
Fast immer steht in der `.env` noch `APP_BIND=127.0.0.1`, während der
Proxy auf einem anderen Server läuft. Dann horcht die Anwendung nur auf
der Loopback-Adresse — erreichbar ausschließlich vom Anwendungsserver
selbst.
Prüf, worauf sie tatsächlich horcht:
```bash
docker compose ps
# unter PORTS muss die Adresse stehen, die der Proxy erreicht,
# NICHT 127.0.0.1
```
Und ob sie überhaupt antwortet — erst lokal, dann vom Proxy-Server aus:
```bash
# auf dem Anwendungsserver
curl -s http://127.0.0.1:3000/api/gesundheit
# auf dem Proxy-Server
curl -s http://<APP_BIND-Adresse>:3000/api/gesundheit
```
Antwortet der erste, aber nicht der zweite, ist `APP_BIND` falsch oder
eine Firewall dazwischen. Setz den richtigen Wert (Schritt 7a) und
```bash
docker compose up -d
```
Ein Neubau des Abbilds ist dafür **nicht** nötig — es ist nur eine
Umgebungsänderung, der Behälter wird neu erzeugt.
### Port 3000 ist schon belegt
```bash