Como configurar reverse proxy Nginx

Um reverse proxy permite ao Nginx receber tráfego HTTP/HTTPS público e reencaminhá-lo para apps backend (Node.js na porta 3000, contentores Docker, APIs Python). Essencial para deploy em produção num VPS Hiddence.

Pré-requisitos

• Nginx instalado e em execução
• App backend a escutar em localhost (ex. 127.0.0.1:3000)
• Domínio apontado para o VPS (para SSL)
• Portas 80 e 443 abertas na firewall

Configuração básica de reverse proxy

Crie configuração de site para o domínio:

server {
    listen 80;
    server_name app.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

sudo nginx -t && sudo systemctl reload nginx

Suporte WebSocket

Necessário para Socket.io, muitos painéis e apps em tempo real:

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

Adicionar HTTPS com Certbot

Quando HTTP funcionar, emita certificado gratuito:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d app.yourdomain.com

# Certbot will update your server block for SSL automatically

Dicas

• Use proxy_buffering off para streaming/SSE se necessário
• Defina client_max_body_size para uploads
• Execute vários backends em subdomínios diferentes
• Use blocos upstream para balancear vários backends
• Verifique error.log em caso de 502 Bad Gateway