Pular para conteúdo

unzstd: Descomprime respostas codificadas em Zstd para clientes que não o suportam

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

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

Ative o módulo adicionando o seguinte no topo de /etc/nginx/nginx.conf:

load_module modules/ngx_http_unzstd_filter_module.so;

Este documento descreve nginx-module-unzstd v0.1.0 lançado em 06 de janeiro de 2026.

server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        # habilita a descompressão zstd para clientes que não suportam compressão zstd
        unzstd on;

        proxy_pass http://foo.com;
    }
}

Diretivas

unzstd

Sintaxe: unzstd on | off;

Padrão: unzstd off;

Contexto: http, server, location

Habilita ou desabilita a descompressão de respostas comprimidas em zstd para clientes que não possuem suporte a zstd.

unzstd_force

Sintaxe: unzstd_force string ...;

Padrão: -

Contexto: http, server, location

Define as condições para descompressão forçada em brotli. Se pelo menos um valor no parâmetro string não estiver vazio e não for igual a "0", a descompressão forçada em zstd é realizada. Mas não tentará descomprimir respostas que não contenham o cabeçalho de resposta Content-Encoding: zstd.

unzstd_buffers

Sintaxe: unzstd_buffers number size;

Padrão: unzstd_buffers 32 4k | 16 8k;

Contexto: http, server, location

Define o número e o tamanho dos buffers usados para descomprimir uma resposta. Por padrão, o tamanho do buffer é igual a uma página de memória. Isso é 4K ou 8K, dependendo da plataforma.

GitHub

Você pode encontrar dicas adicionais de configuração e documentação para este módulo no repositório do GitHub para nginx-module-unzstd.