thunderbird联系人同步需配置对应插件或协议：一、用cardbook同步carddav服务；二、用zindus同步gmail；三、通过ldap连接samba ad；四、用addressbooks synchronize同步imap文件夹vcard。
如果您希望 Thunderbird 客户端能实时获取并更新外部联系人数据，但当前通讯录始终为空或无法自动刷新，则可能是由于未正确配置同步机制或缺少必要插件。以下是实现 Thunderbird 联系人同步的多种可行路径：
一、使用 CardBook 插件同步 CardDAV 服务（如 Synology Contacts、Nextcloud）
CardBook 是 Thunderbird 官方推荐的开源插件，专为 CardDAV 协议设计，支持双向同步、SSL 加密连接及多账户管理，适用于自建或托管型 CardDAV 服务。
1、在 Thunderbird 中点击菜单栏“工具”→“附加组件和主题”，搜索并安装 CardBook 插件，安装后重启客户端。
2、重启后右键点击左侧通讯录面板空白处，选择“新建通讯簿”。
3、在弹出窗口中选择“远程”，点击“下一步”。
4、将通讯簿类型设为 CardDAV，粘贴目标服务提供的完整 CardDAV URL（例如 Synology Contacts 的 URL 格式为 https://your-nas-domain:5001/v1/contact/xxx/）。
5、输入对应账户的用户名与密码，勾选“启用 SSL/TLS 验证”（若服务使用自签名证书，需提前在 Thunderbird 证书管理器中导入根证书）。
6、点击“完成”，新通讯簿将出现在左侧列表；右键该通讯簿选择“同步”，即可立即拉取远程联系人。
二、通过 Zindus 插件同步 Gmail 联系人
Zindus 利用 Google Contacts API 实现 Thunderbird 与 Gmail 账户的深度集成，可自动映射字段、处理名/姓分离问题，并支持增量同步，避免手动 CSV 导入的繁琐映射。
1、访问 Thunderbird 附加组件页面，搜索并安装 Zindus，重启客户端。
2、点击菜单栏“工具”→“Zindus”→“选项”，在配置界面点击“新增账号”。
3、填写 Gmail 账户邮箱地址，选择同步目标为“本地通讯录”或指定已有通讯簿。
4、关键步骤：在高级设置中关闭 verbose logging 选项，否则将因日志级别过高导致 OAuth 授权失败。
5、点击“Sync Now”，Zindus 将自动完成 OAuth 流程并开始首次全量同步。
三、配置 LDAP 目录连接 Samba AD 域控制器
当 Thunderbird 运行于企业内网环境且组织已部署 Samba Active Directory 域时，可通过 LDAP 协议只读访问全局地址簿（GAL），无需为每个用户单独维护通讯录。
1、进入 Thunderbird 设置界面，右键左侧账户 → “设置” → “撰写与地址” → “地址簿” → 勾选“使用其他 LDAP 服务器” → 点击“编辑目录”。
2、在 LDAP 目录服务器窗口点击“添加”，进入服务器属性配置页。
3、在“常规”选项卡中，输入描述性名称（如“公司AD地址簿”），填写 Samba 域控制器的 FQDN（如 dc01.corp.example.com），基础 DN 设为 dc=corp,dc=example,dc=com。
4、端口设为 389（非加密）或 636（LDAPS），绑定 DN 填写具有查询权限的服务账户（如 cn=ldapreader,cn=users,dc=corp,dc=example,dc=com）。
5、切换至“搜索”选项卡，将搜索过滤器设为 (objectClass=person)，确保能匹配 AD 中所有用户对象。
6、点击“确定”保存，返回主界面后点击顶部地址簿图标，选择该目录名称进行测试查询，输入绑定账户密码完成验证。
四、启用 Addressbooks Synchronize 插件同步 IMAP 文件夹内 vCard
该方法适用于将联系人以 .vcf 文件形式存储于 IMAP 邮箱的专用文件夹中，通过插件实现 Thunderbird 本地通讯录与 IMAP 文件夹的自动上传/下载同步，要求邮箱服务支持 IMAP 文件夹级附件存储。
1、安装 Addressbooks Synchronize 插件，重启 Thunderbird。
2、登录 Web 邮箱界面，在收件箱同级位置新建一个名为 Contacts 的 IMAP 文件夹（部分服务商需命名为“通讯录”或启用中文文件夹支持）。
3、在 Thunderbird 中打开插件设置，选择目标本地通讯簿，将同步目标指向前述 IMAP 文件夹路径。
4、必须勾选 Automatic upload after changes，否则修改本地联系人后不会自动写入 IMAP 文件夹。
5、首次同步前，手动将已有 .vcf 文件拖入该 IMAP 文件夹；插件将在后台扫描并导入全部 vCard 记录。
