Cómo migrar correo con IMAPSync entre servidores sin perder mensajes

Instala las dependencias Perl y herramientas 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

La lista parece larga pero cada módulo cubre un caso real — SSL, encoding UTF-7 IMAP, parsing de IDs únicos, tail de logs en vivo. Saltar cualquiera resultará en un error críptico en medio de la migración.

Clona e instala IMAPSync:

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

El comando final debe devolver algo como Imapsync 2.255 o superior. Si aparece “Can’t locate … in @INC”, falta algún módulo Perl — identifica el nombre por el error e instálalo vía sudo cpanm Nombre::Modulo.

Crea un archivo migracion.sh con las variables de la cuenta:

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

La combinación --dry --justfolders lista las carpetas de los dos lados sin tocar mensajes. Es la forma más rápida de detectar un mismatch (ej.: el origen tiene “INBOX.Sent” y el destino espera “Sent Items”).

Ejecuta y analiza el output:

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

Busca en el log las líneas que empiezan con Host1 folders: y Host2 folders:. Si hay discrepancia (ej.: el origen usa jerarquía con punto “INBOX.Trabajo” y el destino usa barra “INBOX/Trabajo”), necesitarás --regextrans2 's,INBOX\.,INBOX/,g' en la ejecución real.

Inicia una sesión tmux para ejecutar en background:

tmux new -s migracion

Si la conexión SSH se cae, te reconectas y ejecutas tmux attach -t migracion para seguir acompañando.

Ejecuta la sincronización completa removiendo el --dry --justfolders:

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

--automap mapea automáticamente Sent/Sent Items/INBOX.Sent entre proveedores distintos. --syncinternaldates preserva la fecha original. --useuid hace que la sincronización sea idempotente — volver a ejecutarla no duplica nada. --addheader añade X-Imapsync en los mensajes para que puedas auditar después cuáles fueron migrados.

Reduce el TTL del registro MX en el proveedor de DNS a 300 segundos (5 min) ANTES de hacer cualquier cambio — idealmente 24h antes. Esto garantiza que la propagación sea rápida cuando cambies el destino. Si el TTL estaba en 3600 o 86400, todos seguirán viendo el valor antiguo hasta que ese tiempo termine.

# Verifica el TTL actual antes de cambiar
dig +short mx dominio.com
dig +nocmd +noall +answer mx dominio.com

Cambia el MX al nuevo servidor. En el panel DNS:

• Tipo: MX
• Prioridad: 10 (o la que uses)
• Valor: mail.destino.com. (con punto final)
• TTL: 300

Espera 5-10 minutos y confirma la propagación:

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

Ambos deben devolver el nuevo MX. Si uno devuelve el antiguo, el caché del resolver aún no expiró — espera unos minutos más.

Ejecuta IMAPSync por segunda vez — comando idéntico al Step 06. Por el --useuid, solo copiará los mensajes que llegaron al origen entre la primera y la segunda ejecución. Típicamente es rápido (2-10 minutos).

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

Al final del log, busca Total bytes transferred. En una sync incremental exitosa, ese valor es pequeño (algunos MB como máximo).

Compara los conteos de origen y destino:

imapsync \
  --host1 mail.origen.com --port1 993 --ssl1 \
  --user1 [email protected] --password1 'CLAVE_ORIGEN' \
  --host2 mail.destino.com --port2 993 --ssl2 \
  --user2 [email protected] --password2 'CLAVE_DESTINO' \
  --justconnect

Y luego ejecuta con --dry para ver el reporte final de mensajes contados en cada carpeta de los dos lados:

./migracion.sh --dry

Al final, busca Folder Host1/Host2 messages — cada par debe coincidir. Una diferencia de ≤ 5 mensajes en carpetas de 10k+ es normal (mensajes que llegaron entre la última sync y la verificación).