Pular para conteúdo

unbrotli: Descomprime respostas codificadas em Brotli 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-unbrotli

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

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

load_module modules/ngx_http_unbrotli_filter_module.so;

Este documento descreve o nginx-module-unbrotli v0.0.2 lançado em 18 de dezembro de 2024.

O ngx_unbrotli é um módulo de filtro que descomprime respostas codificadas com Brotli (Content-Encoding: br) para clientes que não suportam Brotli. Ao armazenar respostas no formato Brotli, você pode economizar em custos de armazenamento e I/O, e este módulo garante que clientes incapazes de lidar com Brotli ainda recebam o conteúdo descomprimido apropriado.

Exemplo de Configuração

location /storage/ {
    unbrotli on;
    unbrotli_buffers 32 4k;
    ...
}

Diretivas de Configuração

unbrotli

  • sintaxe: unbrotli on | off;
  • padrão: off
  • contexto: http, server, location

Habilita ou desabilita a descompressão de respostas comprimidas em Brotli (Content-Encoding: br) para clientes que não suportam Brotli. Quando unbrotli está habilitado, o servidor verifica as capacidades do cliente (semelhante a como o tratamento de gzip é feito) para determinar se a descompressão é necessária.

unbrotli_force

  • sintaxe: unbrotli_force on | off;
  • padrão: off
  • contexto: http, server, location

Força a descompressão de respostas comprimidas em Brotli, mesmo que o cliente indique suporte para Brotli. Quando unbrotli_force está on, todas as respostas codificadas em Brotli são descomprimidas antes de serem enviadas ao cliente, independentemente do cabeçalho Accept-Encoding do cliente.

unbrotli_buffers

  • sintaxe: unbrotli_buffers number size;
  • padrão: depende do tamanho da página do sistema, comumente: unbrotli_buffers 32 4k; ou unbrotli_buffers 16 8k;
  • contexto: http, server, location

Define o número e o tamanho dos buffers usados para descomprimir respostas Brotli. Normalmente, o tamanho é igual a uma página de memória (4 KB ou 8 KB, dependendo da plataforma). Aumentar o número ou o tamanho desses buffers pode melhorar o desempenho para respostas grandes à custa de um maior uso de memória.

GitHub

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