Central de Ajuda

Guia da Central de Ajuda

Compressão no Apache com Brotli, gzip e mod_deflate: configuração e testes

Compressão reduz HTML, CSS, JavaScript, JSON, XML e SVG enviados ao visitante. Imagens JPEG/WebP, vídeo, ZIP e PDF já comprimidos costumam ganhar pouco e podem desperdiçar CPU. Em cPanel, os módulos disponíveis dependem do EasyApache e da configuração do servidor.

Configurar no cPanel

Quando disponível, abra Optimize Website e habilite compressão do conteúdo apropriado. Em .htaccess, uma configuração defensiva para gzip é:

<IfModule mod_deflate.c>
  AddOutputFilterByType DEFLATE text/html text/plain text/css
  AddOutputFilterByType DEFLATE application/javascript application/json
  AddOutputFilterByType DEFLATE image/svg+xml
</IfModule>

Brotli

Brotli geralmente comprime melhor texto, mas exige módulo e configuração do servidor/CDN. Não cole diretivas de mod_brotli se o módulo não está carregado. CDNs podem negociar Brotli com o visitante mesmo quando a origem usa gzip.

Testar

curl -I -H "Accept-Encoding: br,gzip" https://exemplo.com/arquivo.css

Procure Content-Encoding: br ou gzip e Vary: Accept-Encoding. Teste resposta real, não apenas página inicial. Compare tamanho transferido nas ferramentas do navegador.

Evite compressão dupla

Aplicação, Apache, proxy e CDN podem tentar comprimir. Mantenha uma camada responsável e valide os cabeçalhos. Respostas já comprimidas não devem ser recomprimidas.

Desempenho completo

  • ative cache e HTTP/2 ou HTTP/3 quando disponível;
  • minifique somente com pipeline confiável;
  • otimize imagens separadamente;
  • use CDN para ativos globais;
  • monitore CPU e tempo de resposta;
  • não comprima conteúdo sensível refletido junto a segredos sem avaliar riscos de ataques por compressão.

Conteúdo dinâmico e cache

Não confunda compressão com cache: gzip/Brotli reduz cada resposta, enquanto cache evita gerar ou transferir novamente. Respostas personalizadas, cookies e APIs exigem cabeçalhos próprios. Valide Cache-Control, ETag e Vary para impedir que proxy entregue conteúdo de um usuário a outro.

Erro 500 após editar .htaccess: remova a diretiva, confirme módulos e consulte o log. Use blocos IfModule, mas não trate ausência do módulo como otimização concluída.

Recursos relacionados

Continue com materiais e serviços relacionados ao tema deste guia.

Este guia resolveu sua dúvida? Seu retorno ajuda a priorizar as próximas revisões.
Atendimento técnico

Não encontrou o resultado esperado?

Abra um chamado e envie a mensagem de erro completa, o domínio ou serviço afetado, o horário do teste e capturas de tela sem senhas.