<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Nginx e reverse proxy: o que todo deploy precisa saber

DA

6 min

Nginx e reverse proxy: o que todo deploy precisa saber

Entenda o papel do Nginx como reverse proxy no deploy: TLS, configuração mínima de proxy_pass, o erro 502 e os acertos que todo deploy precisa.

Neste artigo

A aplicação que escuta em uma porta alta não deveria falar com a internet diretamente. O Nginx ocupa essa posição: recebe o tráfego nas portas padrão do navegador, cuida do certificado, dos arquivos estáticos e encaminha o resto para a aplicação. É o reverse proxy, e está presente em quase todo deploy sério.

O reverse proxy fica na frente da aplicação, encaminha cada requisição para o serviço certo e devolve a resposta. O Nginx cumpre esse papel com uma configuração curta de server block e proxy_pass. Em ambiente com containers, ele conversa com os containers pela rede interna, base que o guia de Docker do zero ao primeiro container constrói.

Por que colocar um reverse proxy na frente da aplicação?

Porque há trabalho que não pertence à aplicação. Terminar TLS, comprimir resposta, servir imagem e CSS, limitar taxa de requisição e padronizar cabeçalhos são tarefas de borda. Deixar isso no Nginx simplifica a aplicação e centraliza a política de entrada: um lugar para configurar o que chega e o que não chega, em vez de cada serviço resolver do seu jeito.

A configuração mínima que resolve o deploy

O server block abaixo é o esqueleto da maioria dos deploys: escuta na porta 80, encaminha tudo para a aplicação e repassa o cabeçalho com o host original, que muitas aplicações usam para montar links e redirecionamentos.

server {
    listen 80;
    server_name meusite.com.br;

    location / {
        proxy_pass http://app:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}

Com containers, o destino costuma ser o nome do serviço na rede interna, como o app do exemplo, e o Nginx resolve o endereço sozinho. Esse acoplamento pela rede do compose é o mesmo mecanismo do ambiente completo subido com um comando no Docker Compose.

O que o Nginx resolve sem a aplicação saber

TLS é o caso mais claro: o certificado fica no Nginx, e a aplicação continua falando HTTP simples na rede interna. Arquivos estáticos são o segundo: o Nginx serve imagem, CSS e JavaScript direto do disco, mais rápido e sem gastar o processo da aplicação. Cache de resposta, compressão e redirecionamento de domínio completam o pacote de borda.

⚠️ Atenção: mudança na configuração do Nginx exige teste com nginx -t antes do reload. Sintaxe errada em produção derruba a porta de entrada inteira, e o reload não salva arquivo quebrado.

Por que o 502 aparece e como investigar

O erro 502 significa que o Nginx falou e ninguém respondeu: a aplicação caiu, está em outra porta ou não subiu. A investigação começa no log de erro do Nginx, que diz o motivo exato da recusa de conexão, e segue com o status da aplicação no servidor. Os comandos essenciais do Linux para desenvolvedores cobrem essa rotina de checagem de processo, porta e log.

Do servidor solto à borda organizada

Em projetos maiores, o reverse proxy vira camada de roteamento: um ponto de entrada que distribui por caminho, domínio ou versão, e aí entram balanceamento e health check. O caminho de aprendizado é o mesmo, do simples ao distribuído, e a nuvem dá o terreno para isso, como mostra o guia completo de AWS para desenvolvedores.

Dois recursos do Nginx raramente configurados de cara e que pagam caro depois: o log estruturado com campos claros, que permite filtrar por upstream e tempo de resposta na investigação, e o health check no upstream, que evita mandar tráfego para um backend que já morreu. Configurá-los no dia do deploy custa dez minutos; descobrir a falta deles durante um incidente custa horas.

Guardar esses dois blocos de configuração no repositório do projeto desde o início é o que diferencia o servidor de produção do experimento de fim de semana.

HTTPS e compressão: os dois blocos que todo deploy precisa

O primeiro bloco é o TLS. Hoje o caminho padrão é o certificado gratuito emitido automaticamente, com o Nginx apenas servindo o desafio de validação e redirecionando todo tráfego HTTP para HTTPS. Além de exigência dos navegadores, o HTTPS habilita recursos que só funcionam em contexto seguro, e deixa de ser opcional no momento em que a aplicação tem qualquer login. O segundo bloco é a compressão de resposta e os cabeçalhos de cache: comprimir texto custa pouco de processador e reduz pela metade o tempo de carregamento, enquanto o cache define o que o navegador pode guardar e por quanto.

O erro comum nesses blocos é configurar tudo na mão a cada servidor novo, sem versionar. A mesma disciplina do código vale aqui: a configuração do Nginx vive no repositório do projeto, é aplicada por script ou ferramenta de provisionamento, e qualquer mudança passa por revisão. Quando a configuração vira texto versionado, subir uma segunda instância idêntica deixa de ser arqueologia de comandos antigos e vira executar o mesmo conjunto de arquivos em outra máquina. O mesmo vale para a rotação de log, que definida no dia do deploy evita o disco cheio seis meses depois, incidente silencioso que costuma derrubar o servidor em plena madrugada.

Perguntas frequentes

Nginx é servidor web ou reverse proxy?

Os dois. Ele nasceu como servidor web para arquivos estáticos e ganhou o papel de reverse proxy, que é o uso dominante em deploy de aplicação. A mesma instalação costuma fazer as duas coisas em servidores diferentes.

Preciso de Nginx se uso containers?

Em geral, sim. O container da aplicação expõe a porta alta, e alguém precisa receber o tráfego nas portas 80 e 443, cuidar do certificado e rotear entre serviços. Em plataforma gerenciada esse papel é ocupado por um load balancer do provedor.

Nginx ou Caddy para começar?

Os dois resolvem. O Caddy ganha em simplicidade de certificado automático, e o Nginx ganha em documentação, exemplos e presença em produção. Saber ler a configuração do Nginx abre mais portas no mercado hoje.

Onde fica o certificado TLS?

No proxy, que encerra TLS e fala HTTP com a aplicação na rede interna. Renovação pode ser automática com certificado emitido por utilitário do próprio servidor, e a aplicação nunca precisa lidar com chave privada.

Por que minha aplicação vê o IP do proxy?

Porque a conexão vem dele. O cabeçalho X-Forwarded-For leva o IP original, e a aplicação precisa estar configurada para confiar nesse cabeçalho vindo do proxy. Sem isso, logs e limites por IP usam o endereço errado.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas de cloud e DevOps →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR