blog
Painéis

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.

JR · · 6 min de leitura · 2 tabelas · 5 blocos de código

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
  1. Por que essas mensagens foram entregues no servidor antigo
  2. Três checagens antes de rodar o imapsync
  3. Como fazer a segunda passada do imapsync, uma conta por vez
  4. Como conferir a contagem de mensagens pasta por pasta
  5. Seis erros que aparecem na segunda passada e o que fazer
  6. O que escrever ao cliente que acha que perdeu e-mail
  7. 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.

  1. 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 +short a partir de pelo menos dois resolvedores públicos diferentes.
  2. O servidor antigo ainda aceita IMAP. Teste a porta antes de montar o comando: openssl s_client -connect mail.antigo.com.br:993 -crlf e veja se volta o banner * OK.
  3. 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

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

  1. Documentação oficial (cpanel) — The copy_user_mail_as_root Script. Consultado em 2026-10-18.
Leia também