Linux & Software2 Min. Lesezeit

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 Einstellung app.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:3000 auf dem Server zeigt es.
  • 413 Request Entity Too Large: client_max_body_size erhöhen.
  • Endlose Weiterleitung: Die App leitet selbst auf HTTPS um, weil sie X-Forwarded-Proto nicht auswertet.

Geschrieben von TryNxt-Team

Wir bauen und betreiben TryNxt selbst und schreiben hier auf, was wir dabei lernen.