Como Configurar Nginx Reverse Proxy

Um reverse proxy permite que o Nginx aceite tráfego HTTP/HTTPS público e encaminhe para apps backend (Node.js na porta 3000, containers Docker, APIs Python). Essencial para deploys de produção em um VPS Hiddence.

Pré-requisitos

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

Configuração básica de reverse proxy

Crie uma config de site para seu 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 a WebSocket

Necessário para Socket.io, muitos dashboards 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

Depois que HTTP funcionar, emita um 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 de arquivos
• Execute múltiplos backends em subdomínios diferentes
• Use blocos upstream para balanceamento de carga entre backends
• Verifique error.log se receber 502 Bad Gateway