Strumento imapsync: parametri che evitano la perdita di email

imapsync è lo strumento usato per trasferire posta IMAP senza coinvolgere gli utenti in esportazioni PST, client desktop o un fine settimana di tentativi. Il problema viene dopo. Un parametro o una mappatura errati, oppure un presupposto sbagliato sull'autenticazione, possono lasciare messaggi inviati mancanti, cartelle duplicate o nuova posta eliminata al passaggio. Per il flusso completo, leggi questa guida operativa a imapsync.

Questo articolo è volutamente specifico. Tratta i parametri che cambiano davvero il risultato: timeout, keepalive, mappatura, limitazione del traffico, deduplicazione e opzioni di eliminazione pericolose per una casella attiva. Con un account evita una ripetizione confusa; con cinquanta evita di spiegare perché la cartella Inviati ha tre copie.

In breve, le impostazioni predefinite non sono un piano di migrazione, ma un punto di partenza. Servono passaggi graduali, regole esplicite e verifica prima di modificare l'MX. Se la destinazione è TrekMail, l'importazione integrata nei piani a pagamento gestisce la ricezione dal pannello, spesso più facilmente degli script manuali per ogni casella. Secondo la pagina dei prezzi, TrekMail parte da $3.50/month, usa spazio condiviso invece di tariffe per utente e supporta l'importazione IMAP lato server da Gmail, Outlook, Yahoo, iCloud e IMAP generico.

Perché imapsync fallisce quando ci si affida ai valori predefiniti

imapsync copia tra archivi IMAP attivi, non file statici. Deve gestire gerarchie, particolarità dei server, identificatori e autenticazione mentre la rete può interrompere la sessione. Per questo un'esecuzione sicura è più esplicita degli esempi incollati nei forum.

I problemi comuni sono prevedibili e costosi:

1. I messaggi grandi superano il timeout di caricamento.
2. Una mappatura errata fa sembrare scomparse le cartelle.
3. I provider limitano la procedura e rifiutano connessioni.
4. L'autenticazione moderna blocca le password semplici.
5. Le variazioni degli UID producono duplicati nei passaggi successivi.
6. `--delete2` elimina nuova posta dalla destinazione dopo il passaggio.

Una migrazione “quasi corretta, tranne Sent Items” non è casuale. Era prevedibile: il protocollo lo consentiva e le impostazioni predefinite non l'hanno impedito.

Parametri di connessione che mantengono attivo imapsync

Con caselle grandi, spesso la connessione termina prima della scrittura. Operazioni APPEND lunghe, Exchange lento e firewall stateful sono cause comuni. Aumenta il timeout, invia keepalive e memorizza lo stato affinché la ripetizione non riparta da zero.

Usa questi parametri nel primo passaggio importante:

imapsync \
  --host1 imap.source.tld --user1 user@source.tld --passfile1 ./pass1 \
  --host2 imap.dest.tld   --user2 user@dest.tld   --passfile2 ./pass2 \
  --timeout 120 \
  --keepalive1 --keepalive2 \
  --usecache

Funzione di ogni parametro:

La cache conta molto. Le buone migrazioni sono incrementali: esegui il grosso, correggi autenticazione o mappatura, poi fai uno o due recuperi. Con `--usecache`, imapsync rilegge meno dati; senza, ogni ripetizione è più pesante.

C'è una riserva. La documentazione avverte che, in alcuni casi, `--usecache` non è sicuro con filtri combinati di dimensione ed età. Non aggiungere filtri casuali solo perché sembrano efficienti. Mantieni semplice il primo passaggio.

Parametri di mappatura che evitano il panico da cartella mancante

Quando sembra che imapsync abbia perso cartelle, spesso la posta esiste ancora. La destinazione ha interpretato diversamente il percorso oppure una cartella speciale localizzata non è stata associata alla cartella Inviati attiva. Quando i provider divergono serve una traduzione esplicita.

Le due trappole principali sono i separatori gerarchici e le cartelle speciali.

Alcuni server usano punti, altri barre. Se l'origine ha INBOX.Clients.ProjectA e la destinazione richiede INBOX/Clients/ProjectA, riscrivi il percorso durante la copia.

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --regextrans2 's/\./\//g'

C'è poi il problema della cartella Inviati. I provider la chiamano diversamente, mentre l'utente vuole trovare la posta nella vista attiva.

Per cartelle speciali standard prova prima --automap. Con vecchie caselle cPanel localizzate o disordinate, le trasformazioni regex esplicite sono più sicure. TrekMail offre guide per avviare un'importazione dal pannello e per aggiungere un dominio quando prepari la destinazione.

Esempio concettuale: la cartella non è sparita, ma è passata dalla cartella Inviati attesa a un nome grezzo che il client non riconosce come “Inviati”. Stessi byte, posto sbagliato, stessa richiesta di assistenza.

Limita imapsync prima che Google o Microsoft limitino te

I provider possono considerare imapsync traffico abusivo. Raffiche di APPEND e FETCH su molte caselle attivano limiti, sospensioni o errori simili a problemi di autenticazione che in realtà indicano capacità. Procedere lentamente può essere più rapido di subire un blocco.

Con Google Workspace o Microsoft 365 controlla il ritmo:

imapsync \
  --host1 imap.gmail.com --user1 user@source.tld --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@dest.tld --passfile2 ./pass2 \
  --maxbytespersecond 500000 \
  --maxmessagespersecond 2

Riduce i picchi che attivano le difese e impedisce alle raffiche di piccoli messaggi di sovraccaricare ambienti condivisi. Conta su vecchi cPanel e tenant Office 365 già occupati.

I numeri sono valori iniziali, non regole assolute. Il limite dipende da dimensione, concorrenza e tolleranza del provider. Se la procedura parte bene e poi mostra errori intermittenti, rallenta prima di ritenere errata la password.

Qui emerge anche la differenza tra vecchio e nuovo metodo.

Vecchio metodo: creare script per ogni casella, regolare i limiti per tentativi e sorvegliare gli errori alle 2 di notte.

Nuovo metodo: usare l'importazione lato server inclusa nei piani a pagamento di TrekMail, standardizzare la destinazione ed evitare prezzi per utente. Per le agenzie conta più evitare tre giorni di analisi dei tentativi che finire una casella dieci minuti prima. Vedi la guida all'hosting email multidominio.

Parametri di autenticazione per 2025-2026: le password falliscono, OAuth prevale

Con Google Workspace e Microsoft 365 non puoi presumere che nome utente e password funzionino. Google dichiara che, da May 1, 2025, gli account Workspace non supportano più le “app meno sicure” con sole credenziali. Anche Exchange Online indirizza i client IMAP verso OAuth.

Ciò cambia l'uso di imapsync. Se l'origine supporta XOAUTH2, serve un token al posto della password normale.

imapsync \
  --host1 outlook.office365.com \
  --user1 user@source.tld \
  --authmech1 XOAUTH2 \
  --oauthaccesstoken1 "ACCESS_TOKEN" \
  --host2 imap.trekmail.net \
  --user2 user@dest.tld --passfile2 ./pass2

Su Google Workspace, le password per app possono essere pratiche per trasferimenti occasionali con 2-Step Verification attiva. Su Microsoft 365, usa il flusso OAuth documentato per protocolli legacy. Uno script che equipara password corretta ad autenticazione corretta è arretrato.

Fonti: guida Google sulle app meno sicure e istruzioni Microsoft OAuth per IMAP.

Parametri di integrità che evitano di saltare posta danneggiata

Nei vecchi server esistono messaggi danneggiati: Message-ID mancanti, MIME non valido, allegati enormi e corpi a zero byte. imapsync può aggirare alcuni casi se configurato.

--addheader aggiunge, secondo la documentazione, un'intestazione Message-Id generata quando manca. È importante perché l'identità stabilisce cosa esiste già.

--maxsize evita che un messaggio enorme rifiutato dalla destinazione blocchi tutto.

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --addheader \
  --maxsize 35000000

Non significa ignorare i messaggi grandi, ma trasferire prima il 99% e gestire poi le eccezioni con un elenco controllato.

Per molte caselle in parallelo serve anche un provisioning ordinato. Leggi creare account email in blocco, perché i problemi aumentano quando creazione, password e DNS vivono in fogli separati.

Il parametro imapsync più pericoloso: --delete2

`--delete2` elimina dalla destinazione i messaggi assenti nell'origine. Può servire per una copia esatta, ma può anche cancellare nuova posta valida dopo il cambio MX se usato nel momento sbagliato.

Sequenza del problema:

1. Prepari nella destinazione la vecchia posta.
2. Cambi MX.
3. La nuova posta arriva alla destinazione.
4. Ripeti imapsync con --delete2.
5. imapsync elimina la posta presente solo nel target.

Non è un bug. È esattamente l'istruzione data.

Usa `--delete2` solo in uno scenario controllato prima del passaggio. Dopo la modifica MX, rimuovilo. Se la destinazione è attiva, considerala autorevole per la nuova posta.

Quando gli UID ingannano, usa la corrispondenza per intestazione

Gli UID IMAP sono affidabili solo nello stato del server a cui appartengono. RFC 3501 definisce UIDVALIDITY perché le ipotesi sugli UID possono fallire dopo modifiche. Se la cartella viene ricostruita o reindicizzata, imapsync può considerare nuovi tutti i messaggi e duplicarli.

Aiuta la corrispondenza per intestazione:

imapsync \
  --host1 old.example.com --user1 user@old.example.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@example.com --passfile2 ./pass2 \
  --useheader 'Message-Id'

È più lenta che fidarsi degli UID, ma più sicura con origini instabili o ricostruite. La documentazione indica --useheader "Message-Id" come possibile soluzione ai duplicati.

Per la verifica finale, preferisco una simulazione prudente prima del cambio DNS e un breve passaggio incrementale dopo la fine delle modifiche al vecchio sistema.

Un modello sicuro di comando imapsync

Una procedura sicura esplicita connettività, mappatura, esclusioni e modalità di prova. Inizia a secco, conferma le cartelle e poi esegui davvero. Non usare un primo abbozzo sui dati di produzione.

imapsync \
  --host1 imap.gmail.com --user1 user@source.com --passfile1 ./pass1 \
  --host2 imap.trekmail.net --user2 user@dest.com --passfile2 ./pass2 \
  --timeout 120 --keepalive1 --keepalive2 \
  --usecache \
  --automap \
  --regextrans2 's/^\[Gmail\]\/Sent Mail/Sent Items/' \
  --exclude '^\[Gmail\]/All Mail' \
  --maxbytespersecond 500000 \
  --maxmessagespersecond 2 \
  --dry

Tre note pratiche:

1. Usa prima --dry. Sempre.
2. Escludi dal primo passaggio grandi archivi non necessari.
3. Conserva il log e versiona i comandi per lotto.

Su TrekMail gli utenti si collegano via IMAP standard a imap.trekmail.net sulla porta 993. TrekMail usa IMAP, non POP3, per sincronizzare lo stato tra dispositivi.

Conclusione: imapsync funziona se viene gestito come strumento di migrazione

imapsync resta adatto a molti trasferimenti se lo tratti come software con stato, non come semplice copia. Imposta timeout e keepalive, mappa deliberatamente, rallenta quando serve, usa autenticazione moderna, evita `--delete2` dopo il passaggio e usa le intestazioni quando lo stato UID è dubbio.

Per una destinazione più facile da gestire, TrekMail offre più domini, prezzi fissi, spazio condiviso e importazione lato server nei piani a pagamento, senza costo per ogni nuova casella. Dopo il trasferimento, leggi anche questa guida all'email aziendale.