Troubleshooting-Handbuch: Nginx-Fehler in Plesk-Umgebungen (Juni 2026)

ZELX FREEMAIL >> Internet >> Programieren >> Troubleshooting-Handbuch: Nginx-Fehler in Plesk-Umgebungen (Juni 2026)
a bunch of blue wires connected to each other
 24. Juni 2026
  |   Keine Kommentare
  |   Blackscenic

Nginx-Fehler

Wenn Nginx – der als Reverse-Proxy vor Apache geschaltet ist – unter Plesk den Dienst versagt, sind die Auswirkungen kritisch: HTTP-Fehler 502 (Bad Gateway), 503 (Service Unavailable) oder Timeouts sind die Folge. Da Plesk den Webserver-Stack komplex verwaltet, ist eine methodische Fehlersuche auf Betriebssystem- und Panel-Ebene unerlässlich.

I. Die erste Fehleranalyse (Diagnose)

Bevor Konfigurationsdateien modifiziert werden, muss der Fehler isoliert werden.

  • Syntax-Validierung: Oft ist eine fehlerhafte Zeile in einer domain-spezifischen nginx.conf die Ursache. Prüfen Sie diese global: nginx -t.
  • Dienststatus prüfen: Nutzen Sie systemctl status nginx und journalctl -u nginx für detaillierte Fehlerprotokolle.
  • Plesk-Synchronisation: Eine Diskrepanz zwischen der Plesk-Datenbank und den generierten Konfigurationsdateien ist häufig. Nutzen Sie das Webserver Configuration Troubleshooter Tool im Plesk-Panel.

II. Erweiterte Lösungsszenarien

1. Die „Rebuild“-Strategie (Plesk Integration)

Wenn Nginx in Plesk aktiv erscheint, aber auf Betriebssystemebene nicht startet, hilft ein erzwungener Rebuild:

  1. Deaktivierung: /usr/local/psa/admin/sbin/nginxmng -d
  2. Prozess-Bereinigung: pkill nginx oder prüfen via ps aux | grep nginx.
  3. Reaktivierung: /usr/local/psa/admin/sbin/nginxmng -e

2. Upstream- und Connectivity-Fehler (502 Bad Gateway)

Ein 502-Fehler signalisiert, dass Nginx läuft, aber keine Antwort vom Backend (Apache/PHP-FPM) erhält.

  • PHP-FPM Socket-Probleme: Prüfen Sie, ob die Pools laufen. Ein oft übersehener Grund ist die Erschöpfung der Prozess-Limits pro Domain.
  • Timeout-Anpassung: Wenn das Backend zu lange braucht, erhöhen Sie die Werte:
    • proxy_read_timeout 300;
    • proxy_connect_timeout 300;
    • (Einzutragen unter: Plesk > Domain > Apache & nginx Einstellungen > Zusätzliche nginx-Anweisungen)

3. Netzwerk-Race-Condition beim Boot

Der Fehler 99: Cannot assign requested address tritt auf, wenn Nginx startet, bevor das Netzwerk-Interface (IP) bereit ist.

  • Fix: systemctl edit nginx.service öffnen und den ExecStart-Befehl durch eine Warteschleife ergänzen, die auf die IP-Verfügbarkeit prüft.

4. Sicherheits-Barrieren: SELinux und ModSecurity

Manchmal blockieren Sicherheitsmechanismen den Webserver.

  • SELinux: Prüfen Sie mit sestatus, ob es aktiv ist. Ein setenforce 0 (zum Testen) offenbart sofort, ob SELinux den Zugriff auf Sockets oder Dateien verhindert.
  • ModSecurity: Fehlkonfigurationen in der Web Application Firewall (WAF) können valide Anfragen blockieren, die dann als 403 oder 502 beim Nutzer ankommen. Deaktivieren Sie ModSecurity temporär unter Plesk > Tools & Einstellungen > Web Application Firewall (ModSecurity), um dies als Ursache auszuschließen.

5. Ressourcen-Limits (Ulimits)

Bei hohem Traffic kann das Betriebssystem-Limit für offene Dateien erreicht sein.

  • Erhöhung: /usr/local/psa/admin/sbin/websrv_ulimits --set 8192 --no-restart
  • Danach ist ein Neustart über das Plesk-Panel zwingend, um die Einstellungen systemweit zu übernehmen.

III. Die Notfall-Reparatur: „Plesk Repair“

Wenn die Ursache nicht lokalisierbar ist, hilft das Plesk-eigene Reparatur-Tool, das die gesamte Konfiguration auf Konsistenz prüft:

Bash

# Überprüft die Webserver-Konfiguration auf Konsistenz
plesk repair web -server

# Erzwingt das Neuerstellen aller Konfigurationsdateien (Vorsicht!)
plesk repair web -vhost-config

Dieser Guide ist für erfahrene Administratoren gedacht. Arbeiten an Server-Konfigurationen sollten immer mit einem vorherigen Backup der Datenbank und der betroffenen Konfigurationsdateien durchgeführt werden.

IV. Haftungsausschluss

Dieser Leitfaden stellt Informationen nach bestem Wissen bereit. Da Server-Konfigurationen hochgradig individuell sind und ein Eingreifen in die Systemdateien (insbesondere bei Webserver-Stacks) zu schwerwiegenden Fehlfunktionen, Datenverlust oder einer Nicht-Erreichbarkeit Ihrer Dienste führen kann, erfolgt die Anwendung dieses Artikels ausdrücklich auf eigenes Risiko. Für eventuelle Schäden an Soft- oder Hardware, Datenverlust oder Ausfallzeiten wird jegliche Haftung ausgeschlossen. Es wird dringend empfohlen, vor jeder Änderung ein vollständiges Backup Ihres Servers und der Plesk-Datenbank zu erstellen.

Aufrufe: 5 Views

TOP