So sieht die Meldung aus
nginx: [emerg] could not build server_names_hash, you should increase server_names_hash_bucket_size: 64
nginx: configuration file /etc/nginx/nginx.conf test failedHäufige Ursachen
- Ein
server_nameist sehr lang (zum Beispiel eine lange Subdomain), und ein Bucket ist dafür zu klein. - Über mehrere
server-Blöcke kamen viele Servernamen hinzu, die Tabelle braucht eine größere Größe. - Derselbe Name steht an mehreren Stellen, weil eine Datei doppelt eingebunden ist, das bläht die Tabelle auf.
- Eine generierte Konfiguration (Wildcard-Listen, viele Aliase pro Seite) kam hinzu, ohne die Hash-Einstellungen anzuheben.
Prüfen
- Konfigurationstest ausführen
nginx -t - Aktuelle Hash-Einstellungen, falls vorhanden
nginx -T 2>/dev/null | grep -nE 'server_names_hash' - Die längsten konfigurierten Servernamen
nginx -T 2>/dev/null | grep -E '^\s*server_name' | tr -s ' ;' '\n' | awk 'length > 25' | sort -u - Ist eine Datei doppelt eingebunden?
nginx -T 2>/dev/null | grep -E '^# configuration file' | sort | uniq -d
Lösung
- Im
http-Block von/etc/nginx/nginx.confergänzen:server_names_hash_bucket_size 128;(eine Zweierpotenz; die Meldung nennt den aktuellen Wert). - Bleibt der Fehler oder hast du hunderte Namen, zusätzlich
server_names_hash_max_sizeanheben, zum Beispiel1024. - Doppelte Includes entfernen, damit kein Name zweimal definiert ist.
- Testen und anwenden:
nginx -t && systemctl reload nginx.
Typisches Szenario
Du betreibst einen Webserver für viele Kundenprojekte und legst per Skript für jeden Kunden eine eigene Konfigurationsdatei an. Beim Hinzufügen einer Domain mit sehr langer Subdomain bricht nginx -t ab: „could not build server_names_hash, you should increase server_names_hash_bucket_size: 64“. Die laufende nginx-Instanz ist unberührt, nur das Neuladen schlägt fehl. Lies in der Meldung den aktuellen Wert und verdopple ihn im http-Block.
Häufige Fragen
Welchen Wert soll ich nehmen?
Verdopple den Wert aus der Meldung und probiere es erneut: aus 64 wird 128, bei Bedarf 256. Die Bucket-Größe muss eine Zweierpotenz sein.
Warum erscheint das nach einer weiteren Domain?
Die Tabelle wird beim Laden der Konfiguration dimensioniert. Ein weiterer oder ein längerer Name kann der sein, der nicht mehr passt, obwohl das alte Setup funktionierte.
Bleibt der laufende nginx bestehen, wenn die Konfiguration fehlerhaft ist?
Ja. Bei reload prüft nginx die neue Konfiguration zuerst, und schlägt das fehl, laufen die alten Worker mit der alten Konfiguration weiter. Ein restart würde den Dienst dagegen stoppen und dann nicht mehr starten. Teste deshalb vor jedem Neuladen mit nginx -t.
Wovon hängt der Standardwert der Bucket-Größe ab?
Er richtet sich nach der Cache-Zeilengröße des Prozessors, daher sind je nach Hardware 32, 64 oder 128 üblich. Deshalb tritt der Fehler auf einem Server auf und auf einem anderen mit derselben Konfiguration nicht. Der Wert muss ein Vielfaches davon sein.
Wie finde ich die Namen, die das Limit sprengen?
Mit nginx -T | grep server_name listest du alle Namen der geladenen Konfiguration auf. Achte auf sehr lange Namen und auf doppelt eingebundene Dateien. Auch lange Wildcard- oder Regex-Namen belegen Platz. Danach setzt du den Bucket-Wert passend, statt blind hoch zu gehen.