Zum Inhalt

unzstd: Dekomprimiert Zstd-codierte Antworten für Clients, die dies nicht unterstützen

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-unzstd
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-unzstd

Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:

load_module modules/ngx_http_unzstd_filter_module.so;

Dieses Dokument beschreibt nginx-module-unzstd v0.1.0 veröffentlicht am 06. Januar 2026.


server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        # zstd-Dekompression für Clients aktivieren, die zstd-Kompression nicht unterstützen
        unzstd on;

        proxy_pass http://foo.com;
    }
}

Direktiven

unzstd

Syntax: unzstd on | off;

Standard: unzstd off;

Kontext: http, server, location

Aktiviert oder deaktiviert die Dekompression von zstd-komprimierten Antworten für Clients, die keine zstd-Unterstützung haben.

unzstd_force

Syntax: unzstd_force string ...;

Standard: -

Kontext: http, server, location

Definiert die Bedingungen für die erzwungene Brotli-Dekompression. Wenn mindestens ein Wert im String-Parameter nicht leer und nicht gleich "0" ist, wird die erzwungene zstd-Dekompression durchgeführt. Es wird jedoch nicht versucht, Antworten zu dekomprimieren, die nicht den Antwortheader Content-Encoding: zstd enthalten.

unzstd_buffers

Syntax: unzstd_buffers number size;

Standard: unzstd_buffers 32 4k | 16 8k;

Kontext: http, server, location

Legt die Anzahl und Größe der Puffer fest, die zur Dekompression einer Antwort verwendet werden. Standardmäßig ist die Puffergröße gleich einer Speicherseite. Dies sind entweder 4K oder 8K, abhängig von der Plattform.

GitHub

Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-unzstd.