Directiva listener în OpenLiteSpeed

Virtual Hosts și Listeners OpenLiteSpeed 1.0+

Configurează socket-urile de rețea (adrese IP și porturi) pe care serverul ascultă cereri.

Sintaxă
listener HTTP {
  address *:80
  secure 0
}
listener HTTPS {
  address *:443
  secure 1
}

Ce face Directiva listener

Directiva listener definește punctul de intrare al traficului de rețea în OpenLiteSpeed. Un listener specifică interfața de rețea (adresa IP, unde * înseamnă toate interfețele) și portul TCP/UDP.

Parametrul secure 0 indică trafic necriptat (HTTP standard), în timp ce secure 1 activează modul criptat SSL/TLS (HTTPS).

Pentru fiecare listener este necesară definirea cel puțin a unei mapări (map) către un Virtual Host existent.

Opțiuni și argumente

Opțiune / Parametru Descriere
listener <Nume> Numele de identificare al listener-ului.
address <IP:Port> Adresa IP și portul de ascultare (ex: *:80, *:443).
secure 0 pentru HTTP simplu, 1 pentru conexiuni securizate SSL/TLS.

Ce returnează

Deschiderea socket-ului de rețea la inițializarea serverului.

Exemple

Exemplul 1: Configurarea listener-ului standard HTTPS pe portul 443

Activează modul securizat pe portul standard web HTTPS.

listener HTTPS {
  address                  *:443
  secure                   1
  keyFile                  /etc/letsencrypt/live/exemplu.ro/privkey.pem
  certFile                 /etc/letsencrypt/live/exemplu.ro/fullchain.pem
  map                      ExempluSite exemplu.ro, www.exemplu.ro
}

Greșeli frecvente

  • Setarea ‘secure 1’ fără a specifica fișierele valide de certificat SSL (keyFile și certFile), ducând la eșecul pornirii listener-ului.
  • Ascultarea pe un port deja rezervat de alt serviciu fără oprirea acestuia.

Comenzi înrudite

  • Mapare Virtual Host (map): Leagă o gazdă virtuală de un Listener prin specificarea numelor de domeniu deservite.
  • Directivele certFile și keyFile: Configurează certificatul SSL/TLS, cheia privată și lanțul de autorități intermediare.
  • QUIC și HTTP/3: Activează protocolul de generație următoare HTTP/3 bazat pe UDP pentru viteză extremă pe mobil.