Como habilitar a compressão Brotli no DirectAdmin com Nginx (Guia Completo)

Índice do artigo

Introdução à compressão Brotli
O que é Brotli e por que habilitar Brotli no DirectAdmin
Como funciona a compressão HTTP
Compatibilidade do Brotli com navegadores
Brotli vs Gzip: qual compressão usar
Vantagens de habilitar Brotli no DirectAdmin com Nginx
Arquitetura do Nginx no DirectAdmin
O papel do CustomBuild no DirectAdmin
O módulo ngx_brotli
Preparando o servidor para habilitar Brotli no DirectAdmin
Conectando ao servidor via SSH
Acessando o diretório do CustomBuild
Baixando o módulo Brotli
Preparando a compilação do Nginx
Editando o arquivo configure.nginx
Recompilando o Nginx no DirectAdmin
Verificando se o módulo Brotli foi instalado
Como habilitar Brotli no DirectAdmin com Nginx
Explicação das diretivas Brotli
Reiniciando o Nginx
Como testar se o Brotli foi habilitado no DirectAdmin
Testando Brotli no navegador
Ferramentas online para testar Brotli
Problemas comuns ao habilitar Brotli no DirectAdmin
Benefícios de habilitar Brotli no DirectAdmin com Nginx
Conclusão
FAQ — Como habilitar Brotli no DirectAdmin com Nginx

PARTE 1 — Introdução e fundamentos do Brotli

A otimização de desempenho é uma das tarefas mais importantes na administração de servidores web modernos. Neste guia você aprenderá como habilitar Brotli no DirectAdmin com Nginx, uma das otimizações mais eficientes para reduzir o tamanho dos arquivos enviados pelo servidor web. Ao habilitar Brotli no DirectAdmin com Nginx é possível melhorar a performance do site, reduzir o consumo de banda e acelerar o carregamento de páginas em servidores Linux, VPS e servidores dedicados.

Quando um navegador acessa um site, o servidor precisa enviar diversos arquivos ao cliente. Entre eles estão:

HTML
CSS
JavaScript
JSON
fontes web
arquivos SVG

Sem compressão, todos esses arquivos são enviados em seu tamanho original, aumentando o volume de dados transferidos e o tempo necessário para carregar a página.

Para resolver esse problema, servidores web utilizam algoritmos de compressão capazes de reduzir o tamanho desses arquivos antes de enviá-los ao navegador.

Durante muitos anos o algoritmo mais utilizado foi o gzip, mas atualmente uma alternativa mais eficiente ganhou destaque: Brotli.

Ao habilitar Brotli no DirectAdmin, o servidor passa a enviar arquivos significativamente menores para o navegador, reduzindo o tráfego de rede e melhorando a velocidade de carregamento.

O DirectAdmin é um dos painéis de controle mais utilizados para gerenciamento de servidores Linux em ambientes de hospedagem. Ele permite administrar serviços como Nginx, Apache, PHP e bancos de dados de forma centralizada. Se você deseja entender melhor todas as funcionalidades do painel, veja também o artigo DirectAdmin para administradores.

O que é Brotli e por que habilitar Brotli no DirectAdmin

Brotli é um algoritmo de compressão desenvolvido pelo Google e projetado especificamente para otimizar a entrega de conteúdo na web.

Ele foi lançado oficialmente em 2015 e rapidamente passou a ser utilizado por grandes plataformas da internet.

O Brotli utiliza diversas técnicas avançadas de compressão, incluindo:

LZ77
codificação Huffman
modelagem de contexto
dicionários estáticos

Essas técnicas permitem identificar padrões repetidos em arquivos e substituí-los por referências menores.

O resultado é uma compressão altamente eficiente.

Na prática, Brotli consegue gerar arquivos entre 15% e 30% menores que gzip, dependendo do tipo de conteúdo.

Isso significa que páginas web podem ser carregadas mais rapidamente e consumir menos largura de banda.

Por isso, muitos administradores de servidores procuram habilitar Brotli no DirectAdmin com Nginx como parte de sua estratégia de otimização de performance.

Como funciona a compressão HTTP

Quando um navegador faz uma requisição para um site, ele envia um cabeçalho chamado Accept-Encoding.

Esse cabeçalho informa ao servidor quais algoritmos de compressão o navegador suporta.

Um exemplo típico é:

Accept-Encoding: gzip, deflate, br

Nesse exemplo:

gzip → compressão gzip
deflate → compressão zlib
br → compressão Brotli

Se o servidor tiver suporte a Brotli, ele pode enviar a resposta comprimida utilizando esse algoritmo.

Nesse caso o cabeçalho de resposta será:

Content-Encoding: br

O navegador então descomprime automaticamente os dados antes de renderizar a página.

Esse processo é totalmente transparente para o usuário.

Compatibilidade do Brotli

Uma das razões pelas quais muitos administradores escolhem habilitar Brotli no DirectAdmin é a ampla compatibilidade com navegadores modernos.

Hoje praticamente todos os navegadores populares suportam Brotli.

Entre eles:

Google Chrome
Mozilla Firefox
Microsoft Edge
Safari
Opera

Na maioria dos casos o Brotli é utilizado automaticamente quando o site está rodando em HTTPS.

Isso significa que a compressão pode ser aplicada sem impacto negativo na compatibilidade com usuários.

Brotli vs Gzip

Embora gzip ainda seja amplamente utilizado, Brotli apresenta vantagens importantes.

Característica	Brotli	Gzip
Taxa de compressão	maior	menor
Uso de CPU	moderado	menor
Compatibilidade	navegadores modernos	universal
Eficiência web	excelente	boa

Em servidores modernos, a estratégia ideal geralmente é:

Brotli como compressão principal
gzip como fallback

Isso garante máxima eficiência sem perder compatibilidade.

Vantagens de habilitar Brotli no DirectAdmin com Nginx

Administradores que decidem habilitar Brotli no DirectAdmin com Nginx geralmente observam diversos benefícios.

Entre eles:

Redução do uso de banda

Arquivos menores significam menos dados transferidos.

Isso pode reduzir custos em ambientes cloud.

Melhor tempo de carregamento

Arquivos comprimidos chegam mais rápido ao navegador.

Isso melhora métricas importantes como:

First Contentful Paint
Largest Contentful Paint

Melhor pontuação em ferramentas de performance

Ferramentas como:

Google PageSpeed
Lighthouse
GTmetrix

consideram compressão um fator importante de otimização.

Melhor experiência para usuários

Usuários percebem páginas carregando mais rápido, especialmente em redes móveis.

PARTE 2 — Estrutura do Nginx no DirectAdmin e preparação do servidor

Arquitetura do Nginx no DirectAdmin

Antes de habilitar Brotli no DirectAdmin com Nginx, é importante entender como o Nginx funciona dentro da arquitetura do painel.

O DirectAdmin permite diferentes configurações de servidor web, que podem variar dependendo da forma como o ambiente foi instalado.

As arquiteturas mais comuns são:

Apache puro

Nesse modelo apenas o Apache é utilizado para servir os sites.

Nginx como proxy reverso

Esse é o cenário mais comum em servidores modernos. Utilizado neste artigo.

O funcionamento ocorre da seguinte forma:

O Nginx recebe a requisição
Arquivos estáticos são entregues diretamente
Conteúdo dinâmico é encaminhado para o Apache

Nginx standalone

Nesse modelo o Nginx atua sozinho como servidor web principal.

Essa configuração é comum em servidores focados em performance.

Independentemente da arquitetura utilizada, habilitar Brotli no DirectAdmin melhora significativamente a entrega de arquivos estáticos.

O papel do CustomBuild no DirectAdmin

O DirectAdmin utiliza um sistema chamado CustomBuild para gerenciar a instalação e compilação dos serviços do servidor.

O CustomBuild é responsável por:

instalar Apache
instalar Nginx
compilar PHP
instalar MariaDB ou MySQL
atualizar componentes do servidor

Para habilitar Brotli no DirectAdmin com Nginx, precisamos adicionar o módulo Brotli durante a compilação do Nginx realizada pelo CustomBuild.

O módulo ngx_brotli

O suporte a Brotli no Nginx é fornecido por um módulo chamado ngx_brotli.

Esse módulo foi desenvolvido pelo Google e oferece duas funcionalidades principais.

Compressão dinâmica

O Nginx comprime arquivos automaticamente antes de enviá-los ao navegador.

Isso funciona de forma semelhante ao gzip.

Brotli Static

Permite servir arquivos previamente comprimidos.

Exemplo:

style.css
style.css.br

Se o navegador suportar Brotli, o Nginx envia diretamente o arquivo .br.

Isso reduz o uso de CPU do servidor.

Preparando o servidor para habilitar Brotli no DirectAdmin

Antes de iniciar a instalação, alguns requisitos precisam ser verificados.

Acesso root ao servidor

Você precisa ter acesso root via SSH.

Git instalado

O módulo Brotli é obtido através de um repositório Git.

CustomBuild atualizado

Sempre utilize a versão mais recente do CustomBuild.

Entre no diretório:

cd /usr/local/directadmin/custombuild

Atualize o sistema:

./build update

Conectando ao servidor via SSH

Caso ainda não esteja conectado ao servidor, faça login usando SSH.

ssh root@IP_DO_SERVIDOR

Substitua IP_DO_SERVIDOR pelo endereço do seu servidor.

Após o login você terá acesso ao terminal Linux.

Acessando o diretório do CustomBuild

Agora entre no diretório onde o DirectAdmin gerencia os componentes do servidor.

cd /usr/local/directadmin/custombuild

Esse diretório contém scripts responsáveis por instalar e compilar diversos serviços.

Entre eles:

Apache
Nginx
PHP
MariaDB

Baixando o módulo Brotli

Agora vamos baixar o módulo Brotli que será utilizado para habilitar Brotli no DirectAdmin com Nginx.

Execute os seguintes comandos:

git clone https://github.com/google/ngx_brotli.git brotli
cd brotli && git submodule update --init && cd ..

Explicação dos comandos:

mkdir brotli

Cria o diretório onde o módulo será armazenado.

git clone

Baixa o código do módulo ngx_brotli.

git submodule update

Baixa dependências necessárias para compilar o módulo.

Após esses passos, o módulo estará pronto para ser incluído na compilação do Nginx.

Preparando a compilação do Nginx

Agora precisamos informar ao DirectAdmin que o módulo Brotli deve ser incluído na compilação do Nginx.

Primeiro criamos um diretório de configuração customizada.

mkdir -p /usr/local/directadmin/custombuild/custom/nginx_reverse

Depois copiamos o arquivo de configuração padrão.

cp configure/nginx_reverse/configure.nginx custom/nginx_reverse/

Esse arquivo define quais módulos serão utilizados durante a compilação.

Editando o arquivo configure.nginx

Agora abra o arquivo para edição.

nano custom/nginx_reverse/configure.nginx

Adicione a seguinte linha antes da ultima linha:

"--add-module=/usr/local/directadmin/custombuild/brotli" \

Essa linha informa ao CustomBuild que o módulo Brotli deve ser incluído na compilação do Nginx.

Salve o arquivo e saia do editor.

Por que essa etapa é necessária

O Nginx não possui suporte nativo ao Brotli em muitas distribuições.

Por isso precisamos recompilar o Nginx com o módulo ngx_brotli.

Esse processo garante que o servidor web terá suporte completo ao algoritmo de compressão Brotli.

Após essa etapa estaremos prontos para recompilar o Nginx e finalmente habilitar Brotli no DirectAdmin.

PARTE 3 — Recompilar Nginx e habilitar Brotli no DirectAdmin

Agora que o módulo ngx_brotli foi instalado e adicionado à configuração do CustomBuild, o próximo passo é recompilar o Nginx para que o módulo seja incluído no servidor web.

Esse processo é essencial para habilitar Brotli no DirectAdmin com Nginx, pois sem a recompilação o servidor não reconhecerá o novo módulo.

Recompilando o Nginx no DirectAdmin

Dentro do diretório do CustomBuild execute o seguinte comando:

./build nginx

Se o servidor estiver utilizando a arquitetura Nginx + Apache, o comando geralmente utilizado é:

./build nginx_apache

Durante esse processo o DirectAdmin irá:

compilar o Nginx novamente
incluir o módulo Brotli
instalar o novo binário do servidor web
atualizar as configurações necessárias

Dependendo do hardware do servidor, esse processo pode levar alguns minutos.

Após a compilação terminar, o Nginx já terá suporte ao Brotli.

Verificando se o módulo Brotli foi instalado

Para confirmar que o módulo foi instalado corretamente execute:

nginx -V

Esse comando mostra todos os parâmetros utilizados na compilação do Nginx.

Procure por algo semelhante a:

--add-module=/usr/local/directadmin/custombuild/brotli

Se essa linha aparecer, significa que o módulo Brotli foi incluído corretamente.

Isso confirma que agora é possível habilitar Brotli no DirectAdmin através da configuração do Nginx.

Como habilitar Brotli no DirectAdmin com Nginx

Agora que o módulo está ativo, precisamos configurar o Nginx para utilizar a compressão Brotli.

Abra o arquivo de configuração:

nano /etc/nginx/nginx-includes.conf

Adicione as seguintes diretivas:

# Brotli Settings
brotli on;
brotli_comp_level 6;
brotli_static on;
brotli_types
    text/plain
    text/css
    text/xml
    text/javascript
    text/x-component
    application/json
    application/javascript
    application/x-javascript
    application/xml+rss
    application/rss+xml
    application/atom+xml
    application/x-font-ttf
    application/x-font-opentype
    application/vnd.ms-fontobject
    image/svg+xml
    image/x-icon
    font/opentype;
brotli_window 512k;
brotli_min_length 256;

Essas diretivas ativam o Brotli e definem quais tipos de arquivos serão comprimidos.

reinicie o nginx após as alterações: systemctl restart nginx

Explicação das diretivas Brotli

Para compreender melhor a configuração, vamos analisar cada diretiva.

brotli on

Essa diretiva ativa a compressão Brotli no servidor.

Sem ela o módulo não será utilizado.

brotli_static on

Permite que o Nginx utilize arquivos pré-comprimidos com extensão .br.

Isso reduz o uso de CPU.

Exemplo:

style.css
style.css.br

Se o navegador suportar Brotli, o arquivo .br será enviado automaticamente.

brotli_comp_level

Define o nível de compressão.

Os níveis variam de:

1 até 11

Quanto maior o nível:

maior a compressão
maior o uso de CPU

Para a maioria dos servidores recomenda-se:

brotli_comp_level 5

brotli_comp_level 6

brotli_types

Define quais tipos de arquivos serão comprimidos.

Normalmente incluem:

HTML
CSS
JavaScript
JSON
XML
SVG

Arquivos já comprimidos como imagens ou vídeos não precisam ser incluídos.

Reiniciando o Nginx

Após salvar a configuração, reinicie o Nginx para aplicar as alterações.

Execute:

systemctl restart nginx

service nginx restart

Agora o servidor já estará pronto para utilizar Brotli.

Como testar se o Brotli foi habilitado no DirectAdmin

Existem algumas maneiras de verificar se o Brotli está funcionando corretamente.

Uma das mais simples é utilizar o comando curl.

Execute:

curl -I -H "Accept-Encoding: br" https://seusite.com

Se o Brotli estiver ativo, a resposta deverá incluir:

content-encoding: br

Isso confirma que o servidor está enviando conteúdo comprimido.

Testando Brotli no navegador

Outra forma de verificar é utilizando as ferramentas de desenvolvedor do navegador.

No Chrome ou Edge:

pressione F12
vá até a aba Network
recarregue a página
selecione um arquivo CSS ou JS

Nos cabeçalhos da resposta procure por:

content-encoding: br

Se aparecer, Brotli está funcionando corretamente.

Ferramentas online para testar Brotli

Também existem ferramentas online que verificam automaticamente se a compressão Brotli está ativa.

Algumas das mais conhecidas são:

KeyCDN Brotli Test
WebPageTest
GTmetrix

Essas ferramentas também mostram o impacto da compressão no tamanho dos arquivos.

Problemas comuns ao habilitar Brotli no DirectAdmin

Embora o processo seja relativamente simples, alguns problemas podem ocorrer.

Brotli não aparece na resposta HTTP

Verifique se o módulo foi compilado corretamente.

Execute novamente:

nginx -V

Se brotli não aparecer, a compilação não incluiu o módulo.

CDN removendo compressão

Algumas CDNs podem aplicar compressão própria.

Nesse caso o cabeçalho pode ser modificado pela CDN.

Brotli não funciona sem HTTPS

Alguns navegadores utilizam Brotli apenas em conexões HTTPS.

Por isso recomenda-se sempre utilizar SSL.

Benefícios de habilitar Brotli no DirectAdmin

Administradores que decidem habilitar Brotli no DirectAdmin com Nginx costumam observar melhorias importantes.

Entre elas:

menor uso de banda
melhor tempo de carregamento
melhor pontuação no PageSpeed
melhor experiência para usuários

Em ambientes com alto tráfego, essa otimização pode gerar economia significativa de recursos.

Conclusão

Habilitar Brotli no DirectAdmin com Nginx é uma das otimizações mais eficientes para melhorar a performance de servidores web modernos.

Com alguns passos simples — instalar o módulo, recompilar o Nginx e ativar a compressão — é possível reduzir significativamente o tamanho dos arquivos enviados ao navegador.

Isso melhora o tempo de carregamento das páginas, reduz o consumo de banda e aumenta a eficiência do servidor.

Para administradores de servidores Linux que utilizam DirectAdmin, essa otimização é altamente recomendada e pode trazer benefícios imediatos para sites e aplicações hospedadas.

Habilitar Brotli no Nginx é apenas uma das muitas otimizações possíveis em servidores gerenciados pelo DirectAdmin. Para conhecer todas as funcionalidades do painel e aprender a administrar servidores de forma mais eficiente, veja também o guia completo do DirectAdmin para administradores

FAQ

O que é Brotli no Nginx?

Brotli é um algoritmo de compressão desenvolvido pelo Google que reduz o tamanho dos arquivos enviados pelo servidor para o navegador. Ao habilitar Brotli no DirectAdmin com Nginx, arquivos como HTML, CSS e JavaScript são comprimidos antes de serem enviados ao visitante, melhorando a velocidade do site e reduzindo o uso de banda.

Vale a pena habilitar Brotli no DirectAdmin?

Sim. Habilitar Brotli no DirectAdmin com Nginx pode reduzir o tamanho das respostas HTTP entre 15% e 30% em comparação ao gzip. Isso melhora o tempo de carregamento das páginas e pode ajudar a aumentar a pontuação em ferramentas como Google PageSpeed e Lighthouse.

Brotli é melhor que gzip?

Na maioria dos casos, sim. O Brotli geralmente oferece uma taxa de compressão maior que gzip, o que significa que os arquivos enviados ao navegador são menores. No entanto, a prática recomendada é manter gzip como fallback para navegadores antigos.

Todos os navegadores suportam Brotli?

A maioria dos navegadores modernos suporta Brotli, incluindo Google Chrome, Firefox, Edge e Safari. Normalmente o Brotli funciona automaticamente quando o site utiliza HTTPS.

Como saber se o Brotli está funcionando no Nginx?

Após habilitar Brotli no DirectAdmin, você pode testar usando o comando:
curl -I -H “Accept-Encoding: br” https://seusite.com
Se a resposta incluir o cabeçalho content-encoding: br, significa que a compressão Brotli está ativa.

Brotli aumenta o uso de CPU do servidor?

Sim, mas o impacto geralmente é pequeno quando configurado corretamente. Em servidores de produção, recomenda-se utilizar níveis de compressão entre 4 e 6 para manter um bom equilíbrio entre desempenho e uso de CPU.

Quais arquivos devem usar Brotli?

Brotli funciona melhor em arquivos de texto, como:
HTML
CSS
JavaScript
JSON
XML
SVG
Arquivos já comprimidos, como imagens ou vídeos, não precisam utilizar Brotli.

Posso usar Brotli junto com CDN?

Sim. Muitas CDNs como Cloudflare ou BunnyCDN já suportam Brotli automaticamente. Mesmo assim, habilitar Brotli no DirectAdmin pode ajudar quando a CDN não estiver aplicando compressão.

Veja Mais:

Guia Completo do DirectAdmin para Administradores (Instalação, Segurança e Configuração)
Como Proteger DirectAdmin Contra Ataques: Guia Completo de Segurança 2026
Como habilitar a compressão Brotli no DirectAdmin com Nginx (Guia Completo)
Como Instalar e Otimizar o Redis no DirectAdmin: Guia Definitivo 2026
Onde ficam as configurações PHP-FPM no DirectAdmin? (Guia 2026)
CSF Firewall no DirectAdmin: Como Configurar
Como Ativar o HTTP/3 no DirectAdmin: Guia Completo 2026
DirectAdmin Lento? Guia Definitivo de Diagnóstico e Otimização [2026]
Migração de Contas DirectAdmin: Guia Completo e Passo a Passo
Como Otimizar MariaDB no DirectAdmin (Guia Completo de Alta Performance)
Como Otimizar DirectAdmin para Alto Tráfego (Guia Definitivo)
DirectAdmin em VPS ou Servidor Dedicado: Qual a Melhor Escolha?
DirectAdmin em Cloud: Vale a Pena? O Guia Definitivo (2026)
Como Reduzir Uso de CPU no DirectAdmin: Guia Completo 2026
Como migrar DirectAdmin para dedicado? : Guia Completo e Seguro