Como conectar uma aplicação externa a um banco de dados remoto da sua hospedagem
Oi! Aqui é a Sensei da GeHost 🥋 Hoje vou te ensinar um papo que costuma assustar quem não é da área de tecnologia, mas que na prática é bem tranquilo: como fazer uma aplicação de fora (um sistema no seu computador, um app, uma automação, um serviço em nuvem etc.) conversar com o banco de dados MySQL que está dentro da sua hospedagem GeHost.
Vou te guiar passo a passo, com calma, do jeitinho que eu explicaria pra você aqui do meu lado. Bora lá?
Antes de tudo: por que isso não funciona "direto"?
Por segurança, o banco de dados da sua hospedagem só aceita conexões de dentro do próprio servidor, a não ser que você libere explicitamente o acesso remoto. Isso é ótimo pra sua proteção (evita que qualquer um tente acessar seu banco pela internet), mas significa que você precisa fazer uma pequena liberação antes de ligar sua aplicação externa a ele.
Dica da Sensei: só libere acesso remoto se você realmente precisa que uma aplicação de fora acesse o banco. Se o sistema que usa esse banco está hospedado dentro da própria GeHost (o site, por exemplo), você não precisa fazer nada disso — a conexão interna já funciona sozinha.
Passo 1 — Acesse o cPanel
Entre no painel de controle da sua hospedagem (cPanel) com o usuário e senha que você recebeu da GeHost.
Passo 2 — Confira se o banco de dados já existe
Dentro do cPanel, procure o grupo de ferramentas de Banco de Dados e entre em "Bancos de Dados MySQL". É lá que você:
- Cria um banco de dados novo (se ainda não tiver um);
- Cria um usuário de banco de dados (login e senha específicos pra esse banco — não é o mesmo login do cPanel);
- Vincula esse usuário ao banco, com as permissões que ele vai precisar (leitura, escrita, etc.);
Se você já tem o banco e o usuário criados, pode pular direto pro próximo passo.
Passo 3 — Libere o acesso remoto (Remote MySQL)
Ainda na área de Banco de Dados do cPanel, procure a ferramenta chamada "Remote MySQL" (às vezes aparece como "MySQL Remoto" ou "Acesso Remoto ao Banco de Dados"). É nela que você autoriza de onde a conexão externa pode vir.
- Você vai encontrar um campo pra adicionar um "Host de acesso";
- Informe o endereço de IP (ou faixa de IPs) da aplicação/servidor que vai se conectar ao banco. É esse IP externo que precisa estar liberado — sem ele, a conexão é recusada mesmo com usuário e senha corretos;
- Salve a liberação.
Dica da Sensei: evite liberar "qualquer IP" (%) a não ser que você saiba exatamente o que está fazendo — quanto mais restrito o acesso, mais seguro fica seu banco de dados. Se a sua aplicação roda num serviço de nuvem com IP fixo, use esse IP fixo. Se o IP mudar com frequência, vale conversar com quem cuida da sua aplicação sobre como obter um IP fixo pra essa conexão.
Passo 4 — Reúna os dados de conexão
Com o banco criado, o usuário vinculado e o acesso remoto liberado, agora é só configurar a sua aplicação externa com os dados de conexão:
- Servidor/host do banco: o endereço que você usa para acessar sua hospedagem (consulte no seu contrato, no e-mail de boas-vindas ou direto no painel.gehost.com.br caso tenha dúvida);
- Nome do banco de dados: o nome que você definiu no Passo 2;
- Usuário e senha do banco: os que você criou no Passo 2 (não confunda com o login do cPanel);
- Porta: a porta padrão do MySQL costuma ser usada nesse tipo de conexão — se sua aplicação pedir uma porta específica e você tiver dúvida, é só chamar o nosso suporte.
Com esses dados na mão, é só preencher a configuração de conexão da sua aplicação (geralmente numa tela ou arquivo chamado algo como "configurações de banco de dados" ou "database settings") e testar.
Passo 5 — Teste a conexão
Depois de configurar tudo, faça um teste simples de conexão pela própria aplicação. Se não conectar de primeira, respire fundo — é super comum, e geralmente é um dos três motivos abaixo:
- O IP liberado no Remote MySQL não é exatamente o IP de onde a aplicação está se conectando;
- O usuário do banco não está vinculado corretamente ao banco (ou não tem as permissões necessárias);
- Algum dado de conexão (host, usuário, senha ou nome do banco) foi digitado com erro de digitação.
Precisa de uma mãozinha?
Se você já seguiu os passos e ainda não conseguiu conectar, pode contar com a gente! Todo serviço GeHost tem suporte gratuito por 30 dias após a entrega, e depois disso você também pode acionar nosso time normalmente pelo painel. Abra um chamado contando exatamente onde travou (qual mensagem de erro apareceu, se possível) que a gente te ajuda a destravar rapidinho.
Dica final da Sensei: guarde os dados de conexão (host, banco, usuário, senha) num lugar seguro — como um gerenciador de senhas — e evite deixá-los "hardcoded" (escritos direto) no código da sua aplicação, principalmente se esse código for compartilhado ou publicado em algum repositório.
Prontinho! Agora sua aplicação externa já sabe como bater na porta certa do seu banco de dados 🚪✨ Qualquer dúvida, é só chamar a gente.