blog
WordPress

Brotli ou gzip: o comando curl que mostra qual o site usa

O cabeçalho content-encoding responde em uma linha, e o número do gzip mostra por que perseguir Brotli raramente paga a hora de agência.

JR · · 7 min de leitura · 1 tabela · 5 blocos de código

Resposta curta: um comando resolve: `curl -sI -H 'Accept-Encoding: br, gzip' https://seusite.com.br/ | grep -i content-encoding`. Se voltar `br`, é Brotli; `gzip`, é gzip; nada, o HTML sai sem compressão. Medimos uma página WordPress real: gzip levou o HTML de 464 KB para 58 KB, 8× menos bytes.

Neste artigo
  1. O comando curl que responde em uma linha
  2. Por que 464 KB viram 58 KB só com gzip
  3. Como auditar a compressão de toda a carteira de uma vez
  4. Por que o servidor devolve gzip mesmo quando você pede br
  5. Quando vale mexer na compressão e quando vale parar
  6. A resposta pronta para o cliente que viu "ativar compactação de texto" no PageSpeed
  7. Checklist de auditoria de compressão para reaproveitar por trimestre

O comando curl que responde em uma linha

Pedir as duas codificações e ler só o cabeçalho de resposta:

curl -sI -H 'Accept-Encoding: br, gzip' https://exemplo.com.br/ | grep -i content-encoding

Saídas possíveis:

Um detalhe que derruba muito diagnóstico: curl sozinho não envia Accept-Encoding. Sem o -H, o servidor devolve texto puro e você conclui que não há compressão nenhuma. O navegador sempre envia, por isso o PageSpeed enxerga uma coisa e o seu terminal outra.

Se quiser confirmar que o corpo realmente chega comprimido (e não só o cabeçalho anunciando):

curl -s -o /dev/null -w '%{size_download}\n' -H 'Accept-Encoding: br, gzip' https://exemplo.com.br/
curl -s -o /dev/null -w '%{size_download}\n' -H 'Accept-Encoding: identity' https://exemplo.com.br/

size_download é o número de bytes que saíram do fio, antes de qualquer descompressão. A primeira linha é o que o visitante baixa. A segunda é o tamanho cru.

8× redução do peso do HTML de uma página WordPress real ao ativar compressão gzip nível 6 (464 KB sem compressão contra 58 KB comprimidos, 87% menos bytes) 100 amostras · setembro de 2026 · medido pela Napoleon Host

Por que 464 KB viram 58 KB só com gzip

Medimos uma página WordPress real servida com gzip nível 6: 464 KB de HTML sem compressão contra 58 KB comprimidos. 87% menos bytes, 8× menos. Foram 100 requisições em setembro de 2026, o mesmo arquivo com e sem compressão.

Esse é o salto que importa. HTML de WordPress é repetitivo por natureza (classes de tema, markup de blocos, atributos de plugin), e qualquer compressor baseado em DEFLATE já come essa redundância quase toda.

O que não medimos: o mesmo HTML comprimido em Brotli. Não temos medição própria disso, então não vamos afirmar nenhum delta de Brotli contra gzip como número nosso. O que dá para dizer com honestidade é a forma da curva: sair de 464 KB para 58 KB é um salto de ordem de grandeza; sair de 58 KB para algum valor menor é uma fração desses 58 KB, não dos 464 KB originais. A decisão de agência tem que ser tomada sobre a segunda cena, não sobre a primeira.

Como auditar a compressão de toda a carteira de uma vez

Um arquivo sites.txt com um domínio por linha, e o loop:

while read -r host; do
  enc=$(curl -sI -m 10 -H 'Accept-Encoding: br, gzip' "https://$host/" \
        | grep -i '^content-encoding:' | tr -d '\r' | awk '{print $2}')
  printf '%-35s %s\n' "$host" "${enc:-SEM-COMPRESSAO}"
done < sites.txt

Saída típica:

cliente-a.com.br                    br
cliente-b.com.br                    gzip
loja-cliente-c.com.br               SEM-COMPRESSAO
blog-cliente-d.com.br               gzip

Rode isso uma vez por trimestre e guarde a saída. O -m 10 limita cada domínio a dez segundos no pior caso, então o lote inteiro tem teto previsível, e é o único relatório de compressão que você precisa ter.

Duas armadilhas na leitura do lote:

Por que o servidor devolve gzip mesmo quando você pede br

Você mandou br, gzip e voltou gzip. Três causas, em ordem de frequência prática:

Causa Como confirmar O que fazer
Brotli não está instalado/ativo no servidor web curl -sI em um .css do mesmo domínio também volta gzip Pedir ao provedor, ou aceitar o gzip e seguir
Proxy, WAF ou CDN no meio reescreve a negociação Cabeçalhos cf-*, x-cache, via, server apontando para um intermediário Ajustar na camada de borda, não na origem
HTML sai por uma camada diferente dos estáticos .css volta br e o HTML volta gzip Compressão do HTML está em outro ponto do stack (cache de página, PHP-FPM, plugin)

Para separar o terceiro caso, compare as duas respostas lado a lado:

for u in https://exemplo.com.br/ https://exemplo.com.br/wp-includes/css/dist/block-library/style.min.css; do
  echo "== $u"
  curl -sI -H 'Accept-Encoding: br, gzip' "$u" | grep -iE 'content-encoding|x-cache|server|via'
done

Diferença entre as duas linhas de content-encoding quase sempre significa que o HTML está sendo entregue por um cache de página que grava o arquivo já comprimido em gzip e o devolve como está. Nesse cenário, ligar Brotli no servidor web não muda o HTML. Muda os estáticos, que normalmente já estão em CDN.

E lembre que Brotli em HTTP só é negociado sobre HTTPS na prática dos navegadores. Site ainda em HTTP vai cair em gzip sempre, e o problema real dele não é compressão.

Quando vale mexer na compressão e quando vale parar

O teto de qualquer conversa sobre compressão de HTML, no caso que medimos, são os 58 KB que sobraram depois do gzip. Tudo que Brotli pode fazer acontece dentro desse orçamento. Antes de abrir chamado, de trocar de plano ou de pedir recompilação de módulo, passe pela ordem abaixo.

HTML sem compressão nenhuma é o conserto que vale a hora

Se o content-encoding não aparece com Accept-Encoding: br, gzip, você está no cenário dos 464 KB. Esse é o conserto de maior retorno do artigo inteiro e não custa nada: é configuração.

Servidor próprio com gzip: ative Brotli e meça o seu HTML

Se você administra o servidor e o módulo está a um comando de distância, ative. É barato. Depois meça o seu próprio HTML com o size_download da primeira seção, com br e com gzip, no mesmo arquivo. Você terá um número seu para esse site. Não aceite o número de ninguém como se fosse o do seu cliente: o ganho depende do markup.

Servidor de terceiro com gzip: registre como resolvido e siga

Hospedagem compartilhada, Brotli indisponível, gzip funcionando. Abrir ticket, insistir, migrar o site inteiro para perseguir a fração que sobra dos 58 KB não paga a hora de agência. Registre no relatório que a compressão está ativa, cite o cabeçalho content-encoding: gzip como prova e vá para o próximo item.

O que pesa mais que 58 KB de HTML na mesma página

Na página que medimos, o HTML comprimido são 58 KB. Uma única foto de banner não otimizada costuma ser maior que isso sozinha, e imagem não se beneficia de Brotli nem de gzip. Se você tem uma hora para gastar em peso de página, o inventário de imagens, de fontes e de scripts de terceiros rende mais que o compressor.

A resposta pronta para o cliente que viu "ativar compactação de texto" no PageSpeed

O cliente manda o print com a auditoria "ativar compactação de texto" e pergunta por que a agência não fez. O relatório não pede Brotli em nenhum momento: ele checa se o texto sai comprimido, e gzip satisfaz isso. Responda com o cabeçalho na mão:

Se o relatório apontar compressão ausente de verdade, a frase é outra e mais curta: "confirmei, o HTML está saindo sem compressão. É configuração de servidor, já estou resolvendo, e a referência de ganho vem de uma página WordPress que medimos, onde o HTML caiu 8×; no seu site o número pode ser outro."

De qualquer forma, mostre a linha do curl. Print de cabeçalho encerra discussão melhor que explicação.

Checklist de auditoria de compressão para reaproveitar por trimestre

O resumo operacional: gzip ligado é a decisão que vale 8× no HTML, e ela já está tomada na maioria dos servidores modernos. Brotli é um ajuste fino. Trate como ajuste fino, inclusive no tempo que você cobra por ele.

Como medimos

100 requisições HTTPS à mesma página WordPress em produção confirmaram o tamanho servido sem compressão (mediana de 464.173 bytes, sem cabeçalho content-encoding). O mesmo HTML baixado foi comprimido com gzip nível 6, resultando em 57.635 bytes. A comparação é determinística: mesmo arquivo, com e sem compressão.

Leia também