# 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.

> 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.

João Rizzon · 2026-11-04 · Painéis

---

## 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 +short` a 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 -crlf` e 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](https://docs.cpanel.net/whm/scripts/the-copy_user_mail_as_root-script/) 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:

```bash
imapsync \
  --host1 mail.antigo.com.br --user1 contato@dominio.com.br \
  --password1 'SENHA_ANTIGA' --ssl1 \
  --host2 mail.novo.com.br  --user2 contato@dominio.com.br \
  --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.

```bash
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:

```bash
  --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`).

```bash
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:

```bash
openssl s_client -connect mail.antigo.com.br:993 -crlf -quiet
a LOGIN contato@dominio.com.br '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:

> **** "Nenhuma mensagem foi perdida. Durante a troca de servidor, alguns e-mails ainda foram entregues no servidor antigo, porque provedores de internet levam algumas horas para atualizar o endereço novo. Essas mensagens estão na caixa antiga e estou copiando todas para a sua caixa atual. Vou te avisar quando a conferência de todas as pastas estiver concluída."

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
- [ ] `--dry` executado 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.

