Como recuperar e-mails presos no servidor antigo após migrar
O procedimento de recuperação depois que o DNS já apontou para o servidor novo: segunda passada incremental, conferência por pasta e os erros que aparecem no caminho.

Resposta curta: os e-mails que chegaram durante a propagação do MX ficaram na caixa do servidor antigo e são recuperáveis com uma segunda passada incremental do imapsync, conta por conta, conferindo a contagem de mensagens pasta por pasta antes de desligar o servidor velho.
Neste artigo
- Por que essas mensagens foram entregues no servidor antigo
- Três checagens antes de rodar o imapsync
- Como fazer a segunda passada do imapsync, uma conta por vez
- Como conferir a contagem de mensagens pasta por pasta
- Seis erros que aparecem na segunda passada e o que fazer
- O que escrever ao cliente que acha que perdeu e-mail
- Checklist de 12 etapas para fechar a migração
Por que essas mensagens foram entregues no servidor antigo
A migração de e-mail tem duas janelas. A primeira é a cópia que você fez antes de mexer no DNS. A segunda é o intervalo entre o momento dessa cópia e o momento em que o último resolvedor do mundo parou de usar o MX antigo.
Tudo que chegou dentro da segunda janela foi entregue no servidor antigo. Não é perda, é mensagem parada em uma caixa que o cliente não abre mais, porque o cliente de e-mail dele agora conecta no IMAP novo. Enquanto o servidor antigo estiver de pé e a conta existir com a senha conhecida, isso é recuperável.
O erro operacional mais comum nessa hora é refazer a migração inteira por cima do destino. Você duplica meses de histórico e troca um problema pequeno por um grande. O procedimento certo é uma segunda passada incremental, conta por conta, com conferência de contagem por pasta antes de derrubar o servidor velho.
Três checagens antes de rodar o imapsync
Três checagens que levam dois minutos e evitam retrabalho.
- O MX já propagou de verdade. Se ainda há resolvedor entregando no antigo, a segunda passada vai ficar desatualizada no minuto seguinte. Confirme com
dig MX dominio.com.br +shorta partir de pelo menos dois resolvedores públicos diferentes. - O servidor antigo ainda aceita IMAP. Teste a porta antes de montar o comando:
openssl s_client -connect mail.antigo.com.br:993 -crlfe veja se volta o banner* OK. - Lista fechada de contas. Exporte do painel antigo a relação de caixas com quota usada. É essa lista que vira o seu checklist, e é ela que você mostra ao cliente no fim.
Se a conta antiga já foi excluída e o backup existe, o caminho no cPanel é restaurar o diretório de e-mail e depois copiar. Para copiar a correspondência de uma conta cPanel para outra, o WHM tem o script copy_user_mail_as_root, que a documentação do cPanel descreve como executável pelo root na linha de comando. Ele copia, não move, e resolve o cenário conta-para-conta no cPanel: não substitui a sincronização IMAP entre servidores diferentes.
Como fazer a segunda passada do imapsync, uma conta por vez
O imapsync compara origem e destino e transfere só o que falta. É isso que o torna seguro para uma segunda rodada: rodar de novo em uma caixa já sincronizada deve copiar zero mensagem.
Comece sempre em modo seco. Nada é escrito no destino e você lê o relatório antes de confiar nos parâmetros:
imapsync \
--host1 mail.antigo.com.br --user1 [email protected] \
--password1 'SENHA_ANTIGA' --ssl1 \
--host2 mail.novo.com.br --user2 [email protected] \
--password2 'SENHA_NOVA' --ssl2 \
--dry
Leia a saída procurando duas coisas: a lista de pastas que ele casou entre os dois lados e o total de mensagens que ele pretende transferir. Se a lista de pastas vier torta (INBOX.Sent de um lado, Sent do outro), pare e resolva o mapeamento antes de tirar o --dry. Se o número de mensagens a transferir for próximo do total da caixa, você não está fazendo uma passada incremental, está fazendo uma cópia completa de novo.
Com o relatório limpo, repita o mesmo comando sem --dry.
Por que a senha vai em arquivo e não na linha de comando
Senha digitada em linha de comando fica no histórico do shell e aparece em ps. O imapsync aceita --passfile1 e --passfile2 no lugar de --password1 e --password2, lendo o conteúdo do arquivo apontado.
mkdir -p /root/mig && chmod 700 /root/mig
printf '%s' 'SENHA_ANTIGA' > /root/mig/contato_dominio.pw1
printf '%s' 'SENHA_NOVA' > /root/mig/contato_dominio.pw2
chmod 600 /root/mig/contato_dominio.pw1 /root/mig/contato_dominio.pw2
O printf sem quebra de linha evita arquivo terminado em \n. No comando, troque as duas linhas de senha por:
--passfile1 /root/mig/contato_dominio.pw1 \
--passfile2 /root/mig/contato_dominio.pw2 \
Confira com ls -l /root/mig que as permissões saíram -rw-------. É o mesmo trabalho e some com o risco.
Como repetir o procedimento em muitos domínios com um CSV
Monte um CSV com usuario,caminho_passfile_origem,caminho_passfile_destino (nenhuma senha em texto no arquivo da planilha) e um laço de shell que chama o imapsync uma vez por linha, gravando a saída em um log por conta (logs/contato_dominio.log).
while IFS=, read -r usuario pf1 pf2; do
imapsync \
--host1 mail.antigo.com.br --user1 "$usuario" --passfile1 "$pf1" --ssl1 \
--host2 mail.novo.com.br --user2 "$usuario" --passfile2 "$pf2" --ssl2 \
> "logs/${usuario%@*}.log" 2>&1
done < contas.csv
Rode esse laço primeiro com --dry acrescentado na chamada. Você precisa do log separado porque a conferência é por conta, e porque quando uma falhar você quer repetir só aquela.
Como conferir a contagem de mensagens pasta por pasta
Não aceite "o imapsync disse que terminou". Conte os dois lados. O jeito mais direto, sem instalar nada além do que já está na máquina, é perguntar ao próprio IMAP:
openssl s_client -connect mail.antigo.com.br:993 -crlf -quiet
a LOGIN [email protected] 'SENHA'
b STATUS "INBOX" (MESSAGES)
c STATUS "INBOX.Sent" (MESSAGES)
d LOGOUT
Repita contra o host novo e anote. A planilha de conferência fica assim, uma linha por pasta e uma aba por conta:
| Pasta (origem) | Pasta (destino) | Msgs origem | Msgs destino | Situação |
|---|---|---|---|---|
| INBOX | INBOX | 4.812 | 4.812 | ok |
| INBOX.Sent | Sent | 1.233 | 1.233 | ok, mapeada |
| INBOX.Trash | Trash | 97 | 0 | excluída de propósito |
| INBOX.Clientes.2023 | Clientes/2023 | 540 | 538 | reprocessar |
Os números acima são exemplo de preenchimento, não medição. O que importa é a disciplina: pasta que não bate volta para a fila, e a migração só é declarada encerrada quando toda linha está resolvida ou justificada.
Desligue o servidor antigo somente depois disso, e ainda assim mantenha o backup da caixa por algumas semanas. Servidor desligado com caixa não conferida é a única parte desse processo que não tem desfazer.
Seis erros que aparecem na segunda passada e o que fazer
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Mensagens duplicadas no destino | Primeira migração usou outra ferramenta e os identificadores não casam, então o imapsync não reconhece a mensagem como já existente | Rodar com --dry antes e comparar contagens; se já duplicou, deduplicar no destino em vez de recopiar |
| Pastas criadas vazias com nomes estranhos | Prefixo e separador diferentes entre os servidores (INBOX.Sent contra Sent, ponto contra barra) |
Ajustar o mapeamento de pastas no comando e refazer só as pastas afetadas |
| Enviados e Lixeira ficaram para trás | Pastas fora do escopo da primeira migração ou excluídas por filtro | Decidir com o cliente: Enviados quase sempre entra, Lixeira e Spam quase sempre não |
| Login recusado no destino com a senha certa | Autenticação em dois fatores ou política que exige senha de aplicativo | Gerar senha de aplicativo específica para a migração e revogá-la depois |
| Login recusado na origem após várias tentativas | Bloqueio por excesso de falhas de autenticação | Esperar a liberação ou liberar o IP de origem antes de repetir |
| Conexão cai no meio de caixas grandes | Timeout ou limite de conexões simultâneas por IP | Rodar as contas em série, não em paralelo, e repetir a conta que falhou |
Repetir a conta que falhou é barato justamente porque a passada é incremental. Esse é o ponto inteiro do método.
O que escrever ao cliente que acha que perdeu e-mail
O cliente não quer saber de TTL nem de prefixo de pasta. Ele quer saber se perdeu contrato. Use algo nessa linha, por escrito, no mesmo canal em que ele reclamou:
Três coisas fazem essa frase funcionar: ela afirma que não houve perda, explica a causa sem jargão e termina com um compromisso verificável. Depois da conferência, mande a planilha de contagem. Cliente que recebe número para de perguntar.
Checklist de 12 etapas para fechar a migração
- [ ] MX confirmado em dois resolvedores distintos
- [ ] IMAP do servidor antigo respondendo na 993
- [ ] Lista de contas exportada com quota usada
- [ ] Senha de aplicativo gerada onde houver 2FA
- [ ]
--dryexecutado e relatório lido conta a conta - [ ] Mapeamento de pastas conferido (prefixo e separador)
- [ ] Decisão registrada sobre Lixeira e Spam
- [ ] Passada real executada, um log por conta
- [ ] Contagem
STATUS (MESSAGES)nos dois lados, pasta por pasta - [ ] Divergências reprocessadas e planilha fechada
- [ ] Mensagem enviada ao cliente com a planilha anexa
- [ ] Backup da caixa antiga retido antes do desligamento
Guarde esse checklist junto com o script do laço. Na próxima migração, o trabalho vira preencher o CSV e ler logs.
Referências
- Documentação oficial (cpanel) — The copy_user_mail_as_root Script. Consultado em 2026-10-18.