...
Eroare Linux · Procese, servicii, cron și disc

nginx: [emerg] unknown directive "servr_name" in /etc/nginx/sites-enabled/default:8

Pe scurt

Î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

Greșit
BASH
servr_name magazin.ro;
Corect
BASH
server_name magazin.ro;

Numele directivelor se scriu exact. Lista lor e în documentația nginx.

2; lipsă pe linia de dinainte

Greșit
BASH
root /var/www/magazin
index index.html;
Corect
BASH
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

Greșit
BASH
brotli on;
Corect
BASH
# instalează modulul (de exemplu libnginx-mod-http-brotli-filter)
# sau șterge linia

Directivele modulelor opționale există doar dacă modulul e instalat și încărcat.

Repară tu

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.

Alte forme ale mesajului

  • nginx: configuration file /etc/nginx/nginx.conf test failed
  • nginx: [emerg] unknown directive "brotli" in /etc/nginx/nginx.conf:30
  • nginx: [emerg] invalid number of arguments in "root" directive in /etc/nginx/sites-enabled/magazin:4
  • nginx: [emerg] "server" directive is not allowed here in /etc/nginx/sites-enabled/magazin:1
  • nginx: [emerg] unexpected "}" in /etc/nginx/sites-enabled/magazin:12

Cum o eviți pe viitor

  • Rulează mereu sudo nginx -t după orice modificare și abia apoi reload: sudo nginx -t && sudo systemctl reload nginx.
  • Preferă reload în loc de restart: 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

← Toate erorile Linux

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.