# Gzip no WHM para todas as contas da revenda

Uma tela do WHM vale por dezenas de .htaccess. O que colocar na lista de MIME types, o que deixar de fora e como provar o ganho com curl no domínio do cliente.

> Ligue a compressão em WHM >> Server Configuration >> Tweak Settings >> aba Compression: troque o valor padrão `text/html` por uma lista com os tipos de texto (CSS, JS, SVG, JSON, XML) e deixe de fora JPG, PNG, WebP, PDF, ZIP, MP4 e WOFF2, que já nascem comprimidos.

João Rizzon · 2026-10-23 · Revenda

---

Quem administra uma revenda normalmente liga compressão site a site: plugin no WordPress, caixinha na Otimização de Website do cPanel, `.htaccess` copiado de um projeto para outro. Funciona, mas não escala. Em trinta contas, são trinta lugares para errar e trinta lugares para auditar quando o cliente reclama que o site está lento.

O WHM tem uma tela única que resolve isso no nível do servidor: **Server Configuration >> Tweak Settings >> aba Compression**. É ali que você define quais MIME types o Apache comprime na saída, para todas as contas de uma vez, sem tocar em nenhum `.htaccess`.

## O que a aba Compression do Tweak Settings controla

A documentação oficial do cPanel descreve a opção **Compress files of these MIME types** como a lista de tipos MIME que o servidor comprime, e indica o valor padrão `text/html` ([docs.cpanel.net, Tweak Settings - Compression](https://docs.cpanel.net/whm/server-configuration/tweak-settings/compression/)).

Traduzindo para o dia a dia: por padrão, o servidor comprime o HTML e mais nada. CSS, JavaScript, SVG e respostas JSON de API saem sem compressão, a menos que alguma conta tenha ligado por conta própria no `.htaccess` ou no plugin de cache.

Essa configuração escreve na camada do Apache, acima das contas. Ou seja: vale para todos os domínios hospedados, inclusive os que o cliente criou ontem e você nem viu ainda. É exatamente o comportamento que você quer em revenda, padrão bom por omissão.

Duas ressalvas antes de mexer:

- Se você não tem WHM root (revenda com acesso apenas de reseller), essa tela não aparece. Nesse caso o caminho é pedir ao provedor ou continuar no escopo da conta, via Otimização de Website no cPanel de cada uma.
- Um `.htaccess` de cliente pode sobrescrever ou duplicar regras de `mod_deflate`. Isso não quebra o site, mas atrapalha a auditoria. Trate como item de limpeza, não como bloqueio.

## Quais MIME types valem a CPU e quais só a desperdiçam

A regra é simples: comprima o que é texto, não comprima o que já nasce comprimido. JPG, PNG, WebP, PDF, ZIP e MP4 já têm compressão interna no próprio formato. Passar gzip neles gasta CPU no servidor, gasta CPU no navegador do visitante e devolve um arquivo praticamente do mesmo tamanho, às vezes maior.

| MIME type | O que é | Comprimir? |
|---|---|---||
| `text/html` | HTML das páginas | Sim |
| `text/css` | folhas de estilo | Sim |
| `application/javascript` | JS (tipo moderno) | Sim |
| `text/javascript` | JS (tipo legado, ainda servido por temas antigos) | Sim |
| `image/svg+xml` | SVG, que é XML | Sim |
| `application/json` | respostas da REST API, AJAX do admin | Sim |
| `text/xml` / `application/xml` | sitemap, feed RSS | Sim |
| `image/jpeg`, `image/png`, `image/webp` | imagens | Não |
| `application/pdf` | PDF | Não |
| `application/zip`, `application/gzip` | arquivos compactados | Não |
| `video/mp4` | vídeo | Não |
| `font/woff2` | fonte web | Não, WOFF2 já é comprimido |

O caso do WOFF2 engana muita gente que copia lista pronta da internet. O formato tem compressão Brotli embutida. Ligar gzip nele é trabalho dobrado para ganho nulo.

SVG é o oposto: parece imagem, mas é texto XML. Em site com muito ícone e logotipo vetorial, incluir `image/svg+xml` tende a render ganho relevante; confirme medindo o próprio arquivo SVG com o `curl` da seção de validação.

## Sete passos para ligar a compressão no servidor inteiro

### Meça o tamanho entregue hoje antes de mexer

Escolha dois ou três domínios representativos da revenda (um WordPress com page builder, um site institucional leve, um e-commerce se houver) e meça o tamanho entregue hoje. O comando está na seção seguinte. Sem o antes, você não tem o depois.

### Onde fica a aba Compression dentro do WHM

Se a busca da tela estiver disponível, digitar `compress` encontra a opção direto. Confirme o rótulo exato na [documentação oficial](https://docs.cpanel.net/whm/server-configuration/tweak-settings/compression/), que varia entre versões do cPanel & WHM.

### Troque text/html pela lista completa de tipos de texto

O campo começa com `text/html`. Acrescente os tipos da coluna "Sim" da tabela acima. Não inclua nenhum tipo de imagem binária, vídeo, PDF ou arquivo compactado.

### Salve e espere o Apache recarregar sozinho

A mudança passa a valer para todas as contas do servidor. Não é preciso editar `.htaccess` em conta nenhuma.

### Valide com curl em pelo menos três domínios diferentes

Um domínio só não prova nada: ele pode estar atrás de CDN, de plugin de cache ou de proxy que já comprimia. Teste um que esteja fora de qualquer camada intermediária.

### Procure regras duplicadas de mod_deflate nos .htaccess

Não é urgente, mas regra duplicada esconde problema. Em servidor com acesso SSH:

```
grep -rl "mod_deflate\|AddOutputFilterByType" /home/*/public_html/.htaccess
```

O comando lista os caminhos dos arquivos que contêm a diretiva. Decida caso a caso se remove ou deixa.

### Anote a data e a lista aplicada no runbook

Seis meses depois, quando um cliente perguntar por que o site dele comprime e o do concorrente não, você quer ter a resposta em um arquivo, não na memória.

## Como medir o antes e o depois com curl

A verificação é a mesma de sempre, só que agora você a repete em vários domínios para confirmar que a regra é global.

Primeiro, o tamanho **sem** pedir compressão:

```
curl -s -o /dev/null -w "%{size_download}\n" https://site-do-cliente.com.br/
```

Depois, o tamanho **com** o cabeçalho de aceite de compressão:

```
curl -s -H "Accept-Encoding: gzip" -o /dev/null -w "%{size_download}\n" https://site-do-cliente.com.br/
```

`%{size_download}` devolve bytes. Divida por 1024 para ter KB. Se os dois números forem iguais, a compressão não está sendo aplicada naquela resposta.

Para ver o cabeçalho que o servidor devolve, sem baixar o corpo:

```
curl -s -I -H "Accept-Encoding: gzip" https://site-do-cliente.com.br/ | grep -i "content-encoding\|content-type"
```

Você quer ler `content-encoding: gzip` (ou `br`, se houver Brotli na frente) junto do `content-type` correspondente. É assim que se confirma tipo a tipo: troque a URL pelo CSS principal, pelo JS do tema, por um SVG e por um endpoint `/wp-json/`.

### Quanto a página encolhe depende de quanto dela é texto

Não temos medição própria publicável para prever quanto a sua página vai encolher, e nem daria para prever: o resultado depende do quanto a página é HTML e texto puro contra o quanto já é imagem. Suponha uma página de 500 KB em que 400 KB são JPG de banner: a compressão atua sobre os 100 KB restantes e o total muda pouco. A mesma página sem as fotos pesadas encolhe bem mais. Por isso o número que importa é o do domínio do cliente, medido com os dois comandos `curl` da seção anterior, antes e depois. É também por isso que compressão e otimização de imagem são duas tarefas separadas, não uma.

## Por que compressão não substitui cache nem imagem otimizada

Compressão reduz bytes transferidos de arquivos de texto. Não reduz número de requisições, não reduz tempo de processamento do PHP e não encolhe imagem.

Se o cliente reclama de lentidão e a página pesa 3 MB sendo 2,7 MB de foto de banner, ligar gzip vai melhorar pouca coisa. O ganho real está em redimensionar a imagem e servir WebP. Vale dizer isso ao cliente mesmo quando a venda fácil seria outra: a compressão é ajuste de higiene, barato e permanente, não é o remédio para um site mal montado.

A ordem que costuma dar mais resultado por hora de trabalho:

- Compressão no servidor (uma vez, vale para todas as contas).
- Cache de página no WordPress.
- Imagens redimensionadas e em formato moderno.
- Limpeza de plugin que injeta CSS e JS em página que não usa.

## Como explicar a mudança para o cliente final

O cliente não quer saber de MIME type. Ele quer saber o que mudou e o que isso faz por ele. Uma versão que funciona em e-mail e em reunião:

> **** "Ativamos a compressão no servidor que hospeda o seu site. Na prática, o código da página passou a ser enviado compactado para o navegador do visitante, como um arquivo zipado que se abre sozinho do outro lado. O conteúdo é exatamente o mesmo, só trafega menos dado, o que deixa o carregamento mais rápido principalmente para quem acessa pelo celular com internet fraca. Não é preciso mexer em nada no site."

Se o cliente for mais técnico ou pedir prova, mande os dois números de `size_download` do próprio domínio dele, em KB, com a data. Dois números e uma frase resolvem a conversa melhor que um relatório de dez páginas.

## Quatro erros que aparecem depois de ligar

**Nada mudou em um domínio específico.** Provável CDN ou proxy na frente respondendo de cache antigo. Para falar com a origem sem quebrar SNI e certificado, resolva o hostname na mão:

```
curl -I -H "Accept-Encoding: gzip" --resolve site-do-cliente.com.br:443:IP_DE_ORIGEM https://site-do-cliente.com.br/
```

Se a resposta de origem já vier com `content-encoding: gzip`, o problema é a borda. Um `?v=1` na URL também serve, mas ele só fura o cache da borda, não prova nada sobre a origem.

**Conteúdo quebrado ou caractere estranho.** Quase sempre é compressão dupla: a aplicação já comprimia em PHP (`ob_gzhandler` ou plugin de cache) e o servidor comprimiu de novo. Escolha uma das duas camadas, não as duas.

**Download de arquivo binário vindo corrompido.** Revise a lista: algum tipo binário entrou onde não devia.

**CPU do servidor subiu.** Confira se tipos de vídeo ou de arquivo compactado entraram na lista. Comprimir MP4 de 200 MB a cada requisição é a forma mais cara de não ganhar nada.

Em qualquer desses casos, a lista de MIME types é o primeiro lugar a olhar, e você reverte na mesma tela em que ligou. É uma das poucas mudanças de servidor que desfaz sem sequela.

