Como configurar um túnel SSH (port forwarding) pra acessar um serviço interno

Túnel SSH: o canal secreto pra acessar serviços internos com segurança

Oi! Aqui é a Sensei da GeHost 🧘‍♀️ Hoje vamos falar de um truque avançado, mas que depois de aprendido vira rotina: o túnel SSH, também chamado de port forwarding. Com ele, você consegue acessar um serviço que só "enxerga" o servidor por dentro — como um banco de dados, um painel administrativo ou uma aplicação que roda numa porta específica — como se ele estivesse rodando no seu próprio computador, de forma criptografada e segura.

O que é, na prática?

Imagine que existe um serviço rodando dentro do servidor, numa porta que não é exposta diretamente pra internet (por segurança). O túnel SSH cria um "cano" criptografado entre o seu computador e o servidor, e redireciona uma porta local do seu PC pra essa porta interna. Assim, você abre o navegador (ou outro programa) apontando pro seu próprio localhost, e por trás dos panos o tráfego passa em segurança até o servidor.

💡 Dica da Sensei: pense no túnel SSH como um "elevador de serviço" — ele não abre a porta da frente pra todo mundo, só cria uma passagem privada entre você e o serviço que você já tem permissão de acessar.

Antes de começar: o que você precisa

• Ter acesso SSH liberado na sua conta de hospedagem (isso depende do seu plano — confira no painel.gehost.com.br ou fale com o suporte pra confirmar se seu plano inclui SSH).
• Usuário e senha (ou chave SSH) da sua conta.
• Saber qual é a porta interna do serviço que você quer acessar (normalmente quem te passa essa informação é o desenvolvedor da aplicação ou o próprio manual do serviço).
• Um cliente SSH: no Linux e no Mac já vem pronto no Terminal; no Windows, recomendamos o PuTTY (gratuito) ou o Terminal do Windows com OpenSSH.

Passo a passo — Linux ou macOS (Terminal)

1. Abra o Terminal.
2. Digite o comando abaixo, substituindo os dados pelos seus:

   ssh -L 8080:localhost:PORTA_INTERNA seu_usuario@seudominio.com.br

3. Explicando o comando:
   • 8080 → é a porta que vai abrir no seu computador (pode escolher outra livre, tipo 8081, 9000 etc.).
   • PORTA_INTERNA → é a porta do serviço lá dentro do servidor (pergunte ao suporte ou ao responsável pela aplicação).
   • seu_usuario@seudominio.com.br → é o seu login SSH, exatamente como você usa pra acessar o servidor normalmente.
4. Digite sua senha (ou confirme a chave, se usar autenticação por chave) quando for solicitado.
5. Pronto! Deixe esse terminal aberto (o túnel funciona enquanto essa janela estiver ativa) e abra o navegador em: http://localhost:8080

Passo a passo — Windows (com PuTTY)

1. Abra o PuTTY e, no campo Host Name, digite seu domínio (ex: seudominio.com.br).
2. No menu à esquerda, vá em Connection → SSH → Tunnels.
3. No campo Source port, digite a porta que vai abrir no seu PC (ex: 8080).
4. No campo Destination, digite localhost:PORTA_INTERNA (troque pela porta do serviço).
5. Clique em Add e depois role até o topo e clique em Open pra conectar.
6. Faça login com seu usuário e senha SSH.
7. Com a sessão aberta, vá no navegador em http://localhost:8080 — o serviço interno vai aparecer como se estivesse rodando no seu próprio computador.

Quando esse recurso é útil?

• Acessar um banco de dados que só aceita conexões locais do servidor, direto do seu programa de gerenciamento de banco (ex: MySQL Workbench, DBeaver).
• Testar uma aplicação ou API que roda numa porta não pública, antes de liberar pro mundo.
• Acessar painéis internos de administração sem precisar deixá-los expostos na internet.

⚠️ Fique de olho: o túnel SSH depende do seu plano ter acesso SSH liberado. Se der erro de conexão recusada logo de início (antes mesmo de pedir senha), pode ser que o SSH não esteja habilitado pro seu plano — nesse caso, é só chamar o suporte pra confirmar.

Erros comuns (e como resolver)

• "Connection refused" na hora de abrir localhost:8080 → confira se o terminal com o túnel ainda está aberto. Fechar a janela derruba o túnel.
• "Permission denied" → revise usuário, senha ou chave SSH. Se persistir, confirme com o suporte se o SSH está ativo na sua conta.
• A porta local já está em uso → escolha outra porta livre no seu PC (troque o "8080" por "8081", por exemplo).

É isso! Com esse "cano seguro" montado, você acessa serviços internos sem expor nada pra internet — e ainda de forma criptografada de ponta a ponta. Qualquer dúvida na hora de descobrir a porta certa do seu serviço, chama o suporte pelo painel. 🌱