Nginx: aggiornare alla 1.30.7 o 1.31.9 dopo l’avviso di sicurezza
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 contestihttpeserver. È documentata nella pagina del modulo ngx_http_v2_module, che indica come valore predefinitohttp2 off;; - nelle configurazioni più vecchie, il parametro
http2sulle righelisten. 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:
- nginx.org — nginx security advisories
- nginx.org — nginx: Linux packages
- NGINX Documentation — Installing NGINX Open Source
- nginx.org — Command-line parameters
- nginx.org — Module ngx_http_v2_module
- NGINX Documentation — Live Activity Monitoring
- nginx.org — Controlling nginx


