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.

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
- Por que localhost só funciona dentro do servidor
- Onde pegar o host e a porta corretos
- Liberar o IP da sua internet em MySQL Remoto
- Configurar a conexão no MySQL Workbench
- Os três erros 2003, 1130 e 1045, traduzidos
- Por que o curinga % transforma seu banco em porta aberta
- Quando o IP da sua operadora muda sozinho
- 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:
- O firewall do servidor precisa aceitar sua origem na porta 3306.
- O MySQL precisa reconhecer o host de onde a conexão vem (é isso que o MySQL Remoto do cPanel configura).
- 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.
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.
- Em Bancos de dados MySQL, seção Adicionar novo usuário, crie por exemplo
conta_leituracom uma senha forte gerada ali mesmo. - Desça até Adicionar usuário ao banco de dados, escolha o usuário novo e o banco do site, e clique em Adicionar.
- 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)
- Connection Name: um apelido, por exemplo
Hospedagem - meusite. - Connection Method:
Standard (TCP/IP). - Hostname: o nome do servidor ou o IP (o que você definiu na seção anterior).
- Port:
3306. - Username: o usuário do banco, com o prefixo da conta, no formato
conta_usuario. - Password: clique em Store in Vault e digite a senha.
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:
- O erro 1130 costuma mostrar o IP que o servidor viu. Se ele não é o IP que você cadastrou, sua internet trocou de IP ou você está atrás de outra saída de rede (VPN corporativa, 4G do celular, rede do coworking). Cadastre o IP que a mensagem mostra.
- No 1045, repare no trecho
using password: YES. Se vierNO, o Workbench não enviou senha nenhuma, geralmente porque o campo ficou vazio no Vault. Reabra a conexão e redigite.
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:
- O erro 1130 desaparece para todo mundo, inclusive para quem você não conhece. Você perde o próprio mecanismo de defesa que estava tentando configurar.
- Ataque de força bruta contra senha de banco não deixa rastro no log do WordPress. Você não vai perceber pelo painel.
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:
- 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.
- Usar o curinga parcial da faixa. Descrito acima. Reduz a frequência do recadastro.
- 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 usa127.0.0.1e porta3306. Aqui o127.0.0.1está 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. - 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:
- Faça backup do banco. No cPanel, em Backup ou Assistente de Backup, baixe o backup dos bancos MySQL. Confirme que o arquivo terminou de baixar e tem tamanho plausível.
- Confirme em qual conexão você está. Se você tem homologação e produção salvas no Workbench, os nomes das conexões precisam ser óbvios.
Hospedagem - PRODUCAOé melhor apelido queconexao2. - Confirme com qual usuário você está. Se o usuário só tem SELECT, o pior que acontece é um erro de privilégio. Se você acabou de liberar UPDATE para essa tarefa, a rede de proteção saiu do ar.
- Rode como SELECT primeiro. Transforme o
UPDATEem umSELECTcom o mesmoWHEREe olhe quantas linhas voltam. Se voltar mais do que você esperava, oWHEREestá errado. - Mantenha Safe Updates ligado. O erro que ele gera é chato e é exatamente o ponto.
Depois de terminar o trabalho:
- Volte ao MySQL Remoto e remova o IP que você cadastrou, se não vai usar amanhã. Acesso liberado esquecido é superfície de ataque parada.
- Se liberou privilégio de escrita só para a tarefa, entre em Bancos de dados MySQL e, na tabela Bancos de dados atuais, clique no nome do usuário na linha do banco correspondente. Isso abre Gerenciar privilégios do usuário, onde você desmarca INSERT, UPDATE e DELETE e clica em Fazer alterações. Os checkboxes não ficam em "Usuários atuais": naquela lista só dá para trocar senha, renomear ou excluir o usuário.
- Se criou usuário só para a tarefa, remova em Bancos de dados MySQL > Usuários atuais.
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
- Documentação oficial (cpanel) — Remote MySQL (cPanel). Consultado em 2026-09-15.