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

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

João Rizzon · 2026-11-05 · WordPress

---

## O comando curl que responde em uma linha

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

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

Saídas possíveis:

- `content-encoding: br`: o servidor tem Brotli e escolheu Brotli.
- `content-encoding: gzip`: Brotli não está disponível nesse caminho, ou alguém no meio desfez a negociação.
- nenhuma linha: o HTML está saindo **sem compressão**. É o único caso que vale parar tudo e resolver hoje.

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):

```bash
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) (n=100, setembro de 2026)

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

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

- Teste a **URL final**, já com www ou sem, já em HTTPS. Um 301 responde com cabeçalho próprio e pode não carregar compressão. Com `-L` o curl segue o redirecionamento mantendo o HEAD, e alguns servidores respondem a HEAD de forma diferente do GET, inclusive omitindo `content-encoding`. Prefira acertar a URL final na lista, ou validar com GET usando `size_download`.
- Teste uma página de conteúdo, não só a home. Home costuma estar em cache de página; uma URL de post ou de categoria revela melhor o que a origem faz.

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

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

> **** O site já serve o HTML comprimido. Verifiquei agora: o servidor responde com `content-encoding: gzip`, que é exatamente a compressão de texto que o relatório pede. Em uma página WordPress que medimos, gzip reduziu o HTML de 464 KB para 58 KB, 8× menos dados trafegados. O Brotli é um compressor alternativo que pode economizar mais alguns KB sobre esses 58 KB já comprimidos, não sobre os 464 KB originais. Como o ganho restante é pequeno e depende do servidor, priorizei [imagens / scripts de terceiros / cache], que hoje pesam mais na página.

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

- [ ] Lista de domínios da carteira em `sites.txt`, com a URL canônica (HTTPS, com ou sem www, sem redirecionamento).
- [ ] Loop de `curl -sI -H 'Accept-Encoding: br, gzip'` rodado e saída salva com a data.
- [ ] Todo `SEM-COMPRESSAO` virou tarefa de configuração, com prazo.
- [ ] Todo `gzip` em servidor de terceiro foi registrado como **resolvido**, não como pendência.
- [ ] Para cada site onde você ativou Brotli, há uma medição sua de `size_download` com `br` e com `gzip` no mesmo HTML.
- [ ] HTML e um arquivo `.css` testados separadamente, para flagrar camadas diferentes servindo cada tipo.
- [ ] Peso das imagens da home comparado com o peso do HTML comprimido, antes de qualquer esforço extra em compressão.
- [ ] Frase pronta colada no modelo de resposta ao cliente, com o campo do cabeçalho a preencher.

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.
