MySQL remoto: como conectar seu site a um banco externo
Conecte o seu site a um banco MySQL em outro servidor: escuta, usuário por host, privilégios mínimos, firewall, TLS, teste com o cliente e os erros 1130 e 2003.
Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: MySQL remoto: como conectar seu site a um banco externo Arte: Eleven Host
O MySQL remoto deixa um site ou aplicativo usar um banco de dados que está em outro servidor, pela porta 3306. Veja quando isso faz sentido, o que precisa estar certo (escuta, usuário, firewall e TLS), como testar e como resolver os erros 1130 e 2003.
Quando um banco remoto faz sentido
O banco remoto entra em cena quando o site e o banco ficam em máquinas diferentes: por exemplo, uma aplicação numa VPS que usa um banco hospedado em outro servidor. Em troca, a conexão passa pela rede, e é nela que mora o risco. Se você ainda não decidiu qual servidor de banco usar, veja o comparativo entre MySQL e MariaDB.
Os comandos deste texto seguem o manual do MySQL 8.4, que traz os detalhes de bind_address, de usuários e de TLS. Em 05/11/2026, as séries LTS do MySQL são a 8.4 (versão 8.4.13) e a 9.7 (versão 9.7.4), e o MySQL 8.0 chegou ao fim da vida em abril de 2026. Para outras versões e para o MariaDB, confira o manual da versão instalada, porque há diferenças, indicadas ao longo do texto.
O manual do MySQL diz que a porta 3306 não deve ficar acessível a hosts não confiáveis e que dados sem cifra não devem trafegar pela internet. Deixar a porta aberta para a internet inteira é o erro que este caminho evita.
1. Faça o servidor escutar na rede
No MySQL 8.4, o padrão de bind_address é *, que aceita conexões TCP/IP em todas as interfaces IPv4 do servidor e, se houver suporte, nas IPv6. Se o servidor foi iniciado com bind_address em 127.0.0.1, ele escuta só na interface local e não aceita conexões remotas. A variável não é dinâmica: mudar o valor exige reiniciar o servidor.
No MariaDB, muitos pacotes vêm com a escuta em 127.0.0.1. A documentação mostra a troca abaixo no arquivo de configuração e aceita também o IP específico do servidor, e o MariaDB 10.11 ou mais novo aceita vários endereços. Recomendamos o IP específico em vez do endereço aberto:
bind-address = 0.0.0.0
#bind-address = 127.0.0.1
Para achar o arquivo ativo, use mariadbd --help --verbose. Depois de editar o arquivo, reinicie o serviço do banco; um exemplo de comando, para conferir no seu servidor, é sudo systemctl restart mariadb. Para conferir o resultado, use mariadbd --print-defaults.
2. Crie um usuário com host específico
No MySQL, a conta é o par usuário e host. O manual mostra o formato com o host depois do arroba e aceita o IP do cliente, uma máscara ou a notação CIDR. Os curingas % e _ no host são permitidos, mas estão marcados como obsoletos e sujeitos a remoção. O manual também orienta a não dar mais privilégios do que o necessário e a não conceder privilégios sem restrição de host.
Um exemplo, para conferir no seu servidor, em que 198.51.100.20 é o IP do site (um endereço de documentação) e appdb é o banco:
CREATE USER 'app'@'198.51.100.20' IDENTIFIED BY 'SENHA_FORTE' REQUIRE SSL;
GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO 'app'@'198.51.100.20';
O REQUIRE SSL do exemplo exige conexão cifrada, então o passo 4 precisa estar pronto antes do primeiro teste. O GRANT mínimo do exemplo cobre as operações de leitura e escrita de dados, sem criar nem apagar tabelas. Ajuste-o ao que a aplicação realmente faz. No MySQL, depois do GRANT o servidor recarrega as permissões sozinho, e o FLUSH PRIVILEGES é para quando as tabelas de permissões são editadas diretamente.
3. Libere a porta só para o IP do site
O manual manda investir em um firewall. A documentação do MariaDB traz um exemplo que abre a porta 3306 sem restrição de origem, e esse formato não deve ser usado na internet. Um exemplo de comandos que liberam a porta apenas para o IP do site, para conferir no servidor do banco (use o que corresponde ao firewall que você tem):
sudo ufw allow from 198.51.100.20 to any port 3306 proto tcp
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="198.51.100.20" port port="3306" protocol="tcp" accept'
sudo firewall-cmd --reload
4. Ative o TLS na conexão
Os servidores MySQL compilados com OpenSSL podem gerar sozinhos, na inicialização, os certificados e as chaves que faltam. A autoridade certificadora gerada assim é autoassinada. No MariaDB, a partir da versão 11.4, o servidor liga o TLS sozinho.
Há duas formas de exigir conexão cifrada no servidor. Por conta, com REQUIRE SSL, como no exemplo do passo 2: se a conexão segura não puder ser feita, a tentativa falha. Para o servidor inteiro no MySQL, com a variável require_secure_transport (um exemplo de comando, para conferir no seu servidor):
SET PERSIST require_secure_transport=ON;
No MariaDB, a conta existente recebe a exigência com ALTER USER e REQUIRE SSL.
No cliente do MySQL, o modo padrão é PREFERRED, que volta para a conexão sem cifra se não conseguir cifrar. Os modos mais fortes são:
REQUIRED: a tentativa falha se a conexão cifrada não puder ser feita;VERIFY_CA: como o anterior, e ainda confere o certificado da autoridade certificadora;VERIFY_IDENTITY: como o anterior, e ainda confere o nome do host.
Cifrar não é o mesmo que verificar
O manual indica o VERIFY_CA e o VERIFY_IDENTITY como escolhas melhores que o padrão contra o ataque do homem no meio. O VERIFY_IDENTITY não funciona com o certificado autoassinado gerado pelo servidor. Atenção: sem um modo VERIFY_* não há checagem do certificado, então o REQUIRED cifra o tráfego, mas não prova que o servidor é quem diz ser.
O cliente mariadb não tem a opção --ssl-mode; nele, a verificação do certificado do servidor vem ligada por padrão desde a versão 11.4.
5. Teste a conexão com o cliente
Primeiro, veja se a porta responde. Os dois manuais usam o telnet para isso. Um exemplo de comando, rodado a partir do servidor do site:
telnet db.exemplo.com.br 3306
Depois, conecte com o cliente, a partir do servidor do site. Um exemplo de comando para o MySQL, com as opções do manual e com o ca.pem (o certificado da autoridade certificadora do servidor do banco, copiado para a máquina do site), que você deve conferir no seu servidor:
mysql --host=db.exemplo.com.br --port=3306 --user=app --password --ssl-mode=VERIFY_CA --ssl-ca=ca.pem appdb
Deixe o --password sem valor: o manual avisa que passar a senha na linha de comando pode permitir que outros usuários do sistema a vejam. No MariaDB, a documentação usa este formato, sem --ssl-mode:
mariadb --host=myhost --protocol=tcp --port=3306 test
O custo de um banco de dados entra na sua conta? 11SQL a partir de R$ 9,90/mês no 11SQL Mini; confira na loja o que cada plano inclui. Ver o 11SQL
Erros comuns: 1130 e 2003
O erro 1130 (Host is not allowed to connect to this MySQL server) significa que a conexão chegou ao servidor, mas nenhuma linha da tabela de usuários tem um host que combine com o do cliente. A correção é criar a conta para aquele par de usuário e host. No MariaDB, o erro aparece quando nenhuma conta tem um componente de host que combine, e o nome do usuário não influi. Com o usuário errado num host que combina, vem o erro 1045. A mensagem mostra o host que o servidor enxergou, e é esse valor que deve entrar na conta. O guia do erro 1130 detalha o caso. Se a falha for de permissão num banco depois de conectar, veja o erro 1044.
Com TLS no MariaDB, o 1130 pode vir embrulhado num erro 2002, com a mensagem de que um pacote de erro foi recebido antes do fim do handshake de TLS.
O erro 2003 (Can't connect to MySQL server) indica que a conexão de rede foi recusada. O manual orienta conferir se o servidor está rodando, se as conexões de rede estão habilitadas e se a porta é a configurada. A mesma página trata de outros motivos de falha na conexão: o skip_networking ligado, o bind_address em 127.0.0.1 e a porta bloqueada por firewall. Como regra prática, recomendamos separar assim: 2003 é rede, porta ou escuta; 1130 é permissão da conta para aquele host.
A distância entre o site e o banco
Recomendamos medir a distância entre o site e o banco antes de colocar o sistema no ar: esse trajeto pode pesar em cada consulta, e só a medição no seu caso diz o quanto. O manual do MySQL trata de dois pontos de desempenho que aparecem em conexões remotas. Com DNS lento e muitos hosts, é possível ligar o skip_name_resolve, e então só valem as contas com IP. Já a compressão da conexão ajuda principalmente quando a banda é baixa e os resultados são grandes, porque ela custa processamento.
Quantos servidores o projeto vai ter? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Perguntas frequentes
Preciso deixar a porta 3306 aberta para a internet?
Não. O manual diz que a porta não deve ficar acessível a hosts não confiáveis. Libere-a só para o IP do site no firewall.
Posso usar % como host do usuário?
O manual permite o curinga, mas o marca como obsoleto e orienta a não conceder privilégios sem restrição de host. Recomendamos o IP do site.
O REQUIRE SSL prova que o servidor é o certo?
Não. Ele exige a conexão cifrada, mas só os modos VERIFY_CA e VERIFY_IDENTITY do cliente conferem o certificado.
Qual a diferença entre o erro 1130 e o 2003?
No 2003, a conexão de rede foi recusada. No 1130, ela chegou ao servidor, mas nenhuma conta tem um host que combine com o do cliente.