blog
Painéis

Conectar o MySQL Workbench na hospedagem sem erro 2003, 1130 ou 1045

Onde achar o host correto no cPanel, como autorizar o IP da sua internet e o que cada código de erro do Workbench está realmente dizendo.

JR · · 12 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: o Workbench precisa do nome ou IP do servidor na porta 3306, nunca localhost em conexão direta (no túnel SSH, 127.0.0.1 é de propósito), mais o seu IP público cadastrado em MySQL Remoto no cPanel. Falta rede dá erro 2003, host não autorizado dá 1130, usuário ou senha dá 1045.

Neste artigo
  1. Por que localhost só funciona dentro do servidor
  2. Onde pegar o host e a porta corretos
  3. Liberar o IP da sua internet em MySQL Remoto
  4. Configurar a conexão no MySQL Workbench
  5. Os três erros 2003, 1130 e 1045, traduzidos
  6. Por que o curinga % transforma seu banco em porta aberta
  7. Quando o IP da sua operadora muda sozinho
  8. Checklist antes de mexer em dados de produção

Você abre o MySQL Workbench, digita localhost no campo Hostname, usa o mesmo usuário e senha que estão no wp-config.php e recebe um erro numerado. O problema quase nunca é a senha. É que localhost significa "esta máquina aqui", e a máquina que está rodando o Workbench é o seu computador, não o servidor da hospedagem.

Este guia resolve as três barreiras que aparecem nessa ordem: descobrir o endereço certo do servidor, autorizar o IP da sua internet no cPanel e interpretar o código de erro que sobrar. Tudo apoiado na documentação oficial do cPanel para MySQL Remoto. Os endereços e IPs usados abaixo são exemplos fictícios; troque pelos seus.

Por que localhost só funciona dentro do servidor

Quando o WordPress da sua hospedagem conecta no banco, ele usa localhost porque o PHP e o MySQL estão na mesma máquina. A conexão nem sai para a rede: ela passa por um socket local.

O Workbench rodando no seu notebook é outro cenário. A conexão precisa sair da sua internet, atravessar a internet pública, chegar na porta 3306 do servidor e ser aceita pelo MySQL. São três permissões diferentes, e cada uma falha com um código próprio:

  1. O firewall do servidor precisa aceitar sua origem na porta 3306.
  2. O MySQL precisa reconhecer o host de onde a conexão vem (é isso que o MySQL Remoto do cPanel configura).
  3. O usuário do banco precisa existir, ter a senha certa e ter privilégio naquele banco.

Guarde uma exceção que aparece mais adiante: no túnel SSH você vai digitar 127.0.0.1 de propósito, porque nesse caso a conexão realmente parte de dentro do servidor. Em conexão direta, localhost está sempre errado.

Quem tenta Workbench, Power BI, DBeaver ou um sistema hospedado em outro servidor tropeça nas etapas 1 e 2 antes de chegar na 3. É por isso que o clássico erro 1044 de privilégio nem aparece: você para antes.

As três camadas entre o Workbench e o bancoFirewallAceita sua origem na porta 3306MySQL RemotoReconhece o host de onde vemUsuário do bancoExiste, senha certa, privilégio no banco
Conexão direta atravessa três permissões independentes. Cada uma falha com um código próprio.

Onde pegar o host e a porta corretos

Entre no cPanel. Na coluna da direita da tela inicial, procure o painel Informações gerais (ou *General Information*). Ali aparece o Endereço IP compartilhado do servidor. Esse IP é uma opção válida de host.

Tem três candidatos a host, em ordem de preferência:

Host que você digita Quando usar Risco
Nome do servidor (ex.: srv123.exemplo.com.br) Preferido: se o IP do servidor mudar, o nome continua resolvendo Precisa saber o nome exato do servidor
IP do servidor (ex.: 203.0.113.10) Quando você só tem o IP em mãos Se o servidor migrar de IP, a conexão quebra sem aviso
Seu próprio domínio (ex.: meusite.com.br) Só se o domínio aponta direto para o servidor Se você usa Cloudflare ou outro proxy, o domínio resolve para o proxy e a conexão nunca chega no MySQL

Esse último caso engana muita gente. Com proxy ativo, meusite.com.br responde ping normalmente, mas quem responde é o proxy, que não repassa tráfego MySQL. O sintoma é um timeout puro (erro 2003) mesmo com tudo liberado no cPanel.

A porta padrão do MySQL é 3306. Deixe esse valor no Workbench a menos que seu provedor informe outra porta.

Teste a porta 3306 antes de abrir o Workbench

Vale gastar dez segundos para saber se a etapa 1 passou. No Windows, abra o PowerShell e rode:

Test-NetConnection -ComputerName srv123.exemplo.com.br -Port 3306

O que procurar na saída: a linha TcpTestSucceeded. Se vier True, a porta está alcançável da sua internet. Se vier False, o problema é rede ou firewall, e nenhuma configuração de usuário no cPanel vai resolver.

No macOS ou Linux, o equivalente:

nc -vz srv123.exemplo.com.br 3306

Resultado esperado quando funciona: uma linha dizendo que a conexão para a porta 3306 teve sucesso (succeeded). Quando não funciona, a ferramenta fica parada alguns segundos e retorna timeout ou Connection refused.

Liberar o IP da sua internet em MySQL Remoto

A documentação do cPanel descreve a interface MySQL Remoto como o lugar onde você define quais hosts podem acessar os bancos de dados da sua conta. Sem essa liberação, o MySQL recusa a conexão mesmo com usuário e senha corretos.

Descubra o IP público da sua conexão

O IP que interessa não é o 192.168.x.x do seu roteador. É o IP público da sua conexão. Abra o navegador e pesquise por "qual é o meu IP"; qualquer serviço desses devolve o número. Anote.

Abra o MySQL Remoto no cPanel

Na tela inicial do cPanel, seção Bancos de dados, clique em MySQL Remoto (*Remote MySQL*).

Cadastre o IP como host de acesso

No campo Host, cole o IP público que você anotou. No campo Comentário, escreva algo que você entenda daqui a seis meses, por exemplo escritorio-workbench. Clique em Adicionar host.

O IP aparece na lista abaixo, com um botão para remover. Guarde isso: remover é tão simples quanto adicionar, e você vai querer remover quando o trabalho terminar.

Confira se o usuário existe e quais privilégios ele tem

Ainda em Bancos de dados, entre em Bancos de dados MySQL. Role até Usuários atuais e confira se o usuário que você vai usar no Workbench está listado.

Para saber se esse usuário já tem acesso ao banco, olhe a tabela Bancos de dados atuais, mais acima na mesma página: cada linha traz o nome do banco e, na coluna de usuários privilegiados, quem tem acesso a ele. É ali que a associação existente aparece, e é clicando no nome do usuário dentro dessa tabela que se abre a tela de privilégios. O formulário Adicionar usuário ao banco de dados serve para criar uma associação nova, não para conferir uma que já existe.

Crie um usuário só de SELECT para essa tarefa

Recomendação prática: não use no Workbench o mesmo usuário que está no wp-config.php. Crie um usuário só para essa tarefa e dê a ele apenas o que ele precisa.

  1. Em Bancos de dados MySQL, seção Adicionar novo usuário, crie por exemplo conta_leitura com uma senha forte gerada ali mesmo.
  2. Desça até Adicionar usuário ao banco de dados, escolha o usuário novo e o banco do site, e clique em Adicionar.
  3. O cPanel abre a tela Gerenciar privilégios do usuário. Não marque ALL PRIVILEGES. Marque apenas SELECT. Se o banco tiver views, marque também SHOW VIEW. Clique em Fazer alterações.

Esse usuário consegue consultar tudo e não consegue alterar nada: qualquer UPDATE, DELETE ou DROP volta com erro de privilégio. É a rede de proteção certa para quem vai olhar dados, exportar relatório ou depurar uma tabela.

Se em algum momento você precisar escrever no banco, volte a essa mesma tela de privilégios (pela tabela Bancos de dados atuais, clicando no nome do usuário na linha do banco) e marque INSERT, UPDATE e DELETE conforme a necessidade, faça o trabalho e desmarque depois. Escrever sem backup recente é o único passo deste guia que não tem volta; a última seção trata disso.

Configurar a conexão no MySQL Workbench

Criar a conexão nova

Na tela inicial do Workbench, clique no sinal + ao lado de MySQL Connections.

Quais campos preencher em Standard (TCP/IP)

Testar a conexão e anotar o número do erro

Clique em Test Connection. Se aparecer a mensagem de conexão bem sucedida, clique em OK e a conexão fica salva. Se aparecer um erro, anote o número dele: é o que a próxima seção decifra.

Ative Safe Updates antes do primeiro UPDATE

Ainda dentro do Workbench, vá em Edit > Preferences > SQL Editor e confirme que Safe Updates está marcado. Com essa opção ativa, o Workbench recusa um UPDATE ou DELETE sem cláusula WHERE que use chave. É a diferença entre errar uma query e perder uma tabela.

Os três erros 2003, 1130 e 1045, traduzidos

Código Mensagem típica O que realmente falhou Onde corrigir
2003 Can't connect to MySQL server on 'host' (10060) A conexão TCP não chegou na porta 3306. Firewall, host errado, proxy no meio ou porta bloqueada na sua rede Confirme o host com o teste de porta; verifique se o domínio não está atrás de proxy; teste de outra internet
1130 Host 'seu.ip' is not allowed to connect to this MySQL server A porta respondeu, mas o MySQL não reconhece sua origem MySQL Remoto no cPanel: o IP que aparece na mensagem é exatamente o que você precisa cadastrar
1045 Access denied for user 'conta_usuario'@'seu.ip' (using password: YES) Rede e host liberados. Usuário inexistente, senha errada ou usuário sem privilégio no banco Bancos de dados MySQL no cPanel: redefina a senha do usuário e confira a associação em Bancos de dados atuais

A ordem importa. Não adianta mexer em usuário enquanto o erro é 2003, e não adianta trocar senha enquanto o erro é 1130. Cada número aponta uma camada só.

Dois detalhes que economizam tempo:

Qual erro você recebeu e onde corrigirErro 2003Rede: teste a porta, revise host e proxyErro 1130Cadastre no MySQL Remoto o IP da mensagemErro 1045Redefina a senha e confira privilégiosConectouAtive Safe Updates e faça backup
Resolva na ordem: cada número aponta uma camada só.

Por que o curinga % transforma seu banco em porta aberta

A documentação do cPanel para MySQL Remoto descreve o uso do caractere curinga % para representar hosts. Um % sozinho no campo Host significa qualquer host. Qualquer um. Toda a internet.

O que isso muda na prática: com % cadastrado, seu banco passa de "só respondo para o IP do meu escritório" para "respondo para qualquer máquina do planeta que tentar". A única coisa entre um scanner automatizado e seus dados passa a ser a senha do usuário do banco. E scanners varrendo a porta 3306 são rotina na internet pública, não exceção.

Duas consequências concretas:

Se você já cadastrou % para "ver se era isso", volte ao MySQL Remoto e remova agora. Depois cadastre o IP específico.

Curinga parcial na faixa de IP, o meio termo aceitável

Quando o IP da operadora muda dentro de uma faixa previsível, dá para usar o curinga de forma parcial, por exemplo 203.0.113.%, autorizando o último octeto inteiro daquela faixa. Continua sendo mais frouxo que um IP único, mas é uma diferença enorme em relação a %. Teste, e se a faixa não bater, volte ao IP fixo do momento.

Quando o IP da sua operadora muda sozinho

Conexão residencial e link de fibra sem IP fixo trocam de endereço: em geral na reconexão do modem, em manutenção da operadora ou em intervalos definidos por ela. Você configura tudo, funciona, e três dias depois o Workbench devolve 1130 sem você ter mudado nada.

Quatro caminhos, do mais simples ao mais robusto:

  1. Recadastrar quando quebrar. Abra a mensagem de erro 1130, pegue o IP que ela mostra, cole no MySQL Remoto, remova o antigo. Leva um minuto. É o suficiente se você acessa o banco uma vez por mês.
  2. Usar o curinga parcial da faixa. Descrito acima. Reduz a frequência do recadastro.
  3. Túnel SSH. No Workbench, em vez de Standard (TCP/IP), escolha Standard TCP/IP over SSH. Você preenche o host SSH e suas credenciais SSH, e nos campos de MySQL usa 127.0.0.1 e porta 3306. Aqui o 127.0.0.1 está certo, e é a única situação em que está: a conexão com o banco passa a sair de dentro do próprio servidor, então "esta máquina aqui" volta a ser o servidor e você não precisa liberar IP nenhum no MySQL Remoto. Depende de a hospedagem oferecer acesso SSH na sua conta.
  4. phpMyAdmin. Está em Bancos de dados no cPanel, roda dentro do servidor e não exige liberação de IP. Não tem o editor visual do Workbench, mas resolve consulta, export e ajuste pontual sem abrir porta para fora.

Observação honesta: nem todo provedor libera a porta 3306 para a internet, por decisão de segurança do firewall. Nesse caso, o teste de porta vai falhar com 2003 independentemente do que você cadastre no MySQL Remoto, e o caminho é túnel SSH ou phpMyAdmin. Vale perguntar ao suporte se a porta está aberta antes de gastar a tarde depurando.

Checklist antes de mexer em dados de produção

O Workbench conectado no banco do site em produção é uma ferramenta afiada. Um UPDATE sem WHERE na tabela wp_options derruba o site em um clique, e não existe Ctrl+Z.

Antes de rodar qualquer coisa que escreva:

Depois de terminar o trabalho:

A conexão remota é útil e é reversível nos dois sentidos: você libera em três cliques e revoga em um. O hábito de fechar depois de usar custa menos que descobrir, meses depois, que o banco estava aceitando conexão do mundo inteiro.

Referências

  1. Documentação oficial (cpanel) — Remote MySQL (cPanel). Consultado em 2026-09-15.
Leia também