Trocar senha de cPanel pelo WHM sem derrubar o site
O que marcar "Sync MySQL password" realmente faz, o que perde credencial no mesmo minuto e o inventário para rodar antes de clicar.

Resposta curta: a troca é imediata e sem aviso. Antes de clicar, decida o "Sync MySQL password": marcado, ele muda também a senha do usuário MySQL homônimo e pode derrubar o site até você atualizar o wp-config.php. Rode o inventário de 10 minutos primeiro.
Neste artigo
- O que o WHM muda de fato quando você troca a senha pelo painel
- Quando marcar e quando desmarcar o Sync MySQL password
- O que para de funcionar no mesmo minuto da troca
- Inventário de 10 minutos antes de clicar em trocar
- Checklist de execução, em ordem
- A frase pronta para avisar o cliente antes da troca
- Erros que aparecem depois da troca e o que cada um significa
- Padronizando a troca de senha em carteira de vários sites
O que o WHM muda de fato quando você troca a senha pelo painel
Em Account Functions > Password Modification, você escolhe a conta cPanel, digita a nova senha e confirma. A documentação oficial do cPanel descreve essa interface como a forma de alterar a senha de uma conta cPanel a partir do WHM, sem precisar da senha antiga e sem entrar na conta.
Duas coisas importam para quem administra conta de terceiro:
- A troca vale para o usuário do sistema. É a mesma credencial que entra no cPanel, no webmail pelo login de cPanel, no FTP da conta principal e no SSH, quando habilitado.
- Existe a caixa Sync MySQL password (sincronizar a senha do MySQL). A documentação do cPanel descreve esse controle como a opção para que a senha do MySQL do usuário seja alterada junto com a senha da conta. Marcar ou não muda o alcance do estrago.
Não há tela de confirmação por e-mail, não há janela de carência, não há "aplicar em 5 minutos". É imediato e silencioso: nada avisa o cliente, nada avisa o desenvolvedor que mantém o deploy, nada avisa o script de backup remoto. Por isso o trabalho real não é clicar no botão, é o inventário de dez minutos antes de clicar.
Quando marcar e quando desmarcar o Sync MySQL password
O usuário MySQL que leva o mesmo nome da conta cPanel (o usuário "dono" dos bancos) é o que entra na sincronização. Usuários de banco adicionais, criados em MySQL Databases com sufixo (conta_wp, conta_app), não são alterados pela troca da senha da conta.
| Situação | Sync MySQL marcado | Sync MySQL desmarcado |
|---|---|---|
| Vazamento de senha, credencial possivelmente exposta inteira | Recomendado: a senha do usuário MySQL homônimo também muda | Deixa uma credencial conhecida pelo invasor ativa no banco |
| Saída de funcionário que tinha só acesso ao painel | Opcional | Suficiente se ele nunca teve a string de conexão |
| Site que conecta ao banco com usuário homônimo da conta | Vai derrubar o site até você atualizar wp-config.php |
Site continua no ar |
| Site que conecta com usuário de banco dedicado | Não afeta o site | Não afeta o site |
A regra prática que eu uso: em resposta a incidente, marque. Em troca de rotina ou higiene de acesso, desmarque e trate a senha do banco separadamente, no próprio cPanel, com usuário dedicado por aplicação.
Se marcar, assuma que o site pode cair. O tempo entre a troca e a atualização do wp-config.php é indisponibilidade real, com erro de conexão com o banco de dados na tela. Isso precisa estar combinado com o cliente antes, não depois.
O que para de funcionar no mesmo minuto da troca
Lista nominal, para você conferir item a item:
- Sessões abertas do cPanel do cliente e de quem mais tiver o login. O comportamento esperado é que a sessão aberta deixe de valer logo após a troca, mas não testamos isso e a página de Password Modification não descreve esse comportamento: confirme no seu servidor antes de prometer ao cliente.
- Webmail acessado pelo login da conta cPanel. Contas de e-mail individuais (
contato@dominio) têm senha própria e não são afetadas. - Conta FTP principal, aquela cujo usuário é o próprio nome da conta cPanel. Contas FTP adicionais criadas no cPanel mantêm as senhas delas.
- Acesso SSH/SFTP por senha, se o plano permitir. Chave pública continua funcionando.
wp-config.php,.env,config/database.phpe qualquer arquivo comDB_PASSWORD, se você marcou Sync MySQL e a aplicação usa o usuário homônimo.- Backup remoto puxado por FTP/SFTP com o usuário da conta: rotinas em Jetpack, UpdraftPlus apontando para o próprio servidor, rsync em cron de outra máquina, agregador da agência.
- Deploy por Git ou CI que autentica por SSH com senha, ou que usa credencial FTP salva no runner.
- Integrações que autenticam como usuário da conta: monitoramento que faz login no cPanel, plugin de migração com credencial FTP salva, cliente FTP do próprio cliente (FileZilla com senha gravada), gerenciador de sites da agência.
- API cPanel com token: a documentação de Password Modification não trata do assunto, e não testamos esse comportamento. Se alguma automação sua depende disso, teste um token logo após a troca. Vale também conferir se alguém montou automação com login e senha em vez de token, porque essa para na hora.
O item que mais pega gente desprevenida é o backup remoto puxado por FTP/SFTP. O backup quebra em silêncio e ninguém percebe até precisar restaurar.
Inventário de 10 minutos antes de clicar em trocar
Faça isto com acesso ao cPanel da conta ou por SSH como root. O objetivo não é auditoria completa, é não quebrar nada que você conseguiria descobrir em dez minutos.
Descobrir qual usuário de banco a aplicação usa
# no diretório do site
grep -i "DB_USER\|DB_PASSWORD\|DB_NAME" wp-config.php
Se DB_USER for igual ao nome da conta cPanel, marcar Sync MySQL derruba o site. Se tiver sufixo (conta_wp), não derruba.
Varrer os outros arquivos de configuração atrás de senha
grep -rl "DB_PASSWORD\|DB_PASS\|mysqli_connect" \
/home/USUARIO/public_html --include="*.php" --include=".env" | head -20
Troque USUARIO pelo nome da conta. Rode também em subpastas de staging e em subdomínios: é lá que mora a instalação esquecida que ninguém lembra de atualizar.
Listar as contas FTP adicionais, que sobrevivem à troca
No cPanel, FTP Accounts. Anote quais existem. As adicionais sobrevivem à troca, e isso é útil: se o cliente precisa continuar subindo arquivo enquanto você resolve o resto, dê uma conta FTP dedicada em vez de devolver a senha principal.
Conferir o cron da conta atrás de credencial na linha
crontab -u USUARIO -l
Procure por mysqldump, rsync, curl com credencial na linha. Cada ocorrência é uma coisa que vai parar.
Três perguntas ao cliente antes de gerar a senha nova
- Quem mais tem a senha do cPanel hoje.
- Se existe algum backup ou sincronização configurado fora do servidor.
- Se alguma agência ou freelancer anterior ainda tem acesso.
Esses dez minutos não são burocracia. Eles decidem se a troca é um clique ou uma noite de suporte.
Checklist de execução, em ordem
- Rodar o inventário acima e anotar o que vai quebrar.
- Avisar o cliente com a frase pronta da próxima seção.
- Gerar a senha nova em gerenciador de senhas, não no teclado.
- No WHM, Account Functions > Password Modification, selecionar a conta, colar a senha, decidir o Sync MySQL conforme a tabela.
- Se marcou Sync, atualizar imediatamente
DB_PASSWORDemwp-config.phpe nos demais arquivos que ogrepdo inventário listou. - Abrir o site em aba anônima e confirmar que carrega, incluindo uma página dinâmica e o
/wp-admin. - Refazer login no cPanel com a senha nova.
- Reconfigurar FTP salvo, deploy e backup remoto com a credencial nova.
- Entregar a senha ao cliente por canal que não seja e-mail em texto puro.
- Agendar uma conferência do backup em 24 horas. É o item que falha calado.
Em resposta a incidente, acrescente dois passos depois de decidir o Sync MySQL e antes de atualizar o wp-config.php: revisar os endereços de encaminhamento de e-mail da conta e revisar contas FTP e usuários de banco adicionais. Quem entrou costuma deixar uma porta secundária, e trocar só a senha principal dá sensação de resolvido sem resolver.
A frase pronta para avisar o cliente antes da troca
Use antes, não depois. Adapte o nome e a janela:
Se você vai marcar Sync MySQL e o site usa o usuário homônimo, troque a última frase por: "o site pode ficar alguns minutos fora do ar durante a atualização, e eu aviso assim que voltar". Dizer antes que vai cair custa uma mensagem. Dizer depois custa a confiança.
Erros que aparecem depois da troca e o que cada um significa
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Error establishing a database connection" no WordPress | Sync MySQL marcado e wp-config.php com a senha antiga |
Atualizar DB_PASSWORD no arquivo |
| Cliente FTP dá erro de autenticação | Senha salva na conta FTP principal | Atualizar no cliente, ou criar conta FTP adicional |
| Webmail recusa login | Acesso era pelo login da conta cPanel | Entrar com o endereço de e-mail completo e a senha da caixa |
| Backup externo para de rodar sem erro visível | Credencial FTP/SFTP antiga no serviço remoto | Reconfigurar e forçar uma execução de teste |
| Deploy por Git falha na autenticação | Senha no runner de CI | Trocar para chave SSH, que não depende de senha |
| Script interno de banco falha | Usava o usuário MySQL homônimo | Criar usuário de banco dedicado para o script |
A correção preventiva para metade dessa tabela é a mesma: não use a credencial principal da conta para nada automatizado. Usuário de banco dedicado por aplicação, conta FTP adicional por fornecedor, chave SSH para deploy. Feito assim, trocar a senha do cPanel volta a ser o que deveria: um clique que não derruba nada além das sessões abertas.
Padronizando a troca de senha em carteira de vários sites
Se você mantém dezenas de contas, transforme o inventário em padrão e não em memória:
- Uma planilha por cliente com: nome da conta cPanel, usuário de banco usado por cada site, contas FTP adicionais e para quem foram, onde o backup é enviado, se o deploy usa chave ou senha.
- Convenção de nome de usuário de banco que deixe óbvio que não é o homônimo da conta. Ao bater o olho em
conta_lojav2, você já sabe que o Sync MySQL não vai derrubar aquele site. - Chave SSH no lugar de senha em todo deploy, sem exceção. É o item que mais reduz retrabalho em troca de credencial.
- Uma data fixa de rotação, por exemplo na renovação anual do contrato, com a mesma frase de aviso. Troca prevista não gera chamado.
- Procedimento separado para incidente, com Sync MySQL marcado por padrão e a revisão de encaminhamentos de e-mail e usuários adicionais incluída. Em incidente, a pressa é inimiga do checklist, então o checklist tem que estar escrito antes.
O WHM entrega o poder de trocar a senha de qualquer conta sem conhecer a anterior. O que ele não entrega é a lista do que depende daquela senha. Essa lista é sua, e vale mais mantida do que reconstruída às pressas.
Referências
- Documentação oficial (cpanel) — Password Modification (WHM). Consultado em 2026-10-22.