Proxy reverso com Nginx: o guia completinho da Sensei 🥋
Oi! Eu sou a Sensei da GeHost, e hoje vamos falar de um assunto um pouquinho mais "avançado" (mas eu prometo explicar com calma, sem juridiquês técnico): o proxy reverso com Nginx. Se você tem uma aplicação rodando (tipo um sistema em Node.js, Python, ou qualquer coisa que "escute" numa porta diferente da 80/443) e quer que ela apareça bonitinha no seu domínio, é isso que a gente vai configurar. Vem comigo! 💛
O que é um proxy reverso, afinal?
Pensa assim: o proxy reverso é como um "recepcionista" do seu servidor. Quando alguém acessa o seu domínio, ele não fala direto com a sua aplicação — ele bate na porta do Nginx primeiro, e o Nginx decide pra onde mandar aquele pedido (pra sua aplicação, rodando numa porta interna, por exemplo). Isso é super comum quando você tem:
- Uma aplicação em Node.js, Python, Java etc. rodando numa porta própria (tipo 3000, 8080...);
- Vários serviços/apps que precisam conviver no mesmo domínio ou subdomínios;
- A necessidade de ter SSL, cache ou regras de acesso na "porta de entrada", sem precisar mexer na aplicação em si.
💡 Dica da Sensei: se você não sabe se a sua aplicação já roda numa porta própria (ou nem sabe o que isso significa, e tudo bem, ninguém nasce sabendo!), me chama que eu te ajudo a entender o seu cenário antes de sair mexendo em configuração.
Antes de começar: qual é o seu tipo de acesso?
Esse é o pulo do gato, viu? Configurar um Nginx "na unha" (editando arquivos de configuração de servidor) é uma tarefa de nível de servidor, e o tipo de acesso que você tem no seu plano faz toda a diferença:
- Se você tem uma aplicação (Node.js, por exemplo) que pode ser gerenciada pelo painel, o cPanel costuma oferecer uma ferramenta própria de "Configurar Aplicativo" que já cuida da ponte entre o seu domínio e a sua aplicação, sem você precisar escrever configuração de Nginx manualmente. Verifique no seu painel se essa opção aparece pra você — ela pode variar conforme o plano contratado.
- Se o seu cenário exige mesmo editar a configuração do Nginx diretamente (acesso mais avançado ao servidor), essa é uma mudança de bastidor que pode impactar outros serviços se for feita errado — então o ideal é abrir um chamado com o nosso suporte técnico pra a gente avaliar seu caso com carinho e fazer isso com segurança.
Passo a passo (visão geral)
- Identifique onde sua aplicação vai rodar. Anote a porta interna que ela usa (isso normalmente está na documentação da própria aplicação, ex.: "roda na porta 3000").
- Confirme o domínio ou subdomínio que vai apontar pra essa aplicação. Se for um subdomínio novo (ex.: app.seudominio.com.br), você vai precisar criá-lo antes — isso é feito no Editor de Zona de DNS ou na área de Domínios do seu painel.
- Configure a "ponte" (o proxy em si). Dependendo do seu tipo de acesso (veja o tópico acima), isso é feito:
- pela ferramenta de aplicativo do painel (mais simples, recomendado pra quem não mexe com servidor no dia a dia); ou
- via configuração manual do Nginx (recomendamos que nosso suporte técnico faça essa parte com você, pra garantir que nada quebre em outros sites/serviços do servidor).
- Teste o acesso pelo domínio/subdomínio configurado, verificando se a aplicação responde corretamente.
- Ative o certificado SSL pro domínio/subdomínio, pra sua aplicação rodar com https:// — isso é feito na área de SSL/TLS do seu painel.
💡 Dica da Sensei: sempre teste primeiro num subdomínio (tipo teste.seudominio.com.br) antes de apontar o domínio principal pra sua aplicação nova. Assim, se algo não sair como esperado, seu site principal continua no ar tranquilamente.
Quando chamar o suporte
Se em algum momento você sentir que está mexendo em algo "de bastidor" demais — configuração de servidor, arquivos de sistema, regras de Nginx — pode (e deve!) chamar a gente. Toda entrega da GeHost já vem com 30 dias de suporte gratuito após a conclusão, e depois disso o nosso time também está sempre à disposição pelo painel.
🙋 Dica da Sensei: na dúvida entre arriscar mexer sozinho ou chamar a gente, chama a gente. Prefiro te ajudar com calma a te ver perder tempo (ou travar o site!) tentando decifrar uma configuração de servidor sozinho(a). Estamos aqui pra isso 💛
