通过 CSV 批量迁移 cPanel 邮箱

Bulk Import 可在一个批次中迁移多个 cPanel 或其他自定义 IMAP 邮箱。请先创建 TrekMail 目标邮箱并确认旧提供商的 IMAP 设置。

此迁移使用 CSV，其中含源邮箱凭据。请规划由谁创建、存放位置及删除时间。

收集源设置

打开旧提供商的 Email Accounts，再打开 Connect Devices、Configure Mail Client 或同类页面。复制该邮箱的安全传入 IMAP 设置：

• IMAP 主机名；
• 端口；
• 安全设置；以及
• 完整邮箱地址和邮箱密码。

请使用提供商给出的值，不要使用通用主机列表。不同 cPanel 服务器和方案可能采用不同名称和设置。

批量 CSV 没有单独的用户名字段，而是用每行的源地址登录。若提供商要求其他用户名格式，请对该邮箱使用单次导入，或先与提供商解决格式问题。

准备目标邮箱和 CSV

每个 destination_email 都必须已是账户中的 TrekMail 邮箱。请先通过批量创建邮箱创建缺失邮箱。

所有源邮箱使用同一服务器时，使用三列格式：

source_email,source_password,destination_email
alice@old-example.com,password-for-alice,alice@new-example.com
bob@old-example.com,password-for-bob,bob@new-example.com

各行使用不同源服务器时，使用六列格式：

source_email,source_password,destination_email,source_host,source_port,source_security
alice@site-one.example,password-for-alice,alice@new-example.com,mail.site-one.example,993,ssl
bob@site-two.example,password-for-bob,bob@new-example.com,mail.site-two.example,993,ssl

六列文件需开启 Each row has its own server settings。有关 CSV 规则、限制、引号和模板，请参阅批量迁移 CSV 格式。

不要把文件放入支持工单、邮件会话、代码库或共享文件夹。确认结果后删除临时本地副本。

启动批次

1. 打开 Import > Bulk Import，选择 Other。
2. 粘贴或上传 CSV。
3. 三列格式需在 Advanced settings 输入共用 IMAP 主机、端口和安全设置；六列格式则开启逐行服务器设置。
4. 选择 Preview & validate。预览会检查 CSV 结构、源设置、目标邮箱及重复映射，但尚不会登录每个源邮箱。
5. 修正无效行并再次预览。
6. 选择文件夹策略：
   • Preserve folder tree 保留完整源布局，包括自定义文件夹。
   • Flatten to INBOX 建立单一 Inbox 归档，并标明原始文件夹。
   • Only INBOX + Sent 仅进行有意限制的迁移。
7. 除非有明确理由，否则保留 Skip duplicates。可添加批次名称，然后选择 Start。

一个账户只能有一个活动批量批次。Starter 最多 100 行，Pro 300 行，Agency 1,000 行。文件不得超过 2 MB。

监控与恢复

批次详情页显示每个邮箱的结果和总计。批次可为 queued、running、paused、completed、completed with errors 或 cancelled。

• 某行失败： 阅读具体消息，修正旧邮箱密码或连接设置，然后在可用时使用 Continue incomplete。
• 批次暂停： 检查目标存储空间，准备好后选择 Resume。批次会在存储达到 90% 时暂停，以免彻底失败。
• 需要停止： 选择 Cancel all，开始新任务前检查已完成和部分完成邮箱。
• 需要记录： 在详情页使用 Download CSV 获取每行当前状态。

抽查源和目标文件夹前，不要删除旧邮箱或更改 MX 记录。日后补充迁移时，请建立新批次并选择 Skip duplicates。

常见问题

找不到目标邮箱

在 TrekMail 中创建目标邮箱，修正 CSV 地址并重新预览。目标必须属于启动批次的同一 TrekMail 账户。

身份验证或连接失败

重新打开旧提供商的邮件客户端设置，再次复制主机、端口、安全选项、源地址和密码。不要只为连接成功而关闭加密。若提供商要求应用密码，请用它替代普通邮箱密码。

完成后缺少部分邮件

先检查文件夹策略、可选日期筛选器和重复项设置，再比较源与目标文件夹名称。若系统报告部分结果，请继续该行，不要从头重复导入。