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

Uma 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 -y

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

Adicione as seguintes linhas:

deb http://nginx.org/packages/ubuntu/ focal nginx
deb-src http://nginx.org/packages/ubuntu/ focal nginx

Salve e feche o arquivo quando terminar, então atualize o repositório com o seguinte comando:

apt-get update -y

Uma 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 nginx

Em seguida, instale todas as dependências necessárias para o Nginx com o seguinte comando:

apt-get build-dep nginx -y

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

Em 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/rules

Agora 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_brotli

Salve 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 -us

Uma 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/*.deb

Você 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.deb

Uma 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 *.deb

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

Adicione 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 -t

Você 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 successful

Em seguida, reinicie o serviço Nginx para aplicar as alterações:

systemctl restart nginx

Uma 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://localhost

Se 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: br

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

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.