Como migrar email com IMAPSync entre servidores sem perder mensagens

Instale as dependências Perl e ferramentas de build:

sudo apt update
sudo apt install -y \
  git make cpanminus libio-socket-ssl-perl libnet-ssleay-perl \
  libcrypt-ssleay-perl libmail-imapclient-perl libdigest-md5-file-perl \
  libdist-checkconflicts-perl libfile-copy-recursive-perl \
  libio-tee-perl libjson-webtoken-perl libreadonly-perl \
  libregexp-common-perl libsys-meminfo-perl libterm-readkey-perl \
  libtest-fatal-perl libtest-mockobject-perl libtest-pod-perl \
  libtest-requires-perl libtest-deep-perl libunicode-string-perl \
  liburi-perl libencode-imaputf7-perl libfile-tail-perl \
  libdata-uniqid-perl libproc-processtable-perl libtime-hires-perl

A lista parece longa mas cada módulo cobre um caso real — SSL, encoding UTF-7 IMAP, parsing de IDs únicos, tail de logs ao vivo. Pular qualquer um vai resultar em erro críptico no meio da migração.

Clone e instale o IMAPSync:

git clone https://github.com/imapsync/imapsync.git
cd imapsync
sudo make install
imapsync --version

O comando final deve retornar algo como Imapsync 2.255 ou superior. Se aparecer “Can’t locate … in @INC”, falta algum módulo Perl — identifique o nome pelo erro e instale via sudo cpanm Nome::Modulo.

Crie um arquivo migracao.sh com as variáveis da conta:

#!/bin/bash
imapsync \
  --host1 mail.origem.com.br \
  --port1 993 \
  --ssl1 \
  --user1 [email protected] \
  --password1 'SENHA_ORIGEM' \
  --host2 mail.destino.com.br \
  --port2 993 \
  --ssl2 \
  --user2 [email protected] \
  --password2 'SENHA_DESTINO' \
  --dry \
  --justfolders

A combinação --dry --justfolders lista as pastas dos dois lados sem tocar em mensagens. É a forma mais rápida de detectar mismatch (ex: origem tem “INBOX.Sent” e destino espera “Sent Items”).

Rode e analise o output:

chmod +x migracao.sh
./migracao.sh 2>&1 | tee dry-run.log

Procure no log por linhas começando com Host1 folders: e Host2 folders:. Se houver discrepância (ex: origem usa hierarquia com ponto “INBOX.Trabalho” e destino usa barra “INBOX/Trabalho”), você vai precisar de --regextrans2 's,INBOX\.,INBOX/,g' na execução real.

Inicie uma sessão tmux pra rodar em background:

tmux new -s migracao

Se a conexão SSH cair, você reconecta e roda tmux attach -t migracao pra continuar acompanhando.

Rode a sincronização completa removendo o --dry --justfolders:

imapsync \
  --host1 mail.origem.com.br --port1 993 --ssl1 \
  --user1 [email protected] --password1 'SENHA_ORIGEM' \
  --host2 mail.destino.com.br --port2 993 --ssl2 \
  --user2 [email protected] --password2 'SENHA_DESTINO' \
  --automap \
  --syncinternaldates \
  --useuid \
  --addheader \
  --logfile LOG_imapsync/usuario.log

O --automap mapeia automaticamente Sent/Sent Items/INBOX.Sent entre provedores diferentes. --syncinternaldates preserva a data original. --useuid torna a sincronização idempotente — rodar de novo não duplica nada. --addheader adiciona X-Imapsync nas mensagens pra você auditar depois quais foram migradas.

Reduza o TTL do registro MX no provedor de DNS pra 300 segundos (5 min) ANTES de fazer qualquer mudança — idealmente 24h antes. Isso garante que a propagação seja rápida quando você trocar o destino. Se o TTL estava em 3600 ou 86400, todo mundo vai continuar vendo o valor antigo até esse tempo terminar.

# Verifique TTL atual antes de mudar
dig +short mx dominio.com.br
dig +nocmd +noall +answer mx dominio.com.br

Troque o MX pro novo servidor. No painel DNS:

• Tipo: MX
• Prioridade: 10 (ou a que você usa)
• Valor: mail.destino.com.br. (com ponto final)
• TTL: 300

Aguarde 5-10 minutos e confirme propagação:

dig +short mx dominio.com.br @1.1.1.1
dig +short mx dominio.com.br @8.8.8.8

Ambos devem retornar o novo MX. Se um retornar o antigo, o cache do resolver ainda não expirou — espere mais alguns minutos.

Rode IMAPSync uma segunda vez — comando idêntico ao Step 06. Por causa do --useuid, ele só vai copiar mensagens que chegaram na origem entre a primeira e a segunda execução. Tipicamente é rápido (2-10 minutos).

./migracao.sh 2>&1 | tee LOG_imapsync/cutover.log

No final do log, procure por Total bytes transferred. Em uma sync incremental bem-sucedida, esse valor é pequeno (alguns MB no máximo).

Compare as contagens da origem e destino:

imapsync \
  --host1 mail.origem.com.br --port1 993 --ssl1 \
  --user1 [email protected] --password1 'SENHA_ORIGEM' \
  --host2 mail.destino.com.br --port2 993 --ssl2 \
  --user2 [email protected] --password2 'SENHA_DESTINO' \
  --justconnect

E depois rode com --dry pra ver o relatório final de mensagens contadas em cada pasta dos dois lados:

./migracao.sh --dry

No final, procure por Folder Host1/Host2 messages — cada par deve bater. Diferença ≤ 5 mensagens em pasta de 10k+ é normal (mensagens que chegaram entre o último sync e a verificação).