Brotli ou gzip: descubra em dois comandos o que seu site envia
Dois comandos curl (ou a aba Rede do Chrome) mostram qual compressão chegou ao navegador e quantos bytes cada uma gastou. E três armadilhas que fazem o teste devolver resposta errada.

Resposta curta: Peça a mesma URL duas vezes com `Accept-Encoding` diferente e leia o cabeçalho `Content-Encoding` da resposta: `br` é Brotli, `gzip` é gzip, ausente é sem compressão. Comparar os bytes das duas respostas mostra quantos KB o Brotli economiza no seu HTML.
Neste artigo
O que o cabeçalho `Content-Encoding` responde
Quando o navegador pede uma página, ele manda um cabeçalho dizendo quais compressões aceita (Accept-Encoding: gzip, deflate, br). O servidor escolhe uma e avisa na resposta qual usou, no cabeçalho Content-Encoding. É esse cabeçalho, e só ele, que diz o que chegou de fato:
Content-Encoding: brsignifica Brotli.Content-Encoding: gzipsignifica gzip.- Nenhum
Content-Encodingsignifica que aquele recurso veio sem compressão.
Saber se existe compressão é uma pergunta. Qual das duas chegou, e quantos KB a diferença representa no seu HTML, é outra. O segundo número ninguém pode te dar de fora, porque depende do seu tema, dos seus plugins e do tamanho do seu HTML. Você mede no seu site, em dois comandos.
Dois pré-requisitos antes de testar. Primeiro: os navegadores só enviam br no Accept-Encoding em conexões HTTPS. Se o site responde em HTTP puro, o navegador nunca vai pedir Brotli e o teste não significa nada. Segundo: no cPanel, o Brotli vem do módulo mod_brotli do Apache, que a documentação da cPanel descreve como um módulo do EasyApache 4. Se ele não estiver instalado no servidor, nenhuma configuração dentro do WordPress faz Brotli aparecer.
Medir sem terminal, pela aba Rede do Chrome
Dá o mesmo dado e não exige nada instalado.
1. Abra a página e o DevTools
Abra seu site no Chrome, pressione F12 e clique na aba Network (Rede).
2. Recarregue ignorando o cache
Com o DevTools aberto, pressione Ctrl+Shift+R (ou Cmd+Shift+R no Mac). Sem isso, o Chrome pode servir a resposta guardada e você vai ler um cabeçalho antigo.
3. Clique na primeira linha da lista
É o documento HTML, normalmente com o nome do domínio ou uma barra. No painel que abre, vá em Headers e role até Response Headers. Procure a linha content-encoding.
4. Leia o tamanho na coluna Size
A coluna Size mostra dois valores empilhados: em cima, o que trafegou pela rede (comprimido); embaixo, o tamanho depois de descomprimir. A diferença entre os dois é o que a compressão economizou naquela requisição.
O limite desse método: ele mostra o que o seu navegador negociou, não o que o servidor faria com outra negociação. Para comparar gzip contra Brotli no mesmo arquivo, o terminal é mais direto.
Os dois comandos que comparam gzip e Brotli
São duas requisições para a mesma URL, mudando só o Accept-Encoding. Troque exemplo.com.br pelo seu domínio.
curl -s -o /dev/null \
-H 'Accept-Encoding: gzip' \
-w 'bytes: %{size_download}\n' \
https://exemplo.com.br/
Linha a linha: -s cala a barra de progresso, -o /dev/null descarta o conteúdo (você quer o número, não o HTML), -H envia o cabeçalho fingindo um navegador que só aceita gzip, e -w 'bytes: %{size_download}\n' imprime quantos bytes vieram pela rede, já comprimidos. Esse comando não diz qual codificação voltou: isso sai do comando com -I logo abaixo.
Para ver também qual codificação voltou, peça os cabeçalhos:
curl -sI -H 'Accept-Encoding: gzip' https://exemplo.com.br/ | grep -i -E 'content-encoding|vary'
curl -sI -H 'Accept-Encoding: br' https://exemplo.com.br/ | grep -i -E 'content-encoding|vary'
Resultado esperado em um servidor com os dois módulos ativos: a primeira linha devolve content-encoding: gzip e a segunda devolve content-encoding: br. Se as duas devolverem gzip, o Brotli não está disponível para esse recurso. Se nenhuma devolver nada, não há compressão no HTML e o problema a resolver é outro, anterior a este artigo.
Agora o número que interessa, o tamanho de cada variante:
for enc in gzip br; do
echo -n "$enc: "
curl -s -o /dev/null -H "Accept-Encoding: $enc" \
-w '%{size_download} bytes\n' https://exemplo.com.br/
done
Saída esperada: duas linhas, uma para cada codificação, com os bytes recebidos. A subtração entre elas é o ganho do Brotli naquele HTML, naquele momento. Anote o resultado antes de mexer em qualquer coisa, porque é a sua linha de base.
Como ler o que voltou
| O que o teste mostrou | Leitura | O que fazer |
|---|---|---|
br com Accept-Encoding: br e gzip com gzip |
Servidor negocia as duas, Brotli ativo | Nada. Já está no melhor cenário |
gzip nas duas requisições |
Brotli indisponível para esse recurso | Verificar se mod_brotli está instalado no EasyApache 4 |
Sem Content-Encoding nas duas |
HTML sem compressão | Resolver a compressão básica antes de pensar em Brotli |
br nas duas, inclusive quando você só pediu gzip |
Algo na frente está reescrevendo a resposta | Investigar CDN ou proxy |
| Bytes praticamente iguais nas duas | Arquivo já comprimido ou muito pequeno | Testar em um CSS ou JS grande |
Três coisas que fazem o teste mentir
CDN ou proxy na frente
Se há Cloudflare, outro CDN ou um proxy reverso entre você e o servidor, quem responde ao curl é a borda, não o Apache. A borda pode comprimir por conta própria, guardar uma variante em cache e devolver a mesma para todo mundo. Você estará medindo a política do CDN, não a do seu servidor. Para separar os dois, repita o teste apontando direto para o IP de origem (se você tiver esse acesso) ou use um hostname que não passe pelo CDN.
Arquivo que já é comprimido
JPG, PNG, WebP, PDF, ZIP e MP4 já carregam compressão interna. As fontes web também: WOFF usa zlib e WOFF2 usa Brotli dentro do próprio arquivo, então gzip ou Brotli por cima não tiram quase nada. Rodar gzip ou Brotli em cima de qualquer um desses devolve uma diferença de bytes que é ruído, e às vezes o arquivo fica maior. Compare Brotli e gzip em HTML, CSS, JS, SVG e JSON. Nos demais, a resposta correta do servidor é não comprimir.
Cache servindo a variante errada
Se a resposta não trouxer Vary: Accept-Encoding, qualquer cache no caminho (navegador, proxy, plugin de cache de página) pode guardar a versão Brotli e entregá-la a um cliente que pediu só gzip, ou o contrário. Por isso o grep acima procura também por vary. A presença desse cabeçalho é o que autoriza o cache a manter uma cópia por codificação. No navegador, o Ctrl+Shift+R contorna o problema no seu lado, mas não corrige o cabeçalho ausente.
Quando trocar vale e quando não vale
O critério honesto é o tamanho absoluto da economia, não o percentual.
Se o seu HTML sai em algumas dezenas de KB com gzip, o Brotli vai tirar alguns KB a mais. Em uma conexão doméstica comum, isso não é o que decide o tempo de carregamento da página; a fila de requisições, o tempo de resposta do PHP e as imagens pesam mais. Nesse cenário, desativar algo que funciona para ganhar poucos KB é risco sem retorno.
Onde o Brotli pesa de verdade é em arquivos estáticos grandes e repetitivos: o CSS do tema, os bundles de JavaScript de construtores de página, bibliotecas inteiras servidas sem minificação. Rode o mesmo par de comandos apontando para a URL de um .css ou .js do seu tema e compare. Se a diferença ali for de dezenas de KB por visita nova, o argumento muda de figura.
Um detalhe que a documentação da cPanel sobre o módulo Brotli deixa claro: trata-se de um módulo do Apache no EasyApache 4, instalado no nível do servidor. Em hospedagem compartilhada, quem decide isso é o provedor, não o painel do seu site. Antes de instalar plugin de otimização prometendo Brotli, teste com os comandos acima: se o Content-Encoding já volta br, o plugin não tem nada a acrescentar nesse ponto.
Checklist antes de mexer em qualquer coisa
- Confirme que o site responde em HTTPS, senão o navegador nunca pedirá Brotli.
- Rode o par de
curle anote os dois tamanhos em bytes. Essa é a linha de base. - Repita em um CSS ou JS grande do tema, não só no HTML.
- Verifique se
Vary: Accept-Encodingaparece na resposta. - Se houver CDN, teste também fora dele antes de concluir qualquer coisa sobre o servidor.
- Se for alterar configuração de compressão por
.htaccessou por plugin, faça backup do arquivo e do site antes. Para voltar atrás, basta restaurar o.htaccessanterior ou desativar o plugin pelo painel do WordPress. - Depois de qualquer mudança, rode os mesmos comandos de novo e compare com o tamanho em bytes que você anotou no par de
curl.
Sem o tamanho anotado antes da mudança, qualquer alteração vira fé. Com ele, você tem dois números do seu próprio site e sabe exatamente o que mudou.
Referências
- Documentação oficial (cpanel) — Apache Module: Brotli. Consultado em 2026-09-15.