Como configurar um proxy reverso com Nginx na frente de uma aplicação Node.js

Como configurar um proxy reverso com Nginx na frente de uma aplicação Node.js

Olá, viajante do servidor! Se você está aqui, provavelmente quer deixar sua aplicação Node.js mais segura, rápida e acessível por um domínio real — e o proxy reverso com Nginx é a pedra angular para isso. Não se preocupe: mesmo que você não seja um especialista, comigo, a Sensei da GeHost, você vai dominar isso passo a passo, com calma, clareza e um toque de humanidade.

Imagine o Nginx como um porteiro inteligente: ele recebe todas as requisições do mundo, verifica se são legítimas, redireciona para sua aplicação Node.js (que fica escondida na porta 3000, 5000 ou outra) e devolve a resposta com segurança. Sem ele, sua aplicação ficaria exposta — e isso não é bom.

Dica da Sensei: Você pode usar o Nginx mesmo sem saber programar. Ele é como um "manual de instruções" para o tráfego da sua aplicação.

Passo 1: Garanta que sua aplicação Node.js está rodando

Antes de tudo, certifique-se de que sua aplicação Node.js está funcionando localmente e escutando em uma porta específica (geralmente 3000, 5000 ou 8080). Você pode testar isso com um comando simples no terminal:

node app.js

Se você vir uma mensagem como Escutando na porta 3000, está tudo certo! Se não estiver rodando, verifique o arquivo de entrada (geralmente index.js ou app.js) e certifique-se de que ele está iniciando o servidor.

Passo 2: Acesse o cPanel (seu portão de controle)

Para configurar o Nginx, você precisará de acesso ao cPanel da sua conta na GeHost. É aqui que você gerencia arquivos, domínios, bancos de dados e muito mais.

Insira suas credenciais e clique em Log in. Após o login, você verá a tela principal do cPanel.

Passo 3: Acesse o Gerenciador de Arquivos

Seu aplicativo Node.js deve estar dentro da pasta public_html (ou em uma subpasta como app ou node-app). Vamos acessar essa pasta para ver o que temos.

1. Clique em Arquivos no cPanel.
2. Selecione Gerenciador de Arquivos.
3. Na lista de pastas, clique em public_html (ou a pasta onde sua aplicação está).

Passo 4: Crie um arquivo de configuração Nginx

O Nginx precisa de um arquivo de configuração para saber como redirecionar as requisições. Ele se chama nginx.conf e deve estar na raiz da sua conta (ou em uma pasta especial). Na GeHost, esse arquivo é gerenciado via Configuração de Servidor.

Como o Nginx não está diretamente visível no cPanel, usamos um atalho: o arquivo de configuração personalizado que a GeHost permite.

1. Volte ao cPanel.
2. Procure por Configuração de Servidor (pode estar em "Avançado" ou "Outros").
3. Clique em Configuração de Servidor Nginx.

Se essa opção não aparecer, não se preocupe — ela pode estar escondida. Siga com o próximo passo.

Passo 5: Configure o proxy reverso com Nginx

Agora vem o coração da magia. Você vai escrever um bloco de configuração que diz ao Nginx: "Quando alguém pedir meu domínio, encaminhe para minha aplicação Node.js".

Abra o editor de configuração e cole o seguinte conteúdo (substitua seu-domínio.com pelo seu domínio real):

server {
    listen 80;
    server_name seu-domínio.com www.seu-domínio.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;
    }
}

Dica da Sensei: Troque 3000 pela porta que sua aplicação Node.js está usando. Se não souber, verifique o código da aplicação (geralmente `app.listen(3000)`).

Passo 6: Teste e ative a configuração

Depois de colar o código, salve a configuração. O Nginx será recarregado automaticamente, mas você pode esperar alguns segundos.

Abra seu navegador e acesse http://seu-domínio.com. Se tudo estiver certo, sua aplicação Node.js deve aparecer!

Atenção: Se não funcionar, verifique:

• Se a aplicação Node.js está rodando no servidor.
• Se a porta está correta (3000, 5000, etc.).
• Se o domínio está apontando para o servidor (DNS).

Passo 7: Adicione HTTPS (segurança) — opcional, mas recomendado

Para deixar tudo ainda mais seguro, você pode habilitar HTTPS. Na GeHost, isso é fácil:

1. No cPanel, vá até SSL/TLS Certificates.
2. Clique em Gerar Certificado SSL (ou use o Let's Encrypt).
3. Selecione seu domínio e siga as instruções.

Depois de instalar, atualize a configuração Nginx para usar listen 443 ssl e adicione os certificados. Mas isso já é um passo avançado — e você já está no caminho certo!

Conclusão: Você é o mestre agora

Parabéns, viajante! Você acaba de configurar um proxy reverso com Nginx — uma das ferramentas mais poderosas do mundo do desenvolvimento web. Sua aplicação Node.js agora está protegida, acessível por um domínio real e pronta para o mundo.

Se tiver dúvidas, não hesite: venha até o nosso suporte da GeHost. Aqui, você não está sozinho. Sempre há uma Sensei pronta para ajudar.

Com carinho, A Sensei da GeHost