nginx: [emerg] unknown directive "servr_name" in /etc/nginx/sites-enabled/default:8
În configurația nginx e un cuvânt pe care nginx nu-l cunoaște, de obicei o directivă scrisă greșit (servr_name în loc de server_name) sau o linie lipită de alta din cauza unui ; lipsă. Mesajul arată fișierul și linia: repară-le, verifică cu sudo nginx -t și abia apoi sudo systemctl reload nginx.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La pornire, reload sau nginx -t, nginx citește toate fișierele de configurare. Fiecare instrucțiune începe cu numele unei directive cunoscute (server_name, listen, root, location...). Dacă primul cuvânt al unei instrucțiuni nu e o directivă, nginx se oprește cu [emerg] unknown directive "..." și îți dă locul exact: fișierul și numărul liniei (sites-enabled/default:8).
Cauzele: o greșeală de tastare, o directivă a unui modul neinstalat (de exemplu brotli), ghilimele sau caractere invizibile copiate dintr-o pagină web, sau un ; lipsă pe linia de dinainte, care lipește două instrucțiuni. La reload cu o configurație stricată, nginx păstrează configurația veche și continuă să ruleze, deci site-ul merge în continuare, dar schimbările nu se aplică. La restart, însă, nginx nu mai pornește deloc.
De ce apare: cauzele frecvente
1Directivă scrisă greșit
servr_name magazin.ro;server_name magazin.ro;Numele directivelor se scriu exact. Lista lor e în documentația nginx.
2; lipsă pe linia de dinainte
root /var/www/magazin
index index.html;root /var/www/magazin;
index index.html;Fără ;, nginx citește mai departe, iar eroarea poate apărea pe linia următoare, cu alt mesaj (invalid number of arguments).
3Directivă dintr-un modul care lipsește
brotli on;# instalează modulul (de exemplu libnginx-mod-http-brotli-filter)
# sau șterge liniaDirectivele modulelor opționale există doar dacă modulul e instalat și încărcat.
Repară eroarea, direct în pagină
După o modificare în configurația site-ului implicit (/etc/nginx/sites-available/default), sudo systemctl reload nginx eșuează, iar sudo nginx -t afișează nginx: [emerg] unknown directive "servr_name" in /etc/nginx/sites-enabled/default:8. Repară configurația, verific-o cu nginx -t și reîncarcă nginx. Parola lui elev este academia.
Indiciu
Directiva care stabilește numele site-ului se scrie server_name.
Reparația
sudo nginx -t
sudo sed -i 's/servr_name/server_name/' /etc/nginx/sites-available/default
sudo nginx -t
sudo systemctl reload nginxRezultat (al doilea nginx -t):
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulDe ce merge
nginx nu cunoaște nicio directivă servr_name, deci a respins tot fișierul și a indicat linia 8. Directiva corectă e server_name. sites-enabled/default e o legătură spre sites-available/default, de aceea repari fișierul din sites-available.
nginx -t verifică toată configurația fără să atingă serverul care rulează. Abia când spune test is successful, reload aplică configurația nouă fără întreruperi.
Alte forme ale mesajului
nginx: configuration file /etc/nginx/nginx.conf test failednginx: [emerg] unknown directive "brotli" in /etc/nginx/nginx.conf:30nginx: [emerg] invalid number of arguments in "root" directive in /etc/nginx/sites-enabled/magazin:4nginx: [emerg] "server" directive is not allowed here in /etc/nginx/sites-enabled/magazin:1nginx: [emerg] unexpected "}" in /etc/nginx/sites-enabled/magazin:12
Cum o eviți pe viitor
- Rulează mereu
sudo nginx -tdupă orice modificare și abia apoireload:sudo nginx -t && sudo systemctl reload nginx. - Preferă
reloadîn loc derestart: la o configurație stricată, site-ul rămâne online. - Fă o copie a fișierului înainte de editare (
sudo cp default default.bak). - Scrie configurația cu un editor care colorează sintaxa nginx (vim, VS Code cu extensie).
Întrebări frecvente
De ce site-ul merge, deși reload a eșuat?
La reload, nginx testează întâi configurația nouă. Dacă e invalidă, o refuză și continuă cu cea veche. La restart nu are ce păstra, deci rămâne oprit.
Linia din mesaj e corectă, dar tot primesc eroarea. De ce?
Uită-te la linia de dinainte: un ; sau o acoladă lipsă mută eroarea mai jos. Verifică și caracterele invizibile cu cat -A fisier.
Erori înrudite
Job for nginx.service failed because the control process exited with error code. Serviciul a încercat să pornească, dar programul s-a oprit cu eroare, de obicei din cauza unei configurări greșite. Citește motivul cu systemctl status nginx și journalctl -xeu nginx (la nginx, sudo nginx -t arată linia greșită), repară și pornește din nou. nginx: [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use) Alt program ascultă deja pe portul 80, iar un port poate fi ocupat de un singur program. Află cine îl ține cu sudo ss -tlnp | grep ':80 ', oprește-l (de exemplu sudo systemctl disable --now apache2) sau mută unul dintre servere pe alt port. Failed to start nginx.service: Unit nginx.service not found. systemd nu cunoaște niciun serviciu cu numele ăsta: ori programul nu este instalat (sudo apt install nginx), ori ai scris numele greșit, ori ai creat fișierul .service și nu ai rulat sudo systemctl daemon-reload. Învață Linux de la zero, cu exerciții la fiecare lecție
Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
