Saltar a contenido

compression-vary: Manejo mejorado del encabezado Vary para compresión

Instalación

Puedes instalar este módulo en cualquier distribución basada en RHEL, incluyendo, entre otras:

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

Habilita el módulo agregando lo siguiente al inicio de /etc/nginx/nginx.conf:

load_module modules/ngx_http_compression_vary_filter_module.so;

Este documento describe nginx-module-compression-vary v0.2.0 publicado el 02 de marzo de 2026.


Sinopsis

server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        gzip on;
        compression_vary on;

        proxy_pass http://foo.com;
    }
}

Directivas

compression_vary

Sintaxis: compression_vary on | off;

Predeterminado: compression_vary off;

Contexto: http, server, location

Habilita o deshabilita la inserción del campo de encabezado de respuesta Vary: Accept-Encoding si las directivas gzip, gzip_static o gunzip están activas.

A diferencia de gzip_vary, si existe un encabezado Vary para la respuesta original, se agregará el Accept-Encoding al encabezado Vary original. Además, múltiples encabezados Vary se fusionarán en uno y se separarán por comas. Los valores de encabezado duplicados en Vary serán eliminados.

Este módulo también es efectivo cuando las directivas de módulos de compresión de terceros como brotli, brotli_static, unbrotli, zstd, zstd_static y unzstd están activadas.