联系人从 CardDAV 服务器导入 Contacts：帐户直连与 VCF 文件两条路
痛点场景
NAS 上跑着 CardDAV 服务器套件，全公司的联系人一直存在里面。现在想把通讯录统一收进 Synology Contacts 管理，几百个联系人摆在眼前，手工逐条录是不可能的。官方知识库针对这个迁移给了两条路：一条是添加 CardDAV 帐户直连，适合源端持续可用的场景；一条是导出 VCF 文件再导入，适合一次性搬迁。两条路的入口都在 Contacts 的同一个菜单里。
方法一：添加 CardDAV 帐户直连
操作路径只有四步：
- 启动 Synology Contacts；
- 单击个人通讯簿旁的 +，选择导入通讯簿；
- 选择 CardDAV Server；
- 输入所需信息，单击确定完成设置。
难点全在第三步的服务器地址怎么填。官方按帐户类型给了四种格式（以 NAS IP 192.168.X.X、端口 8443 为例）：
| 帐户类型 | 地址格式与示例 |
|---|---|
| 本地 DSM 帐户 | http(s)://NAS IP:端口/addressbooks/users/您的 DSM 帐户/addressbook，如 https://192.168.X.X:8443/addressbooks/users/admin/addressbook |
| 域帐户 | http(s)://NAS IP:端口/addressbooks/users/大写域名%5C小写用户名/addressbook，如 https://192.168.X.X:8443/addressbooks/users/MYCOMPANY%5Csynotest/addressbook |
| LDAP 帐户 | http(s)://NAS IP:端口/addressbooks/users/用户名%40域/addressbook，如 https://192.168.X.X:8443/addressbooks/users/synotest%40svt.com/addressbook |
| 第三方 CardDAV 服务器 | 通用格式 http(s)://服务器 IP:端口，如 https://192.168.X.X:8443；具体路径向您的 CardDAV 提供商寻求说明 |
三条官方备注要记住：
- 端口是多少，启动 CardDAV Server 套件进入常规设置即可查看；
- 域帐户里的反斜杠
\在地址中要替换为 %5C； - LDAP 帐户里的 @ 要替换为 %40。
方法二：从 VCF 文件导入
源数据先导出、再导入，两段操作：
第一段，在 CardDAV Server 里导出：
- 启动 CardDAV Server；
- 进入通讯簿，双击目标项目——注意一次只能选择一个通讯簿，多个通讯簿要分批做；
- 选择联系人后单击导出。多选技巧：不相邻的联系人按住 Ctrl 逐个点选；相邻的联系人单击第一个，按住 Shift 再单击最后一个，即可选中整段。
第二段，在 Synology Contacts 里导入：
- 启动 Synology Contacts；
- 单击个人通讯簿旁的 +，选择导入通讯簿；
- 选择 vCard 或 Google CSV 文件；
- 浏览上传导出的文件；
- 选择导入到现有通讯簿，或是为这批联系人创建新的通讯簿；
- 单击导入 > 导入通讯簿完成。
两条路怎么选
- 帐户直连适合源端持续运行、两边并存的过渡期——帐户配置好之后，通讯簿作为独立条目出现在 Contacts 里，结构完整；
- VCF 文件适合一次性迁移、或者源端即将下线的场景——导出的是快照，之后源端再有改动不会跟过来，迁移时机要选在通讯录稳定之后；
- 无论哪条路，先拿一个小通讯簿试跑一遍，确认字段映射无乱码，再动全量数据。
预防与建议
- 迁移前在源端做一次联系人去重与格式整理，垃圾数据搬进新系统只会更难清；
- 域帐户、LDAP 帐户的地址格式容易抄错，%5C 与 %40 两个替换先核对再点确定；
- 多通讯簿环境分批导出、分批导入，每批完成后抽几个联系人核对电话与邮箱字段；
- 迁移完成别急着关源端，保留一个观察期，确认新通讯簿使用无异常后再下线旧套件。
联系人这类小数据最怕散，诚鑫致达科技帮客户做邮箱与群件迁移时，通讯录永远单列一条验收项——少一个联系人都算迁移失败。