Gzip und Brotli aktivieren: Komprimierung in nginx und Apache einrichten
Schritt für Schritt Gzip und Brotli in nginx und Apache aktivieren: passende Kompressionsstufen, MIME-Typen, vorkomprimierte Dateien und Erfolgskontrolle.
Textdateien wie HTML, CSS, JavaScript, JSON und SVG lassen sich hervorragend komprimieren. Der Server packt sie vor dem Versand, der Browser entpackt sie nach dem Empfang. So werden deutlich weniger Daten übertragen, und die Seite lädt schneller. Fast alle Browser unterstützen die beiden Verfahren Gzip und Brotli. In diesem Artikel erfahren Sie, wie die Komprimierung funktioniert, welche Stufen sinnvoll sind und wie Sie sie in nginx und Apache korrekt einrichten.
So funktioniert HTTP-Komprimierung
Der Browser teilt dem Server im Header Accept-Encoding mit, welche Verfahren er beherrscht, zum Beispiel:
Accept-Encoding: gzip, deflate, br, zstd
Der Server wählt ein Verfahren, komprimiert die Antwort und kennzeichnet sie mit Content-Encoding: br oder Content-Encoding: gzip. Zusätzlich sollte er den Header Vary: Accept-Encoding senden. Dieser sagt Caches und CDNs, dass es je nach Browser unterschiedliche Varianten derselben Datei gibt.
Gzip und Brotli im Vergleich
| Gzip | Brotli | |
|---|---|---|
| Kennung im Header | gzip | br |
| Standard | seit Jahrzehnten etabliert | RFC 7932 |
| Stufen | 1–9 | 0–11 |
| Kompression | gut | bei Textdateien in der Regel besser |
| Geschwindigkeit | schnell | hohe Stufen sehr langsam, mittlere Stufen schnell |
| Browser | praktisch alle | alle aktuellen Browser, in der Regel nur über HTTPS angeboten |
Brotli ist bei gleicher Geschwindigkeit meist effizienter. Die Apache-Dokumentation hält zum Beispiel fest, dass Brotli-Stufe 4 ungefähr Gzip-Stufe 6 entspricht. Die Höchststufe 11 erzielt die beste Kompression, ist aber sehr langsam und laut Apache-Dokumentation nur zusammen mit Caching sinnvoll.
Die beste Lösung ist meist: beide Verfahren aktivieren. Browser, die Brotli unterstützen, erhalten Brotli, alle anderen Gzip.
Was Sie nicht komprimieren sollten
JPEG, PNG, WebP, AVIF, MP4, WOFF2 und ZIP-Archive sind bereits komprimiert. Eine weitere Komprimierung kostet nur Rechenzeit und bringt keine Ersparnis. Beschränken Sie die Komprimierung deshalb auf Textformate.
| Komprimieren | Nicht komprimieren |
|---|---|
| HTML, CSS, JavaScript | JPEG, PNG, WebP, AVIF, GIF |
| JSON, XML, RSS | MP4, WebM, MP3 |
| SVG | WOFF2 |
| TXT, ICO | ZIP, GZ, PDF (meist bereits komprimiert) |
Gzip in nginx einrichten
Das Gzip-Modul ist in nginx standardmässig enthalten, aber ausgeschaltet (gzip off). Zudem komprimiert nginx ohne weitere Angaben nur text/html, und die Standardstufe ist 1. Eine bewährte Konfiguration im http-Block:
gzip on;
gzip_comp_level 5;
gzip_min_length 1000;
gzip_vary on;
gzip_proxied any;
gzip_types
text/plain text/css text/xml text/javascript
application/javascript application/json application/xml
application/rss+xml image/svg+xml;
| Direktive | Standard | Erklärung |
|---|---|---|
gzip | off | Schaltet die Komprimierung ein |
gzip_comp_level | 1 | Stufe 1–9; mittlere Werte sind ein guter Kompromiss |
gzip_min_length | 20 | Sehr kleine Antworten lohnen sich nicht |
gzip_vary | off | Setzt Vary: Accept-Encoding |
gzip_proxied | off | Komprimiert auch Antworten auf Anfragen über Proxies |
gzip_types | text/html | Weitere MIME-Typen; HTML wird immer komprimiert |
Nach der Änderung testen Sie die Konfiguration mit nginx -t und laden sie mit systemctl reload nginx neu.
Brotli in nginx einrichten
Brotli ist nicht Teil des offiziellen nginx-Quellcodes. Sie benötigen das Modul ngx_brotli. Viele Distributionen und das Repository von nginx bieten es als dynamisches Modul-Paket an; alternativ kompilieren Sie es selbst. Wichtig beim Selbstkompilieren: Ein dynamisches Modul muss mit denselben configure-Argumenten gebaut werden wie Ihr installiertes nginx (nginx -V zeigt sie), sonst startet nginx mit der Meldung «module is not binary compatible» nicht.
Module laden (ganz oben in nginx.conf, die Pfade hängen von Ihrer Installation ab):
load_module modules/ngx_http_brotli_filter_module.so;
load_module modules/ngx_http_brotli_static_module.so;
Konfiguration im http-Block:
brotli on;
brotli_comp_level 5;
brotli_static on;
brotli_types
text/plain text/css text/xml text/javascript
application/javascript application/json application/xml
application/rss+xml image/svg+xml;
Die Standardstufe von ngx_brotli ist 6, der zulässige Bereich 0–11. Wie bei Gzip wird text/html immer komprimiert.
Komprimierung in Apache einrichten
Apache bringt beide Verfahren als Module mit: mod_deflate für Gzip und mod_brotli (ab Apache 2.4.26) für Brotli. Unter Debian und Ubuntu aktivieren Sie sie mit:
a2enmod deflate brotli headers
systemctl reload apache2
Konfiguration in der Server- oder Virtual-Host-Konfiguration:
<IfModule mod_brotli.c>
AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript application/json application/xml image/svg+xml
BrotliCompressionQuality 5
</IfModule>
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json application/xml image/svg+xml
</IfModule>
Die Standardstufe von BrotliCompressionQuality ist 5, der Bereich 0–11. BrotliCompressionQuality ist nur in der Server- und Virtual-Host-Konfiguration erlaubt, nicht in .htaccess. Prüfen Sie nach der Einrichtung, dass Browser mit Brotli-Unterstützung tatsächlich Content-Encoding: br erhalten und ältere Clients weiterhin gzip.
Vorkomprimierte Dateien: maximale Kompression ohne Wartezeit
Bei dynamischer Komprimierung muss der Server jede Antwort neu packen. Für statische Dateien geht es effizienter: Sie erzeugen beim Deployment komprimierte Varianten (style.css.br, style.css.gz) mit der höchsten Stufe, und der Server liefert diese direkt aus.
- nginx:
gzip_static on;(Modulngx_http_gzip_static_module, muss beim Bau enthalten sein) undbrotli_static on; - Apache: über Rewrite-Regeln, wie in der Dokumentation zu
mod_brotlibeschrieben
Erzeugen lassen sich die Dateien mit den Kommandozeilen-Tools gzip -k -9 und brotli -k -q 11 oder automatisch im Build-Prozess.
Erfolg kontrollieren
- Browser: In den Chrome DevTools unter Network die Spalte «Content-Encoding» einblenden (Rechtsklick auf den Spaltenkopf). Dort sehen Sie
brodergzip. - Kommandozeile:
Achten Sie aufcurl -s -o /dev/null -D - -H "Accept-Encoding: br, gzip" https://www.example.ch/content-encodingundvaryim Ergebnis. - PageSpeed Insights: Der Hinweis zur Textkomprimierung sollte verschwinden.
Sicherheitshinweis
Die nginx-Dokumentation weist darauf hin, dass komprimierte Antworten über TLS für sogenannte BREACH-Angriffe anfällig sein können. Betroffen sind Seiten, die geheime Werte (etwa CSRF-Tokens) zusammen mit vom Angreifer beeinflussbaren Eingaben im selben Antworttext ausgeben. Moderne Frameworks schützen Tokens meist mit zusätzlichen Massnahmen. Bei eigenen Anwendungen mit sensiblen Formularen sollten Sie dies prüfen.
Checkliste
- Gzip aktiv, Stufe 4–6, MIME-Typen für CSS, JS, JSON, XML und SVG ergänzt
- Brotli zusätzlich aktiv (nginx-Modul oder
mod_brotli) -
Vary: Accept-Encodingwird gesendet - Bilder, Videos und Archive werden nicht erneut komprimiert
- Optional: vorkomprimierte
.br- und.gz-Dateien für statische Assets - Ergebnis mit DevTools oder
curlgeprüft
Komprimierung wirkt am besten zusammen mit gutem Browser-Caching und einem modernen Protokoll wie HTTP/3.