Vai al contenuto

Nginx: aggiornare alla 1.30.7 o 1.31.9 dopo l’avviso di sicurezza

Illustrazione 3D isometrica di una sala server con tecnici al lavoro e l'insegna Opengeek.
Immagine generata con IA

Dieci voci nuove dell’avviso di sicurezza di nginx riguardano le versioni fino alla 1.31.8 compresa. Le versioni corrette sono la 1.31.9 per il ramo mainline e la 1.30.7 per lo stable. Ogni voce parte da una versione diversa e alcune riguardano solo certi moduli. Il nome «NGINX2Root» non compare nell’avviso: qui si usano i CVE che l’avviso riporta. La guida è per chi gestisce nginx su un server Linux. Si legge la versione installata e la si confronta con l’avviso. Poi si aggiorna dal repository nginx.org, si controlla dove è attivo HTTP/2 e si verifica la configurazione prima di ricaricarla. Installare il pacchetto nuovo non basta: i processi già avviati restano alla versione vecchia finché nginx non riparte con il nuovo eseguibile. I comandi sono quelli della documentazione ufficiale, elencata in fondo.

Cosa serve

  • Un server con una distribuzione supportata dai pacchetti nginx.org: Debian 12 «bookworm» e 13 «trixie», Ubuntu 22.04, 24.04 e 26.04, RHEL 8.x, 9.x e 10.x e derivate (CentOS, Oracle Linux, Rocky Linux, AlmaLinux), su x86_64 o aarch64/arm64.
  • Un account con i permessi di sudo.
  • L’accesso a internet verso nginx.org, da cui arrivano la chiave di firma e i pacchetti.
  • Una copia di riserva della cartella /etc/nginx, da fare prima di cambiare repository.

Controllare la versione di nginx installata

Il parametro -v stampa la versione di nginx, come spiega la pagina dei parametri da riga di comando.

sudo nginx -v

Annota il numero per il confronto con l’avviso.

Confrontare la versione con l’avviso ufficiale

Nell’avviso ogni vulnerabilità ha una gravità e due voci: «Vulnerable» indica le versioni colpite, «Not vulnerable» quelle corrette. Le dieci voci nuove hanno gravità major, medium e minor. L’avviso non riporta un punteggio CVSS e non indica se le falle siano sfruttate attivamente.

Problema Gravità CVE Vulnerabili Corrette
Memory corruption in HTTP/2 flow control major CVE-2026-123007 1.9.5-1.31.8 1.31.9+, 1.30.7+
Infinite loop while reading client request body over TLS 1.3 major CVE-2026-118899 1.13.0-1.31.8 1.31.9+, 1.30.7+
Use-after-free in mail proxy module major CVE-2026-113425 0.5.33-1.31.8 1.31.9+, 1.30.7+
Use-after-free during response processing in resolver medium CVE-2026-123634 0.6.18-1.31.8 1.31.9+, 1.30.7+
Use-after-free in HTTP/3 medium CVE-CVE-2026-121810 (scritto così nell’avviso) 1.25.0-1.31.8 1.31.9+, 1.30.7+
Use-after-free in HTTP/2 medium CVE-2026-123633 1.19.7-1.31.8 1.31.9+, 1.30.7+
SNI bypass when using client certificate validation in stream medium CVE-2026-120967 1.25.5-1.31.8 1.31.9+, 1.30.7+
NULL pointer dereference when using PROXY protocol version 2 minor CVE-2026-120993 1.31.4-1.31.8 1.31.9+
Buffer overflow when using alias with try_files minor CVE-2026-125283 0.9.6-1.31.8 1.31.9+, 1.30.7+
Insufficient validation in stream ssl_preread module minor CVE-2026-123640 1.15.2-1.31.8 1.31.9+, 1.30.7+

Secondo la documentazione di installazione di NGINX, il ramo mainline ha sempre il numero centrale dispari (1.31.x) e lo stable sempre pari (1.30.x). Sul mainline serve la 1.31.9 o successiva, sullo stable la 1.30.7 o successiva. La voce sul PROXY protocol v2 fa eccezione: come versione corretta indica solo la 1.31.9+.

Se nginx viene dai repository della distribuzione, il confronto va fatto con cautela. La stessa documentazione spiega che quei pacchetti sono mantenuti dai manutentori della distribuzione e possono essere datati. Aggiunge che F5 non può verificarne il contenuto, la compilazione e la frequenza di aggiornamento. Il nostro consiglio: non fermarti al numero di versione. Leggi il bollettino di sicurezza della tua distribuzione per ciascun CVE, oppure passa al repository nginx.org con i passaggi seguenti.

Debian: aggiungere il repository nginx.org e aggiornare

Prima copia la cartella /etc/nginx in un posto sicuro. È una precauzione: stai per cambiare l’origine del pacchetto. Considera anche i moduli dinamici. Secondo linux_packages.html, nginx-module-geoip, nginx-module-image-filter, nginx-module-njs, nginx-module-perl e nginx-module-xslt sono pacchetti separati. Lo stesso vale per nginx-module-otel dalla 1.25.3 e per nginx-module-acme dalla 1.29.1. Se la tua configurazione li usa, devi installarli a parte.

sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

Il comando seguente scarica la chiave di firma di nginx e la salva tra le chiavi di apt. Non esegue nessuno script. Lancialo senza cambiare l’indirizzo: apt userà questa chiave per verificare i pacchetti.

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

Controlla che il file contenga la chiave giusta:

gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

Nell’output deve comparire l’impronta 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62:

pub rsa2048 2011-08-19 [SC] [expires: 2027-05-24]
 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
uid nginx signing key <[email protected]>

Possono comparire anche altre chiavi di firma. La documentazione di NGINX ne elenca altre due: 8540A6F18833A80E9C1653A42FD21310B49F6B46 e 9E9BE90EACBCDE69FE9B204CBCDCD8A38D88A2B3. Se le impronte non corrispondono, cancella il file e fermati.

Aggiungi il repository dei pacchetti stable. Il nome in codice della release lo ricava il comando stesso con lsb_release -cs. Per il ramo mainline, linux_packages.html riporta una variante con l’indirizzo /packages/mainline/debian.

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
https://nginx.org/packages/debian `lsb_release -cs` nginx" \
    | sudo tee /etc/apt/sources.list.d/nginx.list

Imposta il pinning, così apt preferisce i pacchetti nginx.org a quelli della distribuzione:

echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
    | sudo tee /etc/apt/preferences.d/99nginx

Aggiorna l’elenco dei pacchetti e installa nginx:

sudo apt update
sudo apt install nginx

Con i pacchetti nginx.org il file di configurazione principale è /etc/nginx/nginx.conf. I log stanno in /var/log/nginx/.

Ubuntu: stessa procedura con i pacchetti per Ubuntu

Su Ubuntu cambiano due cose: il pacchetto del portachiavi tra i prerequisiti e l’indirizzo del repository. Anche qui copia prima /etc/nginx. Le note sui moduli dinamici del passaggio Debian valgono anche qui.

sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring

Scarica la chiave di firma senza modificare il comando, poi verificala:

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

L’impronta da trovare è la stessa di Debian: 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62. Se non corrisponde, cancella il file e fermati. Poi aggiungi il repository per Ubuntu e il pinning:

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
https://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
    | sudo tee /etc/apt/sources.list.d/nginx.list
echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
    | sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
sudo apt install nginx

RHEL e derivate: configurare il repository yum e installare

La procedura vale per Red Hat Enterprise Linux, CentOS, Oracle Linux, Rocky Linux e AlmaLinux. Copia prima /etc/nginx, poi installa i prerequisiti:

sudo yum install yum-utils

Crea il file del repository con un editor di testo, per esempio vi:

sudo vi /etc/yum.repos.d/nginx.repo

Incolla questo contenuto in /etc/yum.repos.d/nginx.repo e salva:

[nginx-stable]
name=nginx stable repo
baseurl=https://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true
[nginx-mainline]
name=nginx mainline repo
baseurl=https://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

Non c’è niente da sostituire: $releasever e $basearch li inserisce yum. Il blocco stable ha enabled=1 e il mainline enabled=0, quindi yum usa il ramo stable, cioè la 1.30.x. Per passare al ramo mainline 1.31.x, abilita il repository nginx-mainline con lo strumento yum-config-manager, come indica linux_packages.html.

Installa nginx:

sudo yum install nginx

Quando yum chiede di accettare la chiave GPG, controlla l’impronta. Accettala solo se è 573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62. La documentazione di NGINX indica come valide anche 8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46 e 9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3. Non accettare nessun’altra impronta.

Verificare che la versione sia tra quelle corrette

sudo nginx -v

Il numero deve essere 1.30.7 o successivo sul ramo stable, oppure 1.31.9 o successivo sul mainline. Se è più basso, ricontrolla il file del repository. Su Debian e Ubuntu ricontrolla anche il pinning.

Questo numero riguarda il programma installato su disco, non i processi già in esecuzione. Il master e i worker avviati prima dell’aggiornamento continuano a girare con l’eseguibile vecchio. Il reload descritto più avanti non basta: rilegge la configurazione e avvia nuovi worker. Né la pagina dei parametri né Controlling nginx dicono che sostituisca l’eseguibile in esecuzione.

Per sostituirlo senza interrompere il servizio, Controlling nginx descrive una procedura con i segnali USR2, WINCH e QUIT nella sezione «Upgrading Executable on the Fly». Se nginx è gestito dal sistema di servizi della distribuzione, segui le istruzioni della distribuzione per riavviarlo: la documentazione usata qui non le tratta.

Capire dove è attivo HTTP/2

Questo controllo non corregge niente: serve a capire se la configurazione è esposta. Due voci dell’avviso riguardano HTTP/2: CVE-2026-123007 e CVE-2026-123633. L’avviso non indica la disattivazione di HTTP/2 come rimedio: l’unica correzione che riporta è l’aggiornamento.

Lancia nginx con il parametro -T. Fa lo stesso test di -t e in più stampa tutti i file di configurazione caricati, compresi quelli richiamati con include. Nell’output cerca la parola http2, per esempio con la funzione di ricerca del terminale. Può comparire in due forme:

  • la direttiva http2 on;, disponibile dalla versione 1.25.1 nei contesti http e server. È documentata nella pagina del modulo ngx_http_v2_module, che indica come valore predefinito http2 off;;
  • nelle configurazioni più vecchie, il parametro http2 sulle righe listen. La pagina del modulo non descrive questa forma.

Testare la configurazione e ricaricarla senza fermare il servizio

Il parametro -t controlla la sintassi e prova ad aprire i file citati nella configurazione. Grazie a &&, il reload parte solo se il test riesce.

sudo nginx -t && sudo nginx -s reload

Con il reload nginx rilegge la configurazione, avvia nuovi worker e chiude con calma quelli vecchi. Secondo Controlling nginx, il processo master prima verifica la sintassi e poi prova ad applicare la nuova configurazione. Se non ci riesce, annulla le modifiche e continua a servire le richieste con la configurazione precedente. La documentazione di NGINX usa lo stesso comando dopo ogni modifica alla configurazione.

Se qualcosa va storto

  • L’impronta della chiave non corrisponde: cancella subito il file e non proseguire. Su RHEL non accettare la chiave quando yum la propone.
  • Il test della configurazione fallisce: il reload non parte e nginx resta con la configurazione già caricata. Correggi l’errore segnalato e ripeti il test.
  • La nuova configurazione non si applica durante il reload: il master continua con quella precedente.

Documentazione di riferimento

Pagine consultate il 20 novembre 2026:

Leggi anche

  • NGINX
  • Red Hat Enterprise Linux
  • Ubuntu