...
Eroare Securitate cibernetică · Certificate TLS și HTTPS

nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/sites-enabled/magazin:4

Pe scurt

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

Greșit
BASH
server {
    listen 443;
    ssl on;
    ssl_certificate /etc/letsencrypt/live/magazin-exemplu.ro/fullchain.pem;
}
Corect
BASH
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

Greșit
BASH
server {
    listen 80;
    listen 443;
    ssl on;
}
Corect
BASH
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ă tu

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

Alte forme ale mesajului

  • nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/nginx.conf:38
  • nginx: [emerg] unknown directive "ssl" in /etc/nginx/sites-enabled/magazin:4
  • nginx: [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 -t după 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

← Toate erorile Securitate cibernetică

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ță 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.