Pular para conteúdo

compression-vary: Manipulação aprimorada do cabeçalho Vary para compressão

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-compression-vary
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-vary

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

load_module modules/ngx_http_compression_vary_filter_module.so;

Este documento descreve o nginx-module-compression-vary v0.2.0 lançado em 02 de março de 2026.


Sinopse

server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        gzip on;
        compression_vary on;

        proxy_pass http://foo.com;
    }
}

Diretivas

compression_vary

Sintaxe: compression_vary on | off;

Padrão: compression_vary off;

Contexto: http, server, location

Habilita ou desabilita a inserção do campo de cabeçalho de resposta Vary: Accept-Encoding se as diretivas gzip, gzip_static ou gunzip estiverem ativas.

Ao contrário de gzip_vary, se um cabeçalho Vary existir para a resposta original, ele irá adicionar o Accept-Encoding ao cabeçalho Vary original. Além disso, múltiplos cabeçalhos Vary serão mesclados em um só e separados por vírgulas. Valores de cabeçalho duplicados em Vary serão removidos.

Este módulo também é eficaz quando as diretivas de módulos de compressão de terceiros, como brotli, brotli_static, unbrotli, zstd, zstd_static e unzstd, estão ativadas.

GitHub

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