# 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.

> 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.

João Rizzon · 2026-09-21 · Painéis

---

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](https://docs.cpanel.net/cpanel/databases/remote-mysql/). 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:

```powershell
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:

```bash
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_leitura` com 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 vier `NO`, 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 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.
- **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 que `conexao2`.
- **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 `UPDATE` em um `SELECT` com o mesmo `WHERE` e olhe quantas linhas voltam. Se voltar mais do que você esperava, o `WHERE` está 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.

