Como configurar um proxy reverso com Nginx na frente de uma aplicação em outra porta

Como configurar um proxy reverso com Nginx na frente de uma aplicação em outra porta

Olá, querido(a) cliente da GeHost! 👋

Se você está aqui, provavelmente tem uma aplicação rodando em outra porta (como 3000, 5000 ou 8080) e quer que ela seja acessível pelo seu domínio principal — sem precisar colocar a porta na URL. Isso é possível com um proxy reverso usando Nginx. E não se preocupe: mesmo que você não seja expert em servidores, eu, seu Sensei da GeHost, te levo passo a passo com calma, clareza e um toque de carinho.

💡 Dica do Sensei: O Nginx é como um "portão inteligente" que recebe as requisições do mundo todo e as direciona para a sua aplicação interna — sem que o usuário veja a porta. É seguro, rápido e muito usado!

Este guia é para clientes que já têm uma aplicação rodando em outra porta (ex: Node.js, Python, Ruby, etc.) e querem expô-la com segurança pelo domínio principal.

Pré-requisitos

Antes de começar, certifique-se de que:

• Você tem acesso ao painel da GeHost (painel.gehost.com.br).
• Seu domínio já está apontando para o servidor da GeHost (verifique isso no painel de DNS).
• Sua aplicação está rodando em uma porta diferente do padrão 80 (HTTP) ou 443 (HTTPS).
• Você tem permissão para usar arquivos de configuração personalizados (em hosts compartilhados, isso é possível via .htaccess ou arquivos de configuração específicos).

Passo a passo: Configurando o proxy reverso com Nginx

Como o Nginx é gerenciado internamente pela GeHost, você não configura ele diretamente no servidor. Em vez disso, usamos o arquivo de configuração personalizado no diretório da sua aplicação. Vamos lá:

1. Entre no painel da GeHost (painel.gehost.com.br) com suas credenciais.

2. Na página principal, clique em “Arquivos” e depois em “Gerenciador de Arquivos”.

3. Na barra de navegação, clique em “public_html” (ou o diretório onde sua aplicação está hospedada).
4. Crie um novo arquivo chamado nginx.conf dentro do diretório public_html.

Para isso, clique em “Criar Arquivo” no Gerenciador de Arquivos, digite nginx.conf no campo de nome e clique em “Criar”.

5. Abra o arquivo nginx.conf para edição e cole o seguinte conteúdo:

server {
    listen 80;
    server_name seu-domínio.com.br;  # Substitua pelo seu domínio

    location / {
        proxy_pass http://127.0.0.1:PORTA_DA_SUA_APLICACAO;  # Substitua pela porta da sua app
        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;
    }
}
  

6. Substitua os valores entre parênteses:
• seu-domínio.com.br → seu domínio real (ex: minhaempresa.com.br).
• PORTA_DA_SUA_APLICACAO → a porta onde sua aplicação está rodando (ex: 3000, 5000).
7. Salve o arquivo.
8. Se você quiser HTTPS (recomendado!), crie um novo arquivo chamado nginx-ssl.conf com o mesmo conteúdo, mas com listen 443 ssl; e adicione um certificado SSL (isso pode ser feito via SSL/TLS Certificates no painel).
9. Pronto! Agora, acesse seu domínio no navegador (ex: https://seu-domínio.com.br) e sua aplicação deve estar funcionando — sem a porta visível!

Como testar se está funcionando

Depois de configurar:

• Abra o navegador e vá para https://seu-domínio.com.br.
• Se a aplicação aparecer, parabéns! O proxy reverso está funcionando.
• Se não funcionar, verifique:
  • Se a porta da sua aplicação está correta.
  • Se a aplicação está realmente rodando (use o painel de Métricas para verificar).
  • Se o arquivo nginx.conf está no diretório correto e com o nome exato.

Dica do Sensei: Segurança e boas práticas

💡 Importante: Nunca exponha portas diretas na internet. O proxy reverso é a forma segura de fazer isso.

✅ Use HTTPS sempre que possível — seu domínio já pode ter certificado SSL instalado no painel.

✅ Evite usar portas muito baixas (ex: 80, 443) para sua aplicação. Prefira 3000, 5000, 8080, etc.

✅ Se precisar de ajuda, entre em contato com o suporte da GeHost — estamos aqui para te ajudar com carinho. 🌸

Quer saber mais?

Se quiser aprofundar, dê uma olhada no nosso centro de ajuda ou entre em contato com nosso time. Lembre-se: você não está sozinho nessa jornada.

Com carinho,
Seu Sensei da GeHost
— Raphael Neves Koga, dono da G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)