Como configurar um túnel SSH para acessar o banco de dados com segurança

Túnel SSH: o jeito seguro de acessar o banco de dados do seu site

Oi! Aqui é a Sensei da GeHost 🥋 Se você chegou até aqui, provavelmente precisa conectar um programa (tipo o MySQL Workbench, o DBeaver ou o TablePlus) direto no banco de dados do seu site — pra consultar tabelas, exportar dados ou debugar alguma coisa com mais liberdade do que o phpMyAdmin oferece.

A boa notícia: dá pra fazer isso com segurança, sem deixar a porta do banco de dados exposta pra internet inteira. É exatamente isso que um túnel SSH faz — ele cria um "corredor" criptografado entre o seu computador e o servidor, e faz o seu programa de banco de dados conversar com o servidor como se estivesse tudo rodando na sua própria máquina. Ninguém no meio do caminho consegue bisbilhotar.

Pensa assim: em vez de abrir uma porta na sua casa pra qualquer entregador entrar, você cria um "corredor privado" só entre você e a encomenda. Só quem tem a chave certa passa por ali.

Antes de começar: o que você precisa ter em mãos

• Acesso SSH liberado na sua hospedagem. Nem todo plano vem com isso ativado por padrão — se você tentar conectar e não conseguir, fale com o nosso suporte pra confirmar/liberar o acesso SSH da sua conta.
• Usuário e senha (ou chave) de SSH — geralmente é o mesmo usuário do cPanel. Se tiver dúvida de qual é o seu, veja em painel.gehost.com.br ou peça pro suporte confirmar.
• O nome do banco de dados e o usuário do banco — isso você encontra dentro do cPanel, na ferramenta "Bancos de Dados MySQL".
• Um programa de terminal (no Mac/Linux o próprio Terminal já serve; no Windows, recomendamos o PuTTY) ou um cliente de banco de dados que já tenha a opção de túnel SSH embutida (MySQL Workbench, TablePlus e DBeaver têm essa opção pronta — é o caminho mais fácil pra quem não curte linha de comando).

Passo 1 — Confirme os dados do seu banco no cPanel

Entre no seu cPanel e vá até "Bancos de Dados MySQL". Lá você vai ver o nome do banco (geralmente algo como usuario_nomedobanco) e o(s) usuário(s) vinculado(s) a ele. Anote esses dados — você vai precisar deles daqui a pouco.

Se você não sabe o nome exato do seu banco ou do usuário, é só olhar aqui — não precisa adivinhar nem inventar. E se a lista estiver vazia ou você não reconhecer nenhum banco, chame o suporte antes de seguir.

Onde encontrar essa ferramenta no cPanel

Caso você nunca tenha entrado no cPanel antes: depois de fazer login, a tela inicial mostra vários grupos de ferramentas (E-mail, Arquivos, Bancos de Dados etc.). É só procurar o ícone de "Bancos de Dados MySQL" dentro do grupo de Banco de Dados.

Passo 2 — Abrindo o túnel SSH

Aqui você tem dois caminhos. Escolha o que for mais confortável pra você — os dois chegam no mesmo lugar.

Caminho A — Pelo terminal (Mac, Linux ou Windows com PowerShell/WSL)

Abra o terminal e digite o comando abaixo, trocando os dados em maiúsculo pelos seus:

1. USUARIO_SSH → o seu usuário de SSH/cPanel
2. SERVIDOR → o endereço do seu servidor (o mesmo que você usa pra acessar o cPanel — confirme com o suporte se tiver dúvida)
3. PORTA_SSH → a porta de SSH da sua hospedagem (o suporte informa se for diferente da padrão)

ssh -L 3306:localhost:3306 USUARIO_SSH@SERVIDOR -p PORTA_SSH

Depois de digitar sua senha (ou usar sua chave SSH), o túnel fica aberto e "escutando" na porta 3306 do seu próprio computador. Deixe essa janela do terminal aberta — é ela que mantém o corredor funcionando.

Caminho B — Direto pelo cliente de banco de dados (mais fácil pra quem é leigo)

Programas como MySQL Workbench, TablePlus e DBeaver já vêm com um campo de configuração chamado "SSH Tunnel" ou "Conexão via SSH" na tela de nova conexão. Você só preenche:

• SSH Host / Servidor: o endereço do seu servidor
• SSH Port: a porta de SSH informada pelo suporte
• SSH User: seu usuário de SSH/cPanel
• SSH Password (ou chave privada): sua senha ou arquivo de chave
• MySQL Host: localhost (ou 127.0.0.1)
• MySQL Port: 3306

O programa cuida de abrir o túnel sozinho, sem você precisar mexer em terminal nenhum. 🙌

Passo 3 — Conectando no banco de dados

Com o túnel aberto (Caminho A ou B), agora é só configurar a conexão do seu banco de dados normalmente, mas apontando para:

• Host: localhost (ou 127.0.0.1)
• Porta: 3306
• Usuário: o usuário do banco que você anotou no Passo 1
• Senha: a senha desse usuário do banco
• Banco de dados: o nome que você anotou no Passo 1

Se tudo estiver certo, o programa conecta como se o banco estivesse rodando no seu próprio computador — só que, por trás, todo o tráfego está passando protegido dentro do túnel SSH. ✨

Boas práticas de segurança

Aqui vai o carinho da Sensei: banco de dados guarda informação sensível de verdade (de clientes, pedidos, tudo). Trate essas credenciais como trataria a senha do seu banco de verdade, tá?

• Feche o túnel quando terminar — no terminal, basta fechar a janela ou apertar Ctrl+C.
• Nunca compartilhe sua senha de SSH ou do banco por e-mail ou chat sem necessidade — se precisar passar pra alguém do time, prefira canais seguros.
• Prefira usar chave SSH em vez de senha sempre que possível — é mais seguro e evita ataques de força bruta.
• Nunca exponha a porta do banco de dados diretamente pra internet. O túnel SSH existe exatamente pra evitar isso — é assim que a gente recomenda acessar o banco remotamente.

Deu errado? Aqui vão as pancadas mais comuns

• "Connection refused" ao tentar o SSH: o acesso SSH pode não estar liberado no seu plano ainda — fale com o suporte pra confirmar/ativar.
• "Access denied" ao conectar no banco: confira se o usuário do banco (Passo 1) tem permissão sobre aquele banco específico dentro do cPanel, em "Bancos de Dados MySQL".
• Túnel abre mas o banco não conecta: confirme se você realmente está apontando o cliente de banco pra localhost:3306 e não pro endereço do servidor direto.

Travou em algum ponto? Sem estresse — é só chamar a gente pelo painel.gehost.com.br que a equipe te ajuda a destravar. 💚