Aller au contenu

unzstd: Décompresse les réponses encodées en Zstd pour les clients qui ne le supportent pas

Installation

Vous pouvez installer ce module dans n'importe quelle distribution basée sur RHEL, y compris, mais sans s'y limiter :

  • RedHat Enterprise Linux 7, 8, 9 et 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 et 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

Activez le module en ajoutant ce qui suit en haut de /etc/nginx/nginx.conf :

load_module modules/ngx_http_unzstd_filter_module.so;

Ce document décrit nginx-module-unzstd v0.1.0 publié le 06 janvier 2026.


server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        # activer la décompression zstd pour les clients qui ne supportent pas la compression zstd
        unzstd on;

        proxy_pass http://foo.com;
    }
}

Directives

unzstd

Syntaxe : unzstd on | off;

Par défaut : unzstd off;

Contexte : http, server, location

Active ou désactive la décompression des réponses compressées en zstd pour les clients qui ne supportent pas zstd.

unzstd_force

Syntaxe : unzstd_force string ...;

Par défaut : -

Contexte : http, server, location

Définit les conditions pour une décompression brotli forcée. Si au moins une valeur dans le paramètre string n'est pas vide et n'est pas égale à "0", une décompression zstd forcée est effectuée. Mais il ne tentera pas de décompresser les réponses qui ne contiennent pas l'en-tête de réponse Content-Encoding: zstd.

unzstd_buffers

Syntaxe : unzstd_buffers number size;

Par défaut : unzstd_buffers 32 4k | 16 8k;

Contexte : http, server, location

Définit le nombre et la taille des buffers utilisés pour décompresser une réponse. Par défaut, la taille du buffer est égale à une page mémoire. Cela correspond soit à 4K soit à 8K, selon la plateforme.

GitHub

Vous pouvez trouver des conseils de configuration supplémentaires et de la documentation pour ce module dans le dépôt GitHub pour nginx-module-unzstd.