# Trocar a senha de root do MySQL sem derrubar os sites

Inventário dos consumidores da credencial, troca pela tela do WHM e validação dos quatro pontos, com checklist para repetir em cada servidor de cliente.

> a senha de root do MySQL não é usada pelo site, que tem usuário próprio. Em WHM/cPanel, troque em SQL Services » Change Database Root Password, inventarie antes os consumidores (painel, backup, phpMyAdmin e scripts próprios herdados) e valide cada um dentro da janela.

João Rizzon · 2026-10-07 · Servidores

---

A senha de root do MySQL (ou MariaDB) não aparece em nenhum `wp-config.php`. O WordPress do seu cliente usa um usuário dedicado, com permissão só no banco dele. Por isso a frase que mais se ouve antes de uma troca mal planejada é "se eu mexer no root, o site cai". Não cai por causa do site. Cai por causa de quem mais guarda essa credencial em arquivo.

Em servidor com WHM/cPanel, a troca é uma tela. O que exige método é o antes e o depois: saber quem consome o root e confirmar, dentro da janela, que cada consumidor voltou a conectar.

## Quem realmente usa a senha de root do MySQL

Três categorias de consumidor, e nenhuma delas é o site:

| Consumidor | Para que usa o root | O que acontece se a senha mudar sem ele saber |
|---|---|---||
| O próprio painel (WHM/cPanel) | criar e remover bancos e usuários, aplicar GRANT quando a conta cria um banco | criação de banco e de usuário via cPanel falha; o site existente continua no ar |
| Rotina de backup / dump | `mysqldump` de todos os bancos agendado em cron | backup falha silenciosamente e você só descobre quando precisa restaurar |
| phpMyAdmin e ferramentas de administração | login administrativo fora da conta cPanel | erro de acesso negado na hora exata em que alguém precisa olhar uma tabela |

Um quarto consumidor costuma existir nos servidores que a agência herdou: script próprio de migração, de sincronização de staging ou de limpeza de revisões, com usuário e senha escritos dentro do `.sh` ou do `.php`. Esse é o que quebra sem avisar.

## Onde procurar a credencial antes de trocar

Quinze minutos de inventário evitam o telefonema de domingo. Procure a credencial onde ela costuma ficar guardada em texto.

```bash
# arquivos de configuração que o painel usa para guardar a credencial de root
ls -l /root/.my.cnf /root/.my.cnf-* 2>/dev/null

# jobs agendados que invocam mysql ou mysqldump
crontab -l | grep -iE 'mysql|mariadb'
ls -l /etc/cron.d/ /etc/cron.daily/
grep -rliE 'mysqldump|mysql -u *root' /etc/cron.* /root/scripts 2>/dev/null

# scripts e configs com a palavra root perto de senha
grep -rliE 'password' /root/scripts /usr/local/bin 2>/dev/null
```

Anote cada ocorrência em uma linha só: caminho do arquivo, o que ele faz, com que frequência roda. Essa lista é o seu roteiro de validação depois. Se o servidor tem backup externo (agente de backup remoto, painel de terceiros, ferramenta de migração contratada pelo cliente), registre também: você vai precisar entrar nessa ferramenta e atualizar a senha lá.

Não esqueça do humano. Se o motivo da troca é a saída de um desenvolvedor, o inventário inclui gerenciadores de senha compartilhados e canais onde a credencial possa ter circulado em texto.

## Por que trocar pela tela do WHM e não por ALTER USER

A diferença é prática. Rodar `ALTER USER` direto no MySQL muda a senha no banco e só. Os arquivos que guardam a credencial para uso automático continuam com a senha antiga, e o painel perde acesso ao próprio servidor de banco.

A [documentação do WHM para Change Database Root Password](https://docs.cpanel.net/whm/database-services/change-database-root-password/) descreve a interface em **WHM » Home » SQL Services » Change Database Root Password**, onde você informa a nova senha e confirma. O caminho pelo painel existe justamente para que a troca seja propagada para a configuração que o sistema usa, em vez de deixar a senha dessincronizada entre o banco e os arquivos.

Regra de bolso para a agência: em servidor gerenciado por WHM/cPanel, root de banco se troca pela tela. Linha de comando fica para servidor sem painel, e aí o `/root/.my.cnf` é responsabilidade sua.

### Gere e guarde a senha antes de confirmar

Gere uma senha longa e aleatória, guarde no gerenciador antes de aplicar e só depois clique em confirmar. Senha perdida no meio da troca transforma uma tarefa de quinze minutos em recuperação de serviço.

### Que horário escolher para não truncar um dump

Escolha uma janela em que nenhum backup esteja rodando e ninguém esteja criando conta no cPanel. Dump em andamento que perde a conexão gera arquivo truncado que parece válido.

## Os quatro testes que fecham a janela

Não encerre a tarefa sem os quatro testes: três comandos e uma verificação manual. Eles levam poucos minutos e são a diferença entre "troquei" e "troquei e está funcionando".

```bash
# 1) o painel consegue autenticar com a credencial armazenada
mysql -e "SELECT VERSION();"

# 2) o dump funciona (teste pequeno, não o backup inteiro)
mysqldump --databases mysql --no-data > /tmp/teste_dump.sql && \
  tail -n 1 /tmp/teste_dump.sql

# 3) um site qualquer continua respondendo (usuário do site, não root)
curl -s -o /dev/null -w '%{http_code}\n' https://dominiodocliente.com.br/

# 4) manual, sem comando: criar e remover banco pelo WHM e abrir o phpMyAdmin
```

O `tail` do item 2 existe por um motivo: dump completo do `mysqldump` termina com uma linha de comentário de "Dump completed". Arquivo que termina no meio de um `INSERT` é dump quebrado.

O teste 4 é manual e não tem comando: entre no WHM, crie um banco de teste em uma conta de homologação e apague em seguida. Se o painel cria e remove o banco, a credencial que ele usa está correta. Depois, abra o phpMyAdmin pela conta cPanel e pelo acesso administrativo que a sua equipe usa.

## Checklist reutilizável por servidor

Copie isto para o seu runbook e repita igual em cada servidor de cliente.

- Registrar o motivo da troca (invasão, saída de dev, auditoria, rotação periódica) e a data.
- Inventariar consumidores: `/root/.my.cnf`, cron, scripts próprios, ferramentas externas de backup e migração.
- Confirmar que não há backup ou migração em execução.
- Gerar a senha nova e salvar no gerenciador de senhas da agência antes de aplicar.
- Trocar em **WHM » Home » SQL Services » Change Database Root Password**.
- Validar os quatro testes: conexão administrativa, dump de teste, resposta HTTP do site, criação e remoção de banco pelo painel mais login no phpMyAdmin.
- Atualizar a senha nas ferramentas externas listadas no passo 2.
- Rodar o backup agendado manualmente uma vez e conferir o arquivo gerado.
- Na manhã seguinte, conferir se o cron da madrugada produziu backup com tamanho compatível com o da véspera.
- Registrar no histórico do cliente: data, quem executou, quais serviços foram revalidados.

O passo 9 é o que mais se pula e o que mais dói. Backup que falha não emite ruído.

## O que fazer quando algo quebra dias depois

O sintoma quase sempre é acesso negado, e quase sempre aponta para um arquivo que ninguém lembrava.

| Sintoma | Causa provável | Onde olhar |
|---|---|---||
| cPanel não cria banco novo | credencial administrativa dessincronizada | refazer a troca pela tela do WHM, com a mesma senha |
| Backup noturno com tamanho zero | script próprio com senha antiga embutida | `grep` nos scripts do cron, atualizar e rodar manual |
| phpMyAdmin nega login administrativo | senha antiga no gerenciador da equipe | atualizar no gerenciador, não no servidor |
| Site do cliente fora do ar | não é o root: é o usuário do banco do site | `wp-config.php` e o log de erro do PHP |

A última linha merece atenção. Se um site caiu na mesma janela, a causa é outra coisa que aconteceu junto, não a troca do root. Verifique antes de reverter nada.

## O aviso que você manda ao cliente antes da janela

Use esta, inteira, por e-mail ou no chat, antes da janela:

> **** "Vamos girar a senha administrativa do servidor de banco de dados hoje, entre 22h e 23h. Essa senha não é usada pelo seu site: o site tem um usuário próprio e continua funcionando normalmente durante todo o procedimento. Ela é usada pelo painel do servidor, pela rotina de backup e pelas ferramentas de administração, e vamos testar os três logo depois da troca. Se algo precisar de atenção, avisamos ainda esta noite."

Funciona porque separa o que o cliente teme (site fora) do que você está fazendo (credencial de infraestrutura), dá horário e promete verificação. Para rotação periódica, adiante a próxima data: cliente que sabe que isso acontece a cada seis meses para de reagir a cada aviso.

## Como transformar a troca em rotina em vários servidores

Três decisões que transformam a tarefa pontual em rotina da agência:

- **Calendário fixo.** Defina a periodicidade de rotação e coloque no calendário por servidor, não por cliente. Um servidor com dez sites é uma janela, não dez.
- **Um registro por servidor.** Planilha ou página no gerenciador com: data da última troca, consumidores inventariados, ferramentas externas que guardam a credencial. Quem fizer a próxima troca não precisa redescobrir o inventário.
- **Senha nunca em texto fora do gerenciador.** Se um script precisa de acesso administrativo recorrente, discuta se ele não deveria usar um usuário dedicado com permissão limitada em vez do root. Na maioria dos casos de script de manutenção, deveria.

A troca em si é a parte curta. O valor do processo está no inventário que você escreve uma vez e reaproveita em cada servidor.

