So sieht die Meldung aus
2026/10/29 14:02:11 [alert] 1234#1234: *98765 768 worker_connections are not enough while connecting to upstream, client: 203.0.113.5, server: example.com, request: "GET /api/ HTTP/2.0", upstream: "http://127.0.0.1:8080/api/"Häufige Ursachen
worker_connectionsimevents-Block steht noch auf dem niedrigen Wert der mitgeliefertennginx.conf, und der Verkehr ist darüber hinausgewachsen.- Ein langsamer Upstream hält Verbindungen lange offen, sie stauen sich (siehe auch die Seiten zu 504 und 502).
- Langlebige Verbindungen wie WebSocket, SSE oder Long Polling belegen einen Platz für ihre ganze Lebensdauer.
- Das Limit in nginx liegt höher, als das Betriebssystem erlaubt: Das Open-Files-Limit des nginx-Prozesses ist zu klein, der Wert lässt sich nicht nutzen.
- Eine Flut von Anfragen durch Bots oder einen fehlerhaften Client.
Prüfen
- Aktuelle Worker-Einstellungen
nginx -T 2>/dev/null | grep -nE 'worker_(processes|connections|rlimit_nofile)' - Wie oft taucht der Alert auf?
grep -c 'worker_connections are not enough' /var/log/nginx/error.log - Open-Files-Limit des laufenden Master-Prozesses
grep 'open files' /proc/$(cat /run/nginx.pid)/limits - Socket-Übersicht (aufgebaut vs. wartend)
ss -s
Lösung
- Das Limit in
/etc/nginx/nginx.conferhöhen:events { worker_connections 4096; }, dazuworker_processes auto;beibehalten. - Genug Dateideskriptoren erlauben:
worker_rlimit_nofile 8192;im Hauptkontext, beim Proxy mindestens das Doppelte vonworker_connections. - Wenn systemd den Dienst begrenzt, mit
systemctl edit nginxein Drop-in anlegen undLimitNOFILE=auf einen passenden Wert setzen. - Die Last selbst senken: den langsamen Upstream beheben,
keepalivezum Upstream aktivieren und missbräuchliche Clients mitlimit_reqbremsen. - Anwenden:
nginx -t && systemctl restart nginx(ein Reload ändert das von systemd gesetzte Prozesslimit nicht).
Typisches Szenario
Eine Chat-Anwendung mit WebSockets läuft hinter nginx als Reverse-Proxy. Zur Stoßzeit häufen sich im Log die Zeilen „768 worker_connections are not enough“, und neue Nutzer bekommen keine Verbindung. 768 ist der Wert aus der Paket-nginx.conf unter Debian und Ubuntu. Jede WebSocket-Verbindung belegt zwei Slots, einen zum Browser und einen zum Backend. Schalte zuerst stub_status ein und lies „Active connections“ zur Stoßzeit ab.
Häufige Fragen
Wie viele Clients kann nginx maximal bedienen?
Grob worker_processes × worker_connections, beim Proxy durch zwei geteilt, weil jede weitergeleitete Anfrage eine Client- und eine Upstream-Verbindung braucht.
Ist ein höherer Wert immer besser?
Nein. Jede Verbindung kostet Speicher und einen Dateideskriptor. Erhöhe moderat, sorge für ein passendes Deskriptor-Limit und behebe die Ursache, wenn sich Verbindungen wegen eines langsamen Backends stauen.
Wie sehe ich die aktuelle Zahl der Verbindungen?
Aktiviere das Modul stub_status in einem nur lokal erreichbaren Location-Block. Die Ausgabe nennt „Active connections“, außerdem Reading, Writing und Waiting. Alternativ zeigt ss -s die offenen TCP-Verbindungen des gesamten Servers. Die Anzahl der Worker legst du mit worker_processes auto fest, meist eine pro CPU-Kern.
Wie viele Nutzer entsprechen 768 Verbindungen bei WebSockets?
Etwa die Hälfte, denn jede WebSocket-Verbindung hält für ihre gesamte Lebensdauer zwei Verbindungen offen: eine zum Client, eine zum Upstream. Rund 380 gleichzeitige Chat-Nutzer brauchen also schon einen ganzen Worker aus. Mehrere Worker verteilen die Last, ein Limit gilt aber je Worker.
Woran sehe ich, ob das Datei-Limit wirklich greift?
Lies cat /proc/$(pgrep -o nginx)/limits und achte auf „Max open files“. Steht dort ein kleinerer Wert als worker_connections mal zwei, wurde worker_rlimit_nofile oder LimitNOFILE nicht übernommen, und es hilft kein höherer Wert in events.