邮箱搬家功能用于将用户旧邮箱中的邮件搬到新邮箱，从而保证企业员工在企业邮箱成功迁移后可正常读取历史邮件。邮箱搬家是以 POP/IMAP 取信的方式将旧邮箱系统的邮件迁移到云享版企业邮箱，类似通过客户端收取旧邮箱服务器的邮件。
使用邮箱搬家进行系统迁移，需要满足以下条件：
1、旧邮箱系统必须开通 POP 或 IMAP 功能，且旧邮箱帐号 IMAP 或 POP 协议登录正常；
2、企业仅需迁移用户、密码和邮件数据，无其他特殊数据迁移需求。（如还需迁移个人通讯录、网络硬盘数据，推荐使用 migration 迁移工具，如有其它特殊需求则需进行定制化方案评估。）；
3、邮箱搬家适用的新、旧邮箱系统类型情况说明如下：
|
旧邮箱系统类型 |
新邮箱系统类型 |
是否适用 |
备注 |
|
企业邮箱（ 公有 云） |
企业邮箱（ 公有 云） |
是 |
优先推荐使用邮箱搬家 |
|
企业邮箱（ 公有 云） |
自建系统 |
是 |
优先推荐使用邮箱搬家 |
|
自建系统 |
企业邮箱（ 公有 云） |
是 |
优先推荐使用邮箱搬家 |
使用邮箱搬家进行系统迁移主要有五个阶段，每个阶段包含的关键步骤及说明如下：
图 1 邮箱搬家五个关键阶段
1、确认旧邮箱信息及相关参数
（1） 确认旧邮箱是否已开通 POP 或 IMAP
· 未开通 POP 或 IMAP 无法进行邮箱搬家
· 邮箱搬家只能采用 POP 或 IMAP 其中一种方式，使用 POP 方式只能搬取旧邮箱【收件箱】中的邮件；使用 IMAP 方式可搬取旧邮箱【收件箱】、
【发件箱】、【已删除】、【草稿箱】、【垃圾邮件】及用户自定义文件夹中的历史邮件。因此，若企业旧邮箱支持 IMAP，则在搬家时尽量选用 IMAP方式。
（2） 明确旧邮箱服务器地址及端口号
· 此为开通邮箱搬家的必填参数
· 需要企业邮箱管理员与旧邮箱运营商进行确认，例如腾讯企业邮的 IMAP服务器地址为 imap.exmail.qq.com，端口号为 143；服务器地址也可为具体的 IP 地址。
（3） 提供可供测试的旧邮箱账号和密码
· 需企业邮箱管理员提供可在旧邮箱中正常使用 POP 或 IMAP 的邮箱账号及密码，用于开通邮箱搬家前进行旧服务器连接测试。
2、在企业邮箱中创建组织及用户
（1） 根据企业实际组织架构需求，在 Coremail webadmin 创建组织及部门；
（2） 在对应的组织及部门下创建邮箱用户
· 在开通邮箱搬家前，必须在企业邮箱系统中创建好组织和用户
· 创建的用户账号必须与旧邮箱用户账号一致，例如旧邮箱中用户 A 账号为 a@123.com，在 Coremail 中用户 A 的账号也必须为 a@123.com。
· 管理员可逐个创建用户，也可以批量导入邮箱用户。需按照批量导入邮箱用户的文件格式要求上传文件并导入用户。
· 无论是逐个创建还是批量导入用户，用户初始密码必须勾选“支持用旧邮箱密码登录 webmail”，才能为用户开启邮箱搬家。
图 2 管理员逐个创建用户
图 3 管理员批量导入邮箱用户
3、开启邮箱搬家
（1） 确认上述 1、2 阶段准备工作到位后，进入 Coremail webadmin＞组织与用户＞邮箱搬家＞邮箱搬家向导，设置搬家组织。
图 4 搬家组织设置界面
设置说明：
|
设置项 |
作用描述 |
参数设置说明 |
|
搬家组织 |
确定云享版企业邮箱系统中需要进行旧邮箱搬家的用户范围，所选范围内的用户才会进 行邮箱搬家。 |
1、可选择整个组织； 2、也可以选择部分用户，支持跨组织、跨部门选择用户范围； |
|
搬家域名 |
该功能在 XT5 标准产品中无实际作用，可忽略（待后续产品 优化流程） |
—— |
|
搬 迁 邮 件收发时间 |
确定旧邮箱历史邮件的搬迁范围，让企业可以根据实际需求选择搬迁指定时间内的旧邮 件，缩短邮箱搬家的时间 |
可选择全部、近三个月内、近半年内、近一年内的历史邮件，也支持搬迁从自定义时间起的历 史邮件 |
|
收 取 时 保留 邮 件 备份 |
在使用 POP 方式进行邮箱搬家时，可选择收取时是否保留旧邮箱中邮件备份；勾选则在进 行 POP 收取时保留旧邮箱邮件 |
1、使用 IMAP 方式搬家，无论此处是否勾选，收取时都将保留旧邮箱中的邮件备份 2、使用 POP 方式搬家，建议管 |
|
|
备份，不勾选则在完成 POP 搬迁后，用户旧邮箱中的相应邮 件不复存在。 |
理员勾选“收取时保留邮件备份” |
|
支持 SSL |
若旧邮箱支持 SSL，搬家时可选 择支持 SSL，以增强传输安全。 |
—— |
（2） 对旧邮箱进行运营商设置
完成第（1）步后，点击下一步进入“运营商设置”：
图 5 运营商设置界面
设置说明：
|
设置项 |
作用描述 |
参数设置说明 |
|
服 务 商 选择 |
该功能在 XT5 标准产品中无实际作用，默认勾选“其他邮箱”，且不可更改（待后续产 品优化流程） |
—— |
|
搬家方式 |
选择 POP 或 IMAP 方式进行搬家 |
1、使用 POP 方式只能搬取旧邮箱 【收件箱】中的邮件； 2、使用 IMAP 方式可搬取旧邮箱 【收件箱】、【发件箱】、【已删除】、【草稿箱】、【垃圾邮件】及用户自定义文件夹中的历史邮件。因此，若企业旧邮箱支 |
|
|
|
持 IMAP， 则在搬家时尽量选用 IMAP 方式。 |
|
邮 件 搬 迁至 新 邮 箱中 的 文 件夹设置 |
从旧邮箱搬迁到云享版企业邮箱的邮件，可设置将邮件放置在哪些文件夹中。 |
1、使用 POP 方式搬家，只能选择将邮件放在收件箱，或另外新建文件夹集中放置； 2、使用 IMAP 方式搬家，可选择 “按照旧系统文件夹显示”，即将旧邮箱中的文件夹目录迁移到用户的云享版邮箱，且旧邮件的位置与旧邮箱保持一致；也可以 另外新建文件夹集中放置。 |
|
服 务 器 地 址 |
用于连接旧邮箱服务器 |
1、需要企业邮箱管理员确认，必要时可咨询旧邮箱服务提供商 2、支持 SSL 与不支持 SSL 的服务器地址和端口可能不同，需提前 确认清楚 |
|
服 务 器 端口 |
（3） 旧邮箱服务器连接测试
完成第（2）步后，填写在旧邮箱可正常使用的账号和密码，需确认该账号相应的 POP 或 IMAP 协议登录正常。正确填写测试账号后，点击“测试”：
图 6 旧邮箱服务器连接测试
测试成功界面将进行提示：
图 7 测试成功提示
若界面提示“连接服务器失败”（如图 8），请检查:
· 旧邮箱服务器地址及端口号是否正确；
· 测试账号密码是否正确，可使用该账号登录旧邮箱验证；
· 测试账号除了账号密码外，是否开启了其他验证方式。例如在迁移腾讯企业邮箱时，因测试账号开启强制启用安全登录且绑定了微信验证，在进行旧邮箱服务器连接测试时，无法直接验证通过，解除微信登录验证后，再次测试可成功连接到腾讯企业邮箱服务器；
图 8 测试成功提示
（4） 测试成功后开通搬家
第（3）步中提示“连接服务器成功”后，点击“开通搬家”，此时已成功开通邮箱搬家。
图 9 成功开通邮箱搬家页面
4、执行邮箱搬家
第 3 步成功开通邮箱搬家并不等于系统已经开始进行邮件搬家，还需要邮箱用户本人或者管理员触发搬家，系统才会正式开始执行对旧邮箱账号的邮件搬运工作。
触发邮箱搬家正式执行的方式有两种可选，说明如下：
|
执行搬家的方 式 |
操作者 |
必要条件 |
特点 |
|
用户自主搬家 |
邮箱用户 |
1、用户使用旧邮箱账号密 码 登 录 Coremail webmail 2、输入旧邮箱密码开启搬家。 |
1 、用户只有在登录 webmail 且主动开启搬家才能触发搬家，因此搬家的时间和进度不可控； 2、管理员在开通搬家后，需要通过其他方式通知到搬家用户，以提醒和引导用户自 主完成搬家 |
|
管理员统一搬家 |
邮箱管理员 |
管理员需要知道所有搬家用户的旧邮箱账号和密码 |
1 、无需用户主动触发，用户无感知；管理员后台统一控制，时间和搬家进度可控； 2、需要管理员将搬家用户的旧邮箱账号和密码整理成 csv 文件 导入并启动搬家 |
两种触发方式具体操作步骤如下：
（1） 用户自主搬家
在管理员完成第 3 步开通邮箱搬家后，建议通过邮件、IM 等方式通知到搬家用户，提醒与引导邮箱用户启动搬家。
用户自主搬家的操作流程及界面示意图如下：
图10 用户自主搬家操作流程
（2） 管理员统一搬家
管理员需首先将搬家用户的旧邮箱账号及密码整理成 csv 文件，可在 Coremail webadmin＞组织与用户＞邮箱搬家＞邮箱搬家状态查询中，点击顶部功能栏中的“导入邮箱账号密码进行搬家”，下载 csv 文件模板，按文件格式要求整理需要搬家的用户账号和密码。
图 11 通过文件上传导入搬家用户
管理员统一搬家的操作流程及界面示意图如下：
图 12管理员统一搬家界面操作流程
5、完成邮箱搬家
管理员可进入“邮箱搬家状态查询”页面，查看本次搬家用户的搬家状态。若全部搬家用户搬家状态均变为“搬家已结束”，则表示本次邮箱搬家已完成。
图 13 邮箱搬家状态查询界面
搬家状态每次只能选择一个组织或一个部门范围进行查看，也可以直接搜索用户账号查询。
搬家状态共有 5 种，分别为：
|
搬家状态 |
描述 |
|
未执行搬家 |
用户自主搬家模式下，搬家用户未在 webmail 输入正确的 旧邮箱密码确认搬家 |
|
搬家中 |
1、用户自主搬家模式下，用户输入正确的密码并连接服务器成功后，进入“搬家中”状态； 2、管理员导入账号密码搬家模式下，管理员导入 csv 文件解析并确认开始执行后，所导入的搬家账号进入“搬家中”状态； 3、以上两种模式开始执行后，以下状态也显示为“搬家中”： · 账号连接成功，处于队列中等待；
· 账号中的邮件开始迁移到新系统；
· 能连接到对方的服务器但是超过了等待时间，系统进行重试； |
|
|
· 在与服务器连接过程中出现的通讯延迟或者中断，系统进行重试； · 网络不通找不到对方服务器 ip，系统进行重试 |
|
搬家已结束 |
搬家账号的邮件搬迁进度达到 100% |
|
搬家失败 |
以下情况会显示为“搬家失败”状态： 1、搬家过程中用户修改旧邮箱密码会导致搬家失败； 2、管理员导入的账号密码中，用户在旧邮箱中不存在，会显示为“搬家失败”状态； 3、在与服务器连接过程中出现的通讯延迟或者中断，重试次数达到阈值 4、网络不通找不到对方服务器 ip，重试次数达到阈值 5、除了以上原因之外的所有原因，主要为搬家程序问题，需内部协助排查 其中，1、2 会提示“服务器上没有用户或密码不对”；3会提示“服务器通讯超时”；4 会提示“不能连接到服务 器”。 |
|
搬家已取消 |
对还处于未执行搬家状态的账号执行取消搬家操作 |
1、已完成邮箱搬家，但搬迁过来的邮件数据不完整
【问题描述】
开通邮箱搬家后，用户执行邮箱搬家且最终完成搬家，未显示跳过邮件。而实际上旧邮箱收件箱有 1000 多封邮件，最终仅成功搬迁了 100 多封邮件。
【产生原因】
可能的原因：旧邮箱 POP/IMAP 未设置“收取全部邮件”。以 126、263邮箱为例：
图 14 126 邮箱 POP3/SMTP/IMAP 设置
图 15 263 邮箱客户端收信设置
【解决方法】
需将旧邮箱客户端收信设置为“收取全部邮件”
2、完成搬家且新邮箱切换上线后，用户客户端出现重复收信或丢失邮件的情况。
【问题描述】
1、在新邮箱切换上线后，用户 POP 协议客户端重复收信
2、新邮箱切换上线后，用户 IMAP 协议客户端本地邮件丢失
【产生原因】
问题 1 是由于新邮箱系统将邮件判定为新邮件，导致客户端重新收取；
问题 2 是因为这部分丢失的邮件在客户端本地有，而新邮箱服务端没有，IM
AP客户端在与服务端进行同步后，客户端本地此部分邮件丢失。
【解决方法】
问题 1 解决方法：设置邮箱搬家时，选择将邮件迁移到新建的文件夹，可避免 POP 客户端重复收件；
问题 2 解决方法：事先通知用户做好备份
粤公网安备:44010402001679号
