blog
Painéis

E-mails que ficaram no servidor antigo após a troca de MX

A segunda passada do imapsync, feita depois que a migração já terminou, com conferência pasta por pasta e sem criar duplicata na caixa do cliente.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: rode uma segunda passada do imapsync contra o hostname ou IP direto do servidor antigo (o domínio já não aponta mais para ele), em `--dry` primeiro, e confira a contagem pasta por pasta com `--justfoldersizes` antes e depois. Em geral não se perdeu nada, ficou na origem, e a conferência pasta por pasta confirma isso.

Neste artigo
  1. As mensagens não sumiram, entraram no servidor antigo durante a propagação
  2. Hostname direto, prazo de desligamento e senhas da origem antes de qualquer comando
  3. A contagem pasta por pasta que define o que ainda falta copiar
  4. Rodar a segunda passada do imapsync sem duplicar mensagem
  5. Quando o copy_user_mail_as_root resolve melhor que o imapsync
  6. Critério de aceite antes de pedir o desligamento da conta antiga
  7. O texto para explicar o atraso ao cliente sem culpar ninguém

As mensagens não sumiram, entraram no servidor antigo durante a propagação

Você copiou as caixas, apontou o MX para o servidor novo, conferiu que o webmail abre. Dois dias depois o cliente diz que uma mensagem importante sumiu. Ela não sumiu: entrou no servidor antigo durante a propagação do DNS, enquanto parte dos remetentes ainda resolvia o MX velho, e ficou lá. A cópia que você fez foi feita antes disso.

O conserto é uma segunda passada do imapsync, restrita às pastas que importam (normalmente só a INBOX), feita contra o IP ou hostname do servidor antigo (o domínio já não aponta mais para ele). O risco não é perder mensagem, é duplicar. Por isso a ordem aqui é: inventariar, rodar em simulação, rodar de verdade, conferir pasta por pasta, só então desligar a origem.

Hostname direto, prazo de desligamento e senhas da origem antes de qualquer comando

Depois que o MX muda, mail.dominio.com.br deixa de resolver para o servidor antigo. Se você usar o domínio nos parâmetros do imapsync, vai sincronizar o servidor novo com ele mesmo.

Pegue, com a hospedagem antiga, três coisas:

Teste o acesso antes de montar o comando:

openssl s_client -connect srv123.provedorantigo.com.br:993 -crlf -quiet
# depois de conectar:
a1 LOGIN [email protected] senha-antiga
a2 LIST "" "*"
a3 LOGOUT

Se a1 responder NO, o problema é credencial ou a conta já foi removida. Resolva isso com o provedor antigo antes de continuar. Se a2 listar as pastas, anote os nomes exatamente como aparecem: eles vão importar no passo de mapeamento.

A contagem pasta por pasta que define o que ainda falta copiar

O imapsync tem um modo que só lista pastas e tamanhos, sem copiar nada. Use isso como foto antes e depois:

imapsync \
  --host1 srv123.provedorantigo.com.br --user1 [email protected] --password1 'SENHA_ANTIGA' --ssl1 \
  --host2 srv456.servidornovo.com.br  --user2 [email protected] --password2 'SENHA_NOVA'   --ssl2 \
  --justfoldersizes

Salve a saída em arquivo. Vai servir de prova para o cliente e de critério de aceite para você.

Monte uma planilha simples, uma linha por pasta, assim (os números abaixo são exemplo fictício, só para mostrar o formato):

Pasta origem Pasta destino Msgs origem Msgs destino antes Diferença esperada
INBOX INBOX 1.842 1.806 36
INBOX.Sent INBOX.Sent 913 913 0
INBOX.Trash INBOX.Trash 220 0 ignorar
INBOX.spam INBOX.Spam 1.104 0 ignorar

Duas decisões saem dessa tabela. Primeira: Lixeira e Spam quase nunca precisam da segunda passada, e são justamente as pastas que mais geram ruído de nome. Segunda: se a diferença em INBOX for muito maior que o esperado para a janela de propagação, a primeira migração não terminou, e aí o problema é outro.

Rodar a segunda passada do imapsync sem duplicar mensagem

Na prática, rodar duas vezes o mesmo par origem/destino normalmente não duplica nada: o imapsync não usa o UID como critério entre servidores (UID é local de cada caixa e muda na cópia) e reconhece a mensagem já copiada por outros atributos. Não tome isso como garantia: quem confirma é o --dry e a contagem pasta por pasta.

O que, por observação de uso, quebra esse reconhecimento e gera duplicata:

Mitigação prática: rode sempre em simulação primeiro e leia o resumo.

imapsync \
  --host1 srv123.provedorantigo.com.br --user1 [email protected] --password1 'SENHA_ANTIGA' --ssl1 \
  --host2 srv456.servidornovo.com.br  --user2 [email protected] --password2 'SENHA_NOVA'   --ssl2 \
  --folder INBOX \
  --dry

A simulação diz quantas mensagens seriam transferidas. Se esse número bater com a diferença da sua planilha, pode tirar o --dry. Se vier muito acima, pare: provavelmente é problema de identificação, não de mensagem faltando.

Por que limitar à INBOX funciona melhor que filtro de data

Se você quer copiar só o que entrou depois da data da primeira migração, limite a execução à INBOX com --folder INBOX e confira o resultado pela contagem, em vez de confiar em um filtro de data. Filtro de data por si só não protege contra duplicata, e a proteção útil já está no funcionamento normal da ferramenta. Menos parâmetro, menos coisa para dar errado.

Quando INBOX.Trash e INBOX.Lixeira viram duas lixeiras no destino

INBOX.Trash contra INBOX.Lixeira, spam minúsculo contra Spam, separador . contra /. Quando os nomes divergem, o imapsync cria no destino uma pasta nova com o nome da origem, e o cliente passa a ver duas lixeiras. Duas saídas:

Quando o copy_user_mail_as_root resolve melhor que o imapsync

Se você administra o servidor novo via WHM e a origem também é cPanel, existe um caminho sem montar linha de comando IMAP. O script copy_user_mail_as_root copia o e-mail de um usuário entre servidores, e a documentação oficial descreve o uso e os parâmetros aceitos: The copy_user_mail_as_root Script.

Quando faz sentido usar cada um:

Situação Ferramenta
Você tem root nos dois lados e ambos são cPanel copy_user_mail_as_root
Origem é compartilhada, você só tem senha de e-mail imapsync
Origem é cPanel e destino não é (ou o contrário) imapsync
Precisa de relatório por pasta para mostrar ao cliente imapsync com --justfoldersizes
Origem é Exchange, Zimbra, Google Workspace imapsync

Para dez contas em três clientes diferentes, script em laço com imapsync é mais rápido de auditar, porque sobra log.

Critério de aceite antes de pedir o desligamento da conta antiga

Rode --justfoldersizes de novo, nos dois lados, e compare com a foto do início. Critério de aceite, na ordem:

  1. Contagem da INBOX no destino igual ou maior que a da origem.
  2. Contagem de Enviados igual nos dois lados.
  3. Nenhuma pasta nova e inesperada no destino (sinal de mapeamento errado).
  4. Abrir o webmail do destino e buscar pelo assunto da mensagem que o cliente reclamou. Essa é a única verificação que o cliente aceita.

Só depois disso peça o desligamento da conta antiga, e peça por escrito com data. Enquanto a conta existir, você tem como refazer. Depois que ela sai do ar, não tem.

Uma recomendação contra o meu próprio interesse: se o servidor antigo ainda está ativo e você tem acesso, não há pressa em migrar de novo nada além da janela. Copiar a caixa inteira de novo é a forma mais fácil de criar duplicata em caixas grandes, e duplicata irrita mais o cliente do que a mensagem atrasada.

O texto para explicar o atraso ao cliente sem culpar ninguém

Use isto, com as datas trocadas:

Três coisas que essa frase faz: explica sem culpar ninguém, afirma que nada foi perdido (e você só diz isso depois de conferir), e informa que o desligamento tem critério.

Checklist para a próxima migração não repetir o problema

Referências

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