Nginx Brotli · 3 min read · Oct 20, 2025
Como Instalar Nginx com Compressão Brotli no Ubuntu 20.04

Brotli é um algoritmo de compressão de código aberto criado pelo Google. Ele pode ser usado como uma alternativa ao Gzip, Zopfli e Deflate. É um algoritmo de compressão sem perdas de propósito genérico que comprime dados usando uma combinação de uma variante moderna do algoritmo LZ77 e codificação Huffman. Ele comprime dados de 10 a 20 por cento mais do que os algoritmos de compressão atuais.
Este tutorial mostrará como instalar o Brotli com o Nginx no servidor Ubuntu 20.04.
Pré-requisitos
- Um servidor executando Ubuntu 20.04.
- Uma senha de root foi configurada no servidor.
Começando
Primeiro, é recomendável atualizar os pacotes do seu sistema para a versão mais recente. Você pode atualizar todos eles executando o seguinte comando:
apt-get update -yUma vez que todos os pacotes estejam atualizados, você pode instalar outras dependências executando o seguinte comando:
apt-get install dpkg-dev curl gnupg2 build-essential zlib1g-dev libpcre3 libpcre3-dev unzip -yUma vez que todas as dependências estejam instaladas, você pode prosseguir para a próxima etapa.
Baixar o Nginx e o Código Fonte do Brotli
Antes de baixar o Nginx e o código fonte do Brotli, você deve adicionar o repositório do Nginx ao seu sistema.
Primeiro, baixe e adicione a chave do Nginx com o seguinte comando:
curl -L https://nginx.org/keys/nginx_signing.key | apt-key add -Uma vez que a chave esteja adicionada, adicione o repositório do Nginx com o seguinte comando:
nano /etc/apt/sources.list.d/nginx.listAdicione as seguintes linhas:
deb http://nginx.org/packages/ubuntu/ focal nginx
deb-src http://nginx.org/packages/ubuntu/ focal nginxSalve e feche o arquivo quando terminar, então atualize o repositório com o seguinte comando:
apt-get update -yUma vez que o repositório esteja atualizado, mude o diretório para /usr/local/src e baixe o código fonte do Nginx com o seguinte comando:
cd /usr/local/src
apt-get source nginxEm seguida, instale todas as dependências necessárias para o Nginx com o seguinte comando:
apt-get build-dep nginx -yUma vez que todas as dependências estejam instaladas, baixe a versão mais recente do código fonte do Brotli do repositório Git com o seguinte comando:
git clone --recursive https://github.com/google/ngx_brotli.gitEm seguida, mude o diretório para o código fonte do Nginx e edite o arquivo de regras do debian:
cd /usr/local/src/nginx-*/
nano debian/rulesAgora você terá dois ambientes de construção para ‘config.env.nginx’ e ‘config.env.nginx_debug’. Adicione a opção ‘–add-module=’ para ngx_brotli a ambos os ambientes de construção.
--add-module=/usr/local/src/ngx_brotliSalve e feche o arquivo quando terminar. Agora, compile e construa o pacote nginx com suporte ao ngx_brotli com o seguinte comando:
dpkg-buildpackage -b -uc -usUma vez que a construção esteja concluída, você obterá os pacotes nginx-*.deb no diretório ‘/usr/local/src’ como mostrado abaixo.
ls -l /usr/local/src/*.debVocê deve obter a seguinte saída:
-rw-r--r-- 1 root root 1124244 Dec 2 06:30 /usr/local/src/nginx_1.18.0-2~focal_amd64.deb
-rw-r--r-- 1 root root 10608196 Dec 2 06:30 /usr/local/src/nginx-dbg_1.18.0-2~focal_amd64.debUma vez que você tenha terminado, pode prosseguir para a próxima etapa.
Instalar o Nginx e Habilitar o Suporte ao Brotli
Agora, você tem pacotes do Nginx com suporte ao Brotli. Você pode instalá-los com o seguinte comando:
cd /usr/local/src/
dpkg -i *.debUma vez que todos os pacotes estejam instalados, edite o arquivo de configuração principal do Nginx e habilite o suporte ao Brotli:
nano /etc/nginx/nginx.confAdicione as seguintes linhas abaixo de http{
brotli on;
brotli_comp_level 6;
brotli_static on;
brotli_types text/plain text/css application/javascript application/x-javascript text/xml application/xml application/xml+rss text/javascript image/x-icon image/vnd.microsoft.icon image/bmp image/svg+xml;Salve e feche o arquivo, então verifique o Nginx para qualquer erro de sintaxe com o seguinte comando:
nginx -tVocê deve obter a seguinte saída:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulEm seguida, reinicie o serviço Nginx para aplicar as alterações:
systemctl restart nginxUma vez que você tenha terminado, pode prosseguir para a próxima etapa.
Verificar Nginx e Brotli
Neste ponto, o Nginx está instalado e configurado com suporte ao Brotli. Agora, é hora de testar se o suporte ao Brotli do Nginx está habilitado ou não.
Para testá-lo, execute o seguinte comando no seu terminal:
curl -H 'Accept-Encoding: br' -I http://localhostSe tudo estiver bem, você verá o resultado ‘content-encoding: br’ para suporte ao Brotli, como mostrado abaixo:
HTTP/1.1 200 OK
Server: nginx/1.18.0
Date: Wed, 02 Dec 2020 06:38:17 GMT
Content-Type: text/html
Last-Modified: Tue, 21 Apr 2020 14:09:01 GMT
Connection: keep-alive
ETag: W/"5e9efe7d-264"
Content-Encoding: brConclusão
Parabéns! você instalou com sucesso o Nginx com suporte ao Brotli no servidor Ubuntu 20.04. Espero que agora você possa habilitar facilmente a compressão Brotli no suporte de produção. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.