unzstd: Descomprime respuestas codificadas en Zstd para clientes que no lo soportan
Instalación
Puedes instalar este módulo en cualquier distribución basada en RHEL, incluyendo, pero no limitado a:
- RedHat Enterprise Linux 7, 8, 9 y 10
- CentOS 7, 8, 9
- AlmaLinux 8, 9
- Rocky Linux 8, 9
- Amazon Linux 2 y 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
Habilita el módulo añadiendo lo siguiente en la parte superior de /etc/nginx/nginx.conf:
load_module modules/ngx_http_unzstd_filter_module.so;
Este documento describe nginx-module-unzstd v0.1.0 lanzado el 06 de enero de 2026.
server {
listen 127.0.0.1:8080;
server_name localhost;
location / {
# habilitar descompresión zstd para clientes que no soportan compresión zstd
unzstd on;
proxy_pass http://foo.com;
}
}
Directivas
unzstd
Sintaxis: unzstd on | off;
Por defecto: unzstd off;
Contexto: http, server, location
Habilita o deshabilita la descompresión de respuestas comprimidas en zstd para clientes que carecen de soporte para zstd.
unzstd_force
Sintaxis: unzstd_force string ...;
Por defecto: -
Contexto: http, server, location
Define las condiciones para la descompresión forzada de brotli. Si al menos un valor en el parámetro de cadena no está vacío y no es igual a "0", se realiza la descompresión forzada de zstd. Pero no intentará descomprimir respuestas que no contengan el encabezado de respuesta Content-Encoding: zstd.
unzstd_buffers
Sintaxis: unzstd_buffers number size;
Por defecto: unzstd_buffers 32 4k | 16 8k;
Contexto: http, server, location
Establece el número y el tamaño de los buffers utilizados para descomprimir una respuesta. Por defecto, el tamaño del buffer es igual a una página de memoria. Esto es 4K o 8K, dependiendo de la plataforma.
GitHub
Puedes encontrar consejos adicionales de configuración y documentación para este módulo en el repositorio de GitHub para nginx-module-unzstd.