Server & Konfiguration

Gzip und Brotli aktivieren: Komprimierung in nginx und Apache einrichten

Veröffentlicht am 13. Oktober 2026

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

GzipBrotli
Kennung im Headergzipbr
Standardseit Jahrzehnten etabliertRFC 7932
Stufen1–90–11
Kompressiongutbei Textdateien in der Regel besser
Geschwindigkeitschnellhohe Stufen sehr langsam, mittlere Stufen schnell
Browserpraktisch allealle 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.

KomprimierenNicht komprimieren
HTML, CSS, JavaScriptJPEG, PNG, WebP, AVIF, GIF
JSON, XML, RSSMP4, WebM, MP3
SVGWOFF2
TXT, ICOZIP, 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;
DirektiveStandardErklärung
gzipoffSchaltet die Komprimierung ein
gzip_comp_level1Stufe 1–9; mittlere Werte sind ein guter Kompromiss
gzip_min_length20Sehr kleine Antworten lohnen sich nicht
gzip_varyoffSetzt Vary: Accept-Encoding
gzip_proxiedoffKomprimiert auch Antworten auf Anfragen über Proxies
gzip_typestext/htmlWeitere 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.

Erzeugen lassen sich die Dateien mit den Kommandozeilen-Tools gzip -k -9 und brotli -k -q 11 oder automatisch im Build-Prozess.

Erfolg kontrollieren

  1. Browser: In den Chrome DevTools unter Network die Spalte «Content-Encoding» einblenden (Rechtsklick auf den Spaltenkopf). Dort sehen Sie br oder gzip.
  2. Kommandozeile:
    curl -s -o /dev/null -D - -H "Accept-Encoding: br, gzip" https://www.example.ch/
    Achten Sie auf content-encoding und vary im Ergebnis.
  3. 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

Komprimierung wirkt am besten zusammen mit gutem Browser-Caching und einem modernen Protokoll wie HTTP/3.

Weitere Artikel zum Thema