Nginx als Reverse Proxy für Node.js, Docker und andere Apps
Eine Anwendung auf einem internen Port sauber unter deiner Domain mit HTTPS erreichbar machen, inklusive WebSockets, echter Besucher-IP und mehreren Apps auf einem Server.
Viele Anwendungen bringen ihren eigenen kleinen Webserver mit: eine Node.js-App auf Port 3000, ein Docker-Container auf Port 8080, ein Dashboard auf Port 9000. Ein Reverse Proxy nimmt die Anfragen auf Port 80 und 443 entgegen und leitet sie an die richtige Anwendung weiter. Du bekommst so HTTPS, schöne Adressen ohne Portnummer und mehrere Apps auf einem Server.
Voraussetzungen
- Nginx ist installiert, siehe Nginx installieren
- Deine Anwendung läuft lokal, zum Beispiel auf
http://127.0.0.1:3000
Prüfe das zuerst direkt auf dem Server:
curl -I http://127.0.0.1:3000
Konfiguration anlegen
sudo nano /etc/nginx/sites-available/app.example.com
server {
listen 80;
listen [::]:80;
server_name app.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# WebSockets (Chats, Live-Updates, Konsolen)
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Aktivieren, prüfen, neu laden:
sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
Danach HTTPS mit Certbot: sudo certbot --nginx -d app.example.com, siehe Let's-Encrypt-Zertifikat mit Certbot.
Was die Header bewirken
| Header | Wofür |
|---|---|
Host |
Die App sieht den echten Domainnamen statt 127.0.0.1. |
X-Real-IP, X-Forwarded-For |
Die App sieht die IP des Besuchers statt der des Proxys. |
X-Forwarded-Proto |
Die App weiß, dass der Besucher HTTPS nutzt, und baut Links richtig. |
Upgrade, Connection |
WebSocket-Verbindungen werden durchgereicht. |
Viele Frameworks werten
X-Forwarded-*nur aus, wenn du es einschaltest. Bei Express heißt die Einstellungapp.set('trust proxy', 1).
Die App nicht direkt erreichbar machen
Lauscht die App auf allen Adressen (0.0.0.0:3000), ist sie zusätzlich über http://DEINE-IP:3000 ohne HTTPS erreichbar. Besser lässt du sie nur auf 127.0.0.1 lauschen. Bei Docker geht das so:
ports:
- "127.0.0.1:3000:3000"
Achtung: Docker umgeht UFW. Ein Port, den du mit -p 3000:3000 veröffentlichst, ist trotz UFW-Regel von außen offen.
Mehrere Apps auf einem Server
Lege für jede Anwendung eine eigene Datei mit eigenem server_name an, zum Beispiel app.example.com auf Port 3000 und status.example.com auf Port 3001. Nginx verteilt die Anfragen nach dem Namen.
Größere Uploads und lange Anfragen
client_max_body_size 100M; # Standard sind nur 1 MB
proxy_read_timeout 300s; # für langsame Anfragen
Diese Zeilen kommen in den server- oder location-Block.
Häufige Fehler
- 502 Bad Gateway: Die App läuft nicht oder auf einem anderen Port.
curl http://127.0.0.1:3000auf dem Server zeigt es. - 413 Request Entity Too Large:
client_max_body_sizeerhöhen. - Endlose Weiterleitung: Die App leitet selbst auf HTTPS um, weil sie
X-Forwarded-Protonicht auswertet.
Für die Community
Du kennst dich aus? Schreib eine Anleitung.
Teile, was du weißt: Wir prüfen jede eingereichte Anleitung, veröffentlichen sie mit deinem Namen und bedanken uns mit Guthaben für deine Dienste.