compression-normalize: NGINX Accept-Encoding Normalisierungsmodul
Installation
Sie können dieses Modul in jeder RHEL-basierten Distribution installieren, einschließlich, aber nicht beschränkt auf:
- RedHat Enterprise Linux 7, 8, 9 und 10
- CentOS 7, 8, 9
- AlmaLinux 8, 9
- Rocky Linux 8, 9
- Amazon Linux 2 und Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-compression-normalize
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-compression-normalize
Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:
load_module modules/ngx_http_compression_normalize_module.so;
Dieses Dokument beschreibt nginx-module-compression-normalize v1.0.0 veröffentlicht am 06. Januar 2026.
Beschreibung
ngx_http_compression_normalize_module ist ein NGINX-Modul, das entwickelt wurde, um die Accept-Encoding-Header von Client-Anfragen zu parsen, zu normalisieren und zu verwalten. Es gewährleistet eine konsistente Handhabung von Kompressionsalgorithmen, indem es die Accept-Encoding-Werte standardisiert, was eine bessere Verwaltung der Kompression und eine verbesserte Leistung des Vary-Caches ermöglicht.
Zusammenfassung
http {
compression_normalize_accept_encoding gzip,br,zstd gzip,br zstd br gzip;
server {
listen 80;
server_name example.com;
location / {
# Ihre Konfigurationen
}
}
}
Direktiven
compression_normalize_accept_encoding
Syntax: compression_normalize_accept_encoding combinations1 [combinations2 ..] | off;
Standard: compression_normalize_accept_encoding off;
Kontext: http, server, location
Aktiviert die Normalisierung des Accept-Encoding-Headers, indem bevorzugte Kombinationen von Kompressionsalgorithmen angegeben werden. Diese Direktive akzeptiert eine Liste von Kompressionsmethoden und ermöglicht es, die Reihenfolge und Priorität der Kodierungstypen zu definieren, die der Server bei der Beantwortung von Client-Anfragen bevorzugen sollte.
Zum Beispiel, mit der folgenden Konfiguration
compression_normalize_accept_encoding gzip,br,zstd gzip,br zstd br gzip;
Wenn der Anfrage-Header Accept-Encoding gleichzeitig gzip, br und zstd enthält, ist der Wert des standardisierten Accept-Encoding-Headers gzip,br,zstd. Wenn die obigen Bedingungen nicht erfüllt sind, der Anfrage-Header jedoch gzip und br enthält, ist der Wert des standardisierten Accept-Encoding-Headers gzip,br. Und so weiter, bis alle Kombinationen, die durch die Direktive compression_normalize_accept_encoding angegeben sind, überprüft wurden. Wenn zu diesem Zeitpunkt keine Kombination getroffen wird, wird der Accept-Encoding-Header direkt gelöscht.
Ein Wert von off deaktiviert diese Funktion.
Variablen
\$compression_original_accept_encoding
beinhält den ursprünglichen Wert des Anfrage-Accept-Encoding-Headers.
GitHub
Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub Repository für nginx-module-compression-normalize.