Listar e apagar usuários de banco no cPanel sem derrubar site
Um inventário reutilizável que prova, arquivo por arquivo, qual usuário MySQL ainda sustenta um site no ar e qual sobrou de instalação removida.

Resposta curta: Faça a limpeza em 6 etapas, com 7 dias de quarentena entre revogar o privilégio e excluir o usuário. Antes disso, cruze a lista de Usuários atuais do cPanel com um grep por DB_USER, DB_USERNAME e $user nos wp-config.php, configuration.php e .env da conta.
Neste artigo
- Onde o cPanel e o WHM listam todos os usuários de banco
- O inventário de três colunas que prova quem usa o quê
- Como achar o usuário dentro dos arquivos de configuração com um grep
- Revogar, esperar sete dias, só então excluir
- O que fazer quando o site cai mesmo assim
- Convenções que impedem novos usuários órfãos
Conta de agência acumula usuário de banco como gaveta acumula cabo. Cada site instalado criou um usuário, cada migração criou outro, cada teste de staging criou mais um. Dois anos depois o cpuser_ tem uma lista de vinte nomes e ninguém sabe quais ainda estão em uso.
Apagar por intuição é como derrubar site de cliente numa sexta-feira. O processo abaixo prova, com arquivo de configuração na mão, quem usa o quê, antes de qualquer DROP USER.
Onde o cPanel e o WHM listam todos os usuários de banco
Na conta cPanel, a lista vive em Bancos de Dados MySQL (MySQL Databases). A tela mostra duas coisas separadas que a maioria confunde: a seção de bancos, com os usuários atualmente associados a cada um, e a seção Usuários atuais, com todos os usuários criados na conta, inclusive os que não estão associados a banco nenhum.
É essa segunda lista que interessa. Usuário sem nenhum banco associado na tela do cPanel é candidato forte a órfão, mas confirme pelo WHM se ele não tem grants concedidos fora do painel: privilégio dado por root, por dump de migração ou por linha de comando continua valendo no MySQL sem aparecer ali.
No lado do servidor, a documentação oficial do WHM, em Manage Database Users, descreve a interface que lista os usuários de banco por conta e permite renomear, alterar senha e excluir. A mesma documentação trata o caso dos usuários que existem no MySQL mas não estão mapeados a uma conta cPanel, situação típica de migração feita por dump em vez de transferência de conta.
Se você administra o servidor, essa é a visão que resolve o resto: usuário que aparece no MySQL e não aparece no cPanel do cliente não é gerenciável pelo cliente, e vai continuar invisível até alguém olhar pelo WHM.
Por que o prefixo da conta entrega a origem do usuário
No cPanel, usuário e banco carregam o prefixo da conta (loja_wp, loja_wpuser). Quando o prefixo bate com a conta mas o sufixo não lembra nenhum site, suspeite de instalação removida. Quando o nome não tem prefixo nenhum, suspeite de criação manual por linha de comando em uma migração antiga.
O inventário de três colunas que prova quem usa o quê
A planilha que resolve isso tem três colunas. Faça uma por conta cPanel e guarde no drive do cliente, porque daqui a um ano você vai precisar de novo.
| Usuário MySQL | Banco associado | Arquivo que declara este usuário |
|---|---|---|
| loja_wp01 | loja_wp01 | /home/loja/public_html/wp-config.php |
| loja_jml | loja_joomla | /home/loja/old/configuration.php |
| loja_dev | (nenhum) | não encontrado |
| loja_app | loja_app | /home/loja/api/.env |
Os nomes acima são exemplo fictício, só para mostrar o formato. O que importa é a terceira coluna: usuário sem arquivo que o declare é o alvo da limpeza. Usuário com arquivo é intocável até você conversar com quem mantém aquele site.
Como achar o usuário dentro dos arquivos de configuração com um grep
Com acesso SSH, um único grep recursivo resolve a terceira coluna da tabela. As três diretivas que cobrem a maioria dos sites PHP são DB_USER (WordPress), $user (Joomla) e DB_USERNAME (Laravel e derivados do .env).
grep -R -n -E 'DB_USER|DB_USERNAME|\$user' /home/USUARIO/ \
--include='wp-config.php' \
--include='configuration.php' \
--include='.env'
As aspas simples no padrão não são preciosismo: entre aspas duplas o shell expande $user antes de chamar o grep, o padrão chega sem o termo do Joomla e a busca falha em silêncio, exatamente no caso que você quer cobrir.
Se o resultado vier vazio para um site que você sabe que existe, provavelmente a configuração está em outro arquivo (um config.php próprio, um include separado). Repita sem o --include, limitando ao diretório daquele site:
grep -R -l "NOME_DO_USUARIO" /home/USUARIO/public_html/
Sem SSH, o Gerenciador de Arquivos do cPanel tem busca por conteúdo. É mais lento, mas faz o mesmo trabalho: você procura o nome exato do usuário e vê se algum arquivo o menciona.
Três lugares onde o grep não encontra o usuário
Três lugares escapam de uma busca em public_html:
- Cron jobs. Um script de backup ou de integração pode passar
-u usuariona linha de comando. Confira a lista de tarefas cron da conta. - Aplicações fora do docroot. Pastas como
/home/usuario/appou/home/usuario/scriptsnão entram se você limitar a busca ao site público. - Conexões externas. Um BI, um ERP ou um app de outro servidor podem usar aquele usuário com host remoto liberado. O arquivo de configuração nem está nessa máquina.
Por isso a etapa seguinte existe.
Revogar, esperar sete dias, só então excluir
Excluir usuário é irreversível do ponto de vista da senha: você não recupera o hash, e vai ter que criar outro e editar o arquivo do site. Revogar privilégio é reversível em trinta segundos.
Faça nesta ordem.
Congele o estado atual antes de mexer
Anote, para cada usuário suspeito, a quais bancos ele está associado e com quais privilégios. Na tela de bancos do cPanel, o botão de gerenciar privilégios mostra isso. Print na planilha. Sem esse registro, voltar atrás vira adivinhação.
Faça backup do banco envolvido
Um mysqldump ou um backup parcial pelo cPanel. Não é pelo usuário, é porque você vai mexer em permissão de produção e o custo de um dump é baixo.
Revogue os privilégios em vez de apagar o usuário
No cPanel, remova a associação entre o usuário suspeito e o banco (ou desmarque todos os privilégios). O usuário continua existindo, com a mesma senha. Se algum site dependia dele, o erro aparece, e devolver o acesso é marcar a caixa de novo.
Espere sete dias antes de excluir
Sete dias cobrem o ciclo semanal: relatório de segunda, rotina de domingo, cron de fechamento. Rotina mensal pede trinta dias. Esse período de quarentena é recomendação de processo, não resultado de medição.
Exclua o usuário pelo cPanel ou pelo WHM
Passada a janela sem reclamação, exclua pelo cPanel (ou, se o usuário não estiver mapeado à conta, pelo WHM, conforme a interface descrita na documentação de Manage Database Users). Marque a data na planilha.
Guarde o inventário para a próxima limpeza
O arquivo final vale mais que a limpeza em si, porque ele é o ponto de partida da próxima.
O que fazer quando o site cai mesmo assim
O sintoma clássico do WordPress é a tela "Erro ao estabelecer uma conexão com o banco de dados". Diagnóstico em três cenários, nesta ordem.
| Sintoma | Causa provável | Ação |
|---|---|---|
| Erro de conexão logo após revogar | Usuário ainda em uso por este site | Reassocie o usuário ao banco com os privilégios que você anotou |
| Erro de conexão dias depois, só numa rotina | Cron ou integração externa usava o usuário | Reassocie e corrija o script para o usuário oficial do site |
| Erro após excluir o usuário | Senha perdida junto com o usuário | Crie usuário novo, associe ao banco, atualize o arquivo de configuração |
No terceiro caso, o conserto é criar um usuário, conceder ALL PRIVILEGES sobre o banco daquele site e editar DB_USER e DB_PASSWORD no wp-config.php (ou o equivalente no configuration.php e no .env). Leva poucos minutos quando você tem a planilha e sabe exatamente qual arquivo tocar. Leva uma tarde quando não tem.
A frase pronta para avisar o cliente
Se o site chegou a cair, não invente explicação técnica longa. Funciona assim:
"Durante uma manutenção de segurança, removemos acessos de banco de dados que não eram mais usados por nenhum sistema. Um deles ainda era usado por uma rotina antiga, e o acesso foi restabelecido. O site voltou ao normal e nenhum dado foi perdido."
É verdade, é curto e não transforma faxina em incidente.
Convenções que impedem novos usuários órfãos
A limpeza resolve o passado. A convenção resolve o futuro.
- Um usuário por aplicação, nunca por pessoa. Nome que descreve o site (
conta_lojawp), não quem criou. - Staging com usuário próprio. Clonar o site e reaproveitar o usuário de produção é o que gera metade da confusão depois.
- Privilégio mínimo que funcione. WordPress precisa de
ALL PRIVILEGESno próprio banco para atualizar plugin e tema; script de relatório que só lê deve terSELECT. - Removeu o site, remova o par. Ao desinstalar uma aplicação, apague banco e usuário no mesmo dia. Órfão nasce no intervalo entre as duas tarefas.
- Revisão semestral. Agende no calendário da agência. Com o inventário salvo, a segunda rodada custa uma fração da primeira.
Usuário órfão raramente derruba site sozinho, mas é superfície de ataque com senha antiga e, pior, é o que faz a próxima migração dar errado. Limpar com prova documental custa uma hora por conta. Limpar no chute custa o domingo.
Referências
- Documentação oficial (cpanel) — WHM Manage Database Users. Consultado em 2026-10-14.