nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/sites-enabled/magazin:4
Configurarea folosește vechea directivă „ssl on;”, scoasă din nginx-ul nou. Șterge linia ssl on; și pune ssl în directiva listen: listen 443 ssl;. E doar un avertisment, dar în versiunile foarte noi directiva nu mai există deloc.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la nginx -t sau la pornirea serviciului. [warn] înseamnă că nginx pornește în continuare, dar te anunță că o directivă e învechită. Directiva ssl on; activa TLS pentru tot blocul server; din nginx 1.15 este înlocuită de parametrul ssl al lui listen, care activează TLS doar pentru portul respectiv. Fișierul și linia (sites-enabled/magazin:4) arată exact unde e directiva.
Problema nu e doar estetică. Cu ssl on;, TLS se aplică pe toate porturile blocului: dacă blocul ascultă și pe 80, cererile HTTP simple primesc erori ciudate (The plain HTTP request was sent to HTTPS port). Configurările vechi, copiate din tutoriale, au adesea și ssl_protocols cu versiuni nesigure, deci e un moment bun să le verifici. În versiunile nginx de după 1.25, directiva a fost scoasă, iar mesajul devine [emerg] unknown directive "ssl".
De ce apare: cauzele frecvente
1Configurare veche copiată din tutoriale
server {
listen 443;
ssl on;
ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;
}server {
listen 443 ssl;
ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;
}listen 443 ssl activează TLS doar pe portul 443, exact ce făcea ssl on într-un bloc cu un singur port.
2Un singur bloc pentru HTTP și HTTPS
server {
listen 80;
listen 443;
ssl on;
}server {
listen 80;
listen 443 ssl;
}Cu ssl on, și portul 80 ar cere TLS. Cu ssl pe listen, portul 80 rămâne HTTP simplu.
Repară eroarea, direct în pagină
sudo nginx -t afișează [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead pentru /etc/nginx/sites-available/magazin. Modernizează blocul: șterge linia ssl on; și activează TLS direct în directiva listen 443. Certificatul și cheia rămân neschimbate. Parola lui elev este academia.
Indiciu
Ai nevoie de două modificări cu sudo sed -i: ștergi linia ssl on; și transformi listen 443; în listen 443 ssl;.
Reparația
Vezi blocul:
cat /etc/nginx/sites-available/magazinȘterge directiva veche și mută ssl pe listen:
sudo sed -i -e '/^\s*ssl on;/d' -e 's/listen 443;/listen 443 ssl;/' /etc/nginx/sites-available/magazin
cat /etc/nginx/sites-available/magazinDe ce merge
ssl on; era modul vechi de a activa TLS pentru tot blocul server, motiv pentru care nginx îl marchează învechit. Parametrul ssl pe listen 443 face același lucru, dar doar pentru portul 443, așa că un eventual listen 80 din același bloc rămâne HTTP simplu. Directivele ssl_certificate și ssl_certificate_key nu se schimbă, iar după modificare nginx -t nu mai afișează avertismentul.
Alte forme ale mesajului
nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/nginx.conf:38nginx: [emerg] unknown directive "ssl" in /etc/nginx/sites-enabled/magazin:4nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead
Cum o eviți pe viitor
- Scrie configurările TLS după șablonul generat de certbot sau de Mozilla SSL Configuration Generator, nu după tutoriale vechi.
- Rulează
sudo nginx -tdupă fiecare schimbare și citește și liniile[warn], nu doar[emerg]. - Când actualizezi nginx, caută directivele marcate ca învechite înainte să dispară.
- Ține HTTP și HTTPS în blocuri separate, cu redirecționare de pe 80 pe 443.
Întrebări frecvente
Site-ul merge. Trebuie totuși să repar?
Da: la o actualizare viitoare a nginx, directiva poate dispărea, iar serverul nu mai pornește. Schimbarea durează un minut acum, nu în mijlocul unei actualizări de securitate.
Și avertismentul cu http2?
Este aceeași idee pentru HTTP/2: în versiunile noi se scrie http2 on; separat, nu listen 443 ssl http2;. Pe nginx 1.24 din Ubuntu 24.04, forma cu listen ... http2 e încă cea folosită.
Erori înrudite
curl: (35) OpenSSL/3.0.13: error:0A00010B:SSL routines::wrong version number curl a început o conexiune TLS, dar serverul a răspuns cu text simplu (HTTP fără criptare). Fie te conectezi cu https pe un port care servește http (https://site:80), fie serverul ascultă pe 443 fără TLS: în nginx lipsește ssl din listen 443 ssl;. 400 Bad Request: The plain HTTP request was sent to HTTPS port Clientul a vorbit HTTP simplu cu un port care așteaptă TLS (de obicei 443), iar nginx răspunde cu 400. Folosește https:// în adresă, fără :443 după http://, sau pe server redirecționează portul 80 spre HTTPS. nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in /etc/nginx/sites-enabled/magazin:2 Blocul server ascultă cu TLS (listen 443 ssl), dar nu spune ce certificat și ce cheie să folosească, deci nginx nu pornește. Adaugă în același bloc ssl_certificate cu fullchain.pem și ssl_certificate_key cu privkey.pem, apoi rulează sudo nginx -t. Învață Securitate cibernetică de la zero, cu exerciții la fiecare lecție
Curs Cybersecurity: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
