Padroneggiare la Compressione Nginx: Gzip vs. Brotli per le Performance Web

La compressione Nginx è uno di quei cambiamenti che sembrano piccoli finché non guardi il pannello di rete. Un file CSS, un bundle JavaScript, una pagina HTML, una risposta API JSON o un SVG possono spesso viaggiare sulla rete come risposta molto più piccola, per poi espandersi allo stesso contenuto nel browser.

La scelta pratica di solito non è "Gzip o Brotli per sempre." La maggior parte delle configurazioni di produzione usa entrambi: Brotli per i browser che lo richiedono, Gzip come fallback e file statici precompressi dove la pipeline di build può crearli in anticipo. I dettagli contano, però. Un blocco di compressione copiato può sprecare CPU, saltare importanti tipi MIME o fallire silenziosamente perché il modulo Brotli non è effettivamente installato.

Comprendere la Compressione Web in Nginx

La compressione funziona trovando schemi ripetitivi nei dati (come file HTML, CSS o JavaScript) e sostituendoli con riferimenti più brevi. Questo riduce la dimensione totale del file trasferito sulla rete. Nginx agisce come intermediario, applicando l'algoritmo di compressione scelto dinamicamente prima di inviare i dati al browser.

Nginx richiede tipicamente il modulo ngx_http_gzip_module per Gzip e un modulo Brotli separato per Brotli. La maggior parte dei pacchetti Nginx comuni include il supporto Gzip. Brotli è più variabile: alcune distribuzioni lo impacchettano come modulo dinamico, alcuni repository di terze parti lo includono e alcune build non lo hanno affatto.

Prerequisiti

Assicurati che la tua installazione Nginx supporti Brotli se prevedi di usarlo. Puoi spesso verificare se Brotli è disponibile eseguendo:

nginx -V 2>&1 | grep -i brotli

Se l'output menziona Brotli, conferma se è compilato o caricato come modulo dinamico. Su sistemi Debian o Ubuntu, controlla anche i file in /etc/nginx/modules-enabled/ se il tuo pacchetto usa moduli dinamici:

ls -l /etc/nginx/modules-enabled/ | grep -i brotli

Se Nginx rifiuta brotli on; durante nginx -t, il modulo non è disponibile per quel binario Nginx in esecuzione, anche se il sistema operativo ha un pacchetto Brotli installato altrove.

1. Configurare la Compressione Gzip

Gzip è lo standard maturo e ampiamente supportato per la compressione dei contenuti. Offre un buon equilibrio tra rapporto di compressione e overhead della CPU.

Abilitare Gzip nella Configurazione Nginx

Le impostazioni Gzip sono tipicamente inserite nei blocchi http, server o location del tuo file di configurazione Nginx (nginx.conf o file di configurazione inclusi).

Per abilitare la compressione Gzip, usa le seguenti direttive:

http {
    # Abilita la compressione Gzip
    gzip on;

    # Imposta la dimensione minima della risposta da comprimere (byte)
    # Comprimi solo file più grandi di 1000 byte
    gzip_min_length 1000;

    # Livello di compressione (1=più veloce/compressione più bassa, 9=più lento/compressione più alta)
    gzip_comp_level 6;

    # Specifica quali tipi MIME comprimere
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml;

    # Raccomandato: Invia l'intestazione Vary: Accept-Encoding in modo che i proxy memorizzino nella cache sia le versioni compresse che quelle non compresse
    gzip_vary on;

    # Raccomandato: Aggiungi intestazione gzip per identificazione
    gzip_proxied any;
}

Spiegazione delle Direttive Chiave Gzip

• gzip on;: Attiva il modulo Gzip.
• gzip_comp_level: Impostare questo valore tra 4 e 6 è spesso il punto ottimale per le prestazioni. Livelli più alti risparmiano più larghezza di banda ma aumentano l'uso della CPU sul server.
• gzip_types: È fondamentale non comprimere mai formati già compressi come immagini (.jpg, .png, .gif) o video.

2. Configurare la Compressione Brotli

Brotli è un algoritmo di compressione più recente sviluppato da Google. Per risorse di testo, spesso produce file più piccoli di Gzip. Il guadagno esatto dipende dal contenuto, dal livello di compressione e dal fatto che i file siano compressi durante ogni richiesta o in anticipo durante la distribuzione.

Abilitare Brotli nella Configurazione Nginx

La configurazione Brotli usa direttive simili ma sostituisce gzip con brotli.

brotli on;
brotli_comp_level 6; # Tipicamente da 4 a 8 è raccomandato
brotli_static on; # Abilita il servizio di file .br precompressi se disponibili
brotli_types text/plain text/css application/json application/javascript application/x-javascript text/xml;

Nota Importante sulla Pre-compressione (brotli_static):

La compressione Brotli può essere intensiva per la CPU quando eseguita al volo per ogni richiesta. Una pratica comune consigliata è pre-comprimere le risorse usando uno strumento offline dedicato (come l'utilità a riga di comando brotli) e memorizzare la versione .br insieme al file originale (ad esempio, style.css e style.css.br).

Impostare brotli_static on; dice a Nginx di verificare se esiste un file .br precompresso per la risorsa richiesta e di servirlo direttamente se il client supporta Brotli, bypassando completamente l'elaborazione in tempo reale.

3. Gzip vs. Brotli: Fare la Scelta Giusta

La scelta tra Gzip e Brotli dipende fortemente dal supporto del client e dalle risorse del server.

Caratteristica	Gzip	Brotli	Raccomandazione
Rapporto di Compressione	Buono	Spesso migliore per risorse di testo	Brotli di solito vince
Carico CPU (Al volo)	Basso	Da Moderato ad Alto	Gzip è più leggero
Supporto Client	Quasi Universale (Tutti i browser moderni)	Molto Alto (La maggior parte dei browser moderni)	Gzip è più sicuro per supporto legacy
Pre-compressione	Possibile, ma meno comune	Altamente raccomandata (brotli_static)	Usa Brotli precompresso se possibile

L'Approccio Ibrido: Migliore Pratica

La configurazione moderna più robusta usa un setup ibrido, dando priorità a Brotli per i client moderni mentre fornisce Gzip come fallback affidabile.

1. Dai Priorità a Brotli: Configura Brotli per primo, spesso usando brotli_static on; per velocità.
2. Fallback a Gzip: Assicurati che Gzip sia abilitato e configurato per gestire i client che non supportano Brotli.

Nginx sceglie una risposta in base all'intestazione Accept-Encoding del client e ai moduli abilitati nella tua build. Nel traffico browser normale, Brotli è preferito quando il client pubblicizza br; Gzip rimane utile per client, strumenti, proxy e stack più vecchi che richiedono solo gzip.

Esempio di Configurazione Ibrida

Se la tua versione di Nginx supporta entrambi i moduli, puoi abilitarli simultaneamente. Nginx dà priorità a quale modulo serve il contenuto in base alle intestazioni di richiesta del client.

http {
    # --- Configurazione Brotli ---
    brotli on;
    brotli_comp_level 6;
    brotli_static on;
    brotli_types
        text/plain
        text/css
        application/javascript
        application/json
        application/xml
        image/svg+xml;

    # --- Configurazione Gzip (Fallback) ---
    gzip on;
    gzip_comp_level 5;
    gzip_vary on;
    gzip_proxied any;
    gzip_types
        text/plain
        text/css
        application/javascript
        application/json
        application/xml
        image/svg+xml;
}

Suggerimenti per l'Ottimizzazione delle Prestazioni

Indipendentemente dall'algoritmo selezionato, segui queste migliori pratiche per il massimo impatto:

1. Verifica la Risposta Effettiva

Non dare per scontato che la compressione funzioni perché il file di configurazione contiene gzip on; o brotli on;. Controlla una risposta reale:

curl -I -H 'Accept-Encoding: br,gzip' https://example.com/app.js
curl -I -H 'Accept-Encoding: gzip' https://example.com/app.js

Cerca Content-Encoding: br o Content-Encoding: gzip. Mantieni anche Vary: Accept-Encoding sulle risposte che potrebbero essere memorizzate nella cache da una CDN o proxy condiviso, in modo che le varianti compresse e non compresse non vengano mescolate.

2. Evita la Sovra-compressione

Non impostare mai gzip_comp_level o brotli_comp_level troppo alti (ad esempio, 9 o 11) a meno che il tuo server non sia gravemente sottoutilizzato. Il guadagno marginale nella riduzione della dimensione del file raramente giustifica i cicli CPU extra richiesti per il calcolo.

3. Memorizza nella Cache i File Precompressi

Per Brotli, usare brotli_static on; e pre-comprimere le tue risorse statiche è il più grande guadagno di prestazioni singolo. Questo sposta il carico della CPU dal momento della richiesta al momento della distribuzione.

4. Testa la Tua Configurazione

Dopo aver modificato la tua configurazione Nginx, testa sempre la sintassi prima di ricaricare:

sudo nginx -t

Se ha successo, ricarica Nginx per applicare le modifiche:

sudo systemctl reload nginx

Puoi anche usare gli strumenti per sviluppatori del browser o servizi di test delle prestazioni per confermare che le risposte vengano servite con Content-Encoding: gzip o Content-Encoding: br.

Un Modo Pratico per Implementare Questo

Inizia con Gzip se il sito non ha alcuna compressione. È integrato nella maggior parte dei pacchetti Nginx e ti dà una base di partenza rapida. Poi aggiungi Brotli una volta che hai confermato il supporto del modulo e hai un modo per generare file .br per le risorse statiche durante la distribuzione.

Per un sito React, Vue o di documentazione statica, la configurazione migliore è solitamente file .br e .gz precompressi per le risorse buildate, compressione dinamica moderata per HTML e risposte API, e una configurazione CDN che rispetti Accept-Encoding. Per una piccola API che opera vicino ai limiti della CPU, un livello Gzip conservativo potrebbe essere la mossa migliore iniziale.

Il vantaggio non sono solo file più piccoli. Una buona compressione mantiene la larghezza di banda bassa, aiuta le connessioni client più lente e rimuove il tempo di trasferimento non necessario senza modificare il codice dell'applicazione. La disciplina principale è testare le intestazioni, evitare di comprimere media già compressi e mantenere i livelli di compressione abbastanza modesti da permettere al tuo server di respirare ancora durante i picchi di traffico.