# 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.

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

João Rizzon · 2026-10-03 · WordPress

---

## 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: br` significa Brotli.
- `Content-Encoding: gzip` significa gzip.
- Nenhum `Content-Encoding` significa 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](https://docs.cpanel.net/ea4/apache/apache-modules/apache-module-brotli/) 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.

```bash
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:

```bash
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:

```bash
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](https://docs.cpanel.net/ea4/apache/apache-modules/apache-module-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 `curl` e 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-Encoding` aparece 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 `.htaccess` ou por plugin, faça backup do arquivo e do site antes. Para voltar atrás, basta restaurar o `.htaccess` anterior 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.

