IMAP 迁移工具：恢复、文件夹与试点核验

IMAP 迁移工具听起来简单，直到第一个邮箱卡在 47%，文件夹层级出错，用户发现未读邮件被标成已读。邮箱迁移不是拖放，它需要协议处理、状态记录、重试和核验。底层操作可先参考管理员 imapsync 指南。

仅凭销售页面选择工具，而不看故障表现，容易留下问题。切换窗口可能耗在限速、重复导入、意外的 Gmail 标签副本，以及没有有效日志的错误上。评估工具如何处理故障，不要只看面板是否漂亮。

什么是 IMAP 迁移工具？

IMAP 迁移工具把邮件从一个 IMAP 邮箱复制到另一个，并尝试保留文件夹、标记和恢复任务所需状态。合适的流程还应处理提供商差异、重试、重复匹配和可审查的日志。

这不同于每次都重新上传。工具应该识别已有邮件、保留源端支持的已读状态，并提供过程信息。RFC 3501 描述 IMAP 的 UID 与 UIDVALIDITY：UID 只在对应文件夹和 UIDVALIDITY 下有效，不是跨服务器的全局编号。状态变化后，需要经过测试的重启匹配策略。

日历、联系人、过滤规则和共享盘都需要单独迁移。IMAP 复制的是邮件数据，不是这些账户服务。TrekMail 的导入文档也明确区分邮件与联系人、日历。

IMAP 迁移工具应该擅长哪些工作？

合适的IMAP 迁移工具应能在错误后有依据地继续、遵守限制、映射文件夹并提供有效日志。必须能查明哪些邮件跳过、重试或失败，否则难以放心投入实际迁移。

1. 中断后继续，减少不必要的重复

试点要验证中断后的重复匹配行为，不能只检查文件夹数量和进度条。源邮箱在过程中变化时，不应未经匹配就再次追加全部邮件。

UID 绑定文件夹和 UIDVALIDITY，后者变化时，仅保存“上次看到的 UID”不可靠。TrekMail 错误指南描述相同 Message-ID 时跳过已存在邮件，这是原文所述规则，不是完整实现说明。Message-ID 可能缺失或重复，还需核实其他匹配方式、可能遗漏及变化标记是否更新。

2. 遇到限速时适当退避

Google、Microsoft 等服务商可能限制 IMAP，立即盲目重试可能加重问题。要看文档说明的等待间隔、队列和可见重试状态。指数退避可能适合某些情况，但未经验证不能断言某工具实现了它，或能避免所有限制。

等待过程也体现工具质量。除复制能力外，还需要处理提供商答复、停止条件和可控恢复。

3. 支持当前认证要求

许多环境已不允许普通用户名密码登录。Google 宣布过第三方应用纯密码访问变更，并更新到 2025，建议使用 OAuth 或获准的应用专用密码。可查看 Google Workspace 纯密码访问变更并核实当前政策。

TrekMail 的 Gmail 文档描述用可用的应用专用密码，连接 `imap.gmail.com` 的 `993` 端口并使用 TLS。密码可用性取决于两步验证和策略。个人 Gmail 的 IMAP 通常默认可用，Workspace 可受管理员限制。TrekMail 直接导入不提供交互式 OAuth；必须 OAuth 时要选其他获准方法。加密连接仍需验证证书链与主机名。

4. 提供具体邮件的错误信息

任务显示“完成但有错误”时，需要文件或导出说明哪个文件夹、哪封邮件、为什么失败。切换后的核验不能只看进度条，要看有效日志。

至少需要文件夹状态、清楚的错误，以及区分单封邮件问题与连接故障的方法。多个客户域名的迁移需要可重复流程，和多域名邮箱托管的运维原则一致。

5. 处理文件夹映射和排除项

不同服务商的文件夹表示不同。Gmail 使用标签，有的服务器用点、有的用斜杠表示层级。工具应能选择所需邮件并映射结构，自动映射也必须在目标与客户端检查。

多个 Gmail 标签可能表示同一封邮件，但复制到不同目标文件夹也可能是用户想要的形式。先约定结构与完整归档，再排除文件夹。统一排除“所有邮件”可能遗漏没有其他导入标签的归档邮件。

试点中的危险信号

IMAP 迁移工具若状态不透明、无法控制超时、重试行为不清，就难以评估。成功提示与核验结果不同，需要调查。测试中连普通恢复都失败，说明真实切换尚未充分准备。

注意这些信号：

• 只有“运行中”：还应区分排队、连接、重试和复制。
• 没有可解释的重复匹配：重跑可能新增副本。
• 没有文件夹选择：无法规划排除项和整个 Gmail 归档。
• 没有有效错误输出：只有“失败”不构成报告。
• 把 POP3 宣传为完整迁移：POP3 不复制完整目录和标记，但并不天然损毁邮件。已有本地 POP 邮件要单独备份和迁移。

直接询问任务中途停止后，重启具体如何处理。无法清楚解释并测试时，应评估其他工具。

初步评估：30 分钟只是示例

小规模试点能展示IMAP 迁移工具的真实行为。使用代表性测试邮箱，加入问题项，控制中断并观察恢复。这个时间不是评估或迁移保证，完整检查可能需要更多工作。

1. 例如选择至少 1 GB、含子文件夹及不同已读状态的邮箱。
2. 加入已知问题，如较大附件或深层路径。
3. 导入到可控测试目标，观察状态和日志。
4. 受控地中断测试进程或连接，不要随意干扰生产工作。
5. 重新运行并检查匹配、重复及变化。
6. 按文件夹比较邮件、正文、附件、标记和日期，而不只看总容量。

源端有 5,000 封、目标有 4,950 封，意味着 50 项尚未解释，不一定是单封复制失败。可能涉及排除、映射或源端变化。应调查差异，而非宣布基本完成。

原文提供下面的命令行示例。它没有只检查不复制的参数，因此会实际复制，不是真正的模拟运行。不要直接执行；先准备可控目标，并在自己的工作副本中按工具支持加入真正的检查模式：

imapsync \
  --host1 imap.oldhost.com --user1 old@example.com --password1 'SOURCE_APP_PASSWORD' \
  --host2 imap.trekmail.net --user2 new@example.com --password2 'DEST_PASSWORD' \
  --ssl1 --ssl2 --port1 993 --port2 993 \
  --automap --exclude '^\[Gmail\]/All Mail$' \
  --syncinternaldates --useuid --skipsize

核实当前主机和参数。UID 模式使用工具本地映射，不是全局 UID 或完整性证明。排除 Gmail 前需安排整个归档覆盖。验证证书链、主机名，防止密码暴露在进程列表、历史与日志。补同步时只有一个用户工作系统，不可未经规划传播删除。

分散工具与集中平台

IMAP 迁移工具可以属于脚本、主机和人工核验的组合。平台也可以集中目标托管、导入和共享存储。是否更合适或更便宜，取决于方案限制、功能和已有流程。

TrekMail 文档把导入限定在邮件。可以在支持范围内添加域名、创建邮箱、导入并核验。共享存储和用户数量仍受方案限制。多个客户团队还可参考批量创建邮箱账户的管理原则。

把 TrekMail 用作 IMAP 迁移工具

TrekMail 内置的IMAP 迁移工具针对邮箱，不是日历和联系人。具备合适直接访问时，选择源端、所需文件夹和既有目标邮箱，后台执行复制。复制本身不主动更改源端，但要考虑持续用户活动和后续补同步。

核实当前文档流程：

• 在 IMAP 迁移概览中确认范围。
• Gmail 或 Workspace 参考Gmail 导入指南并核实应用专用密码条件。
• 按域名设置指南准备自有域名，创建所有目标地址并验证预复制。只有自己的接收服务改变时才切 MX，不要提前切换。

项目有两项工作：复制历史邮件和正确接收新邮件。域名根部 TXT 不能完整验证 DKIM、DMARC。下方记录只是示例，要核对当前账户值、所有合法 SPF 服务和真实 DKIM 签名。DMARC 要成功且对齐的 SPF 或有效且对齐的 DKIM；观察策略是获准风险决定，不是必做项，不能盲目采用示例隔离策略。为缓存和迟到投递保留旧服务器的 SMTP 接收、管理员同步与回退。

; Example destination DNS for TrekMail
@                  MX   10 mail.trekmail.net.
@                  TXT  "v=spf1 include:spf.trekmail.net -all"
_dmarc             TXT  "v=DMARC1; p=quarantine;"
dkim._domainkey    TXT  "<value from TrekMail dashboard>"

TrekMail 也可能帮助迁移后的费用规划。原文列付费方案每月 $3.50 起，免费方案无需信用卡，以及付费方案的 14 天免费试用。请在 TrekMail 价格中确认当前费用、信用卡要求、功能、存储和账户限制。不能假定它对所有机构与小企业都更省钱。

范围仍需明确：IMAP 导入复制邮件，不迁联系人、日历；这些应单独规划和核验。

总结：按故障处理能力选择，而非只看演示

合适的IMAP 迁移工具需要经过测试的恢复、有效日志和文档说明的限制处理。核实实际迁移内容。多域名场景可考虑 TrekMail 集中导入与目标托管，但适合程度与成本由当前要求决定。

进行受控试点，中断后再启动。一次成功测试会增加信心，不保证覆盖所有真实情况。之后仍要核验旧日期迟到邮件、文件夹间移动和标记的补同步，以及内容与实际运行。