Directory Bind 是一款强大的开源目录同步工具，主要用于将 Active Directory（AD）或其他 LDAP 目录中的用户、联系人、组等对象同步到目标系统，如 Google Workspace、Microsoft 365、其他 LDAP 服务器等，本文将详细介绍 Directory Bind 的安装、配置、使用方法及常见问题解决，帮助用户快速掌握其核心功能。
环境准备与安装
在开始使用 Directory Bind 前，需确保满足以下环境要求：
- 操作系统：支持 Linux（如 Ubuntu、CentOS）、Windows 或 macOS，推荐使用 Linux 服务器以获得更好的稳定性。
- Java 运行环境：Directory Bind 基于 Java 开发，需安装 JDK 8 或更高版本（可通过
java -version检查）。 - 目标系统权限：需拥有目标系统（如 Google Workspace）的管理员权限，以便配置 API 访问和同步范围。
安装步骤：
- 下载安装包：访问 Directory Bind 官方 GitHub 仓库（https://github.com/directorybind/directorybind），下载最新版本的 WAR 包或 JAR 包。
- 部署到服务器：
- 若使用 WAR 包，可将其部署到 Tomcat、Jetty 等 Servlet 容器中，配置容器端口（如 8080）。
- 若使用 JAR 包，直接通过命令行运行：
java -jar directorybind.jar。
- 初始化配置：首次启动后，访问
http://服务器IP:8080，进入 Web 管理界面，按提示完成初始设置（如设置管理员账号、时区等）。
核心配置流程
Directory Bind 的配置主要分为“连接源目录”和“配置目标系统”两部分，以下以 Active Directory 同步到 Google Workspace 为例说明。
连接源目录（Active Directory）
- 基础信息：在“源目录”配置中，选择 LDAP 作为协议，输入 AD 服务器的 IP/域名、端口（默认 389 或 636）、管理员账号及密码。
- 连接测试：点击“测试连接”，若成功，会返回 AD 的根 DN（如
dc=example,dc=com）。 - 对象映射：定义 AD 属性与目标系统字段的对应关系。
| AD 属性 | Google Workspace 字段 | 说明 |
|---------------|------------------------|--------------------------|
|
sAMAccountName|primaryEmail| 用户邮箱前缀 | |displayName|name.fullName| 用户全名 | |mail|emails[0].address| 邮箱地址（可选） |
配置目标系统（Google Workspace）
- API 权限：需在 Google Cloud Console 启用 Admin SDK API，并创建 OAuth 2.0 客户端 ID，下载 JSON 密钥文件。
- 目标连接：在 Directory Bind 中选择 Google Workspace 作为目标，上传 JSON 密钥文件，测试连接。
- 同步规则：设置同步范围（如同步特定 OU 的用户）、冲突解决策略（如“目标系统优先”）、同步周期（如每 30 分钟一次）。
执行同步与监控
- 手动同步：在“任务管理”界面，点击“立即执行”可手动触发全量同步。
- 日志查看：通过“日志”页面查看同步详情，包括成功/失败数量、错误原因（如属性冲突、权限不足）。
- 定时任务：支持通过 Cron 表达式配置定时同步，
0 */30 * * * *表示每 30 分钟同步一次。
高级功能与优化
- 增量同步：Directory Bind 默认支持基于时间戳的增量同步，仅同步变更对象，可大幅提升效率。
- 自定义脚本：可通过 Groovy 脚本处理复杂逻辑，如动态生成邮箱别名、过滤特定用户等。
- 多实例部署：在高并发场景下，可部署多个 Directory Bind 实例，通过负载均衡分担压力。
常见问题解决
-
问题1：同步时报错“LDAP 连接超时”
解答：检查 AD 服务器防火墙是否开放 389/636 端口，或确认 LDAP 服务是否正常运行，可通过ldapsearch -h AD_IP -p 389 -x -b "dc=example,dc=com"命令测试连通性。
（图片来源网络，侵删） -
问题2：Google Workspace 同步时部分用户缺失
解答：确认 AD 中这些用户的mail属性是否为空，或检查目标系统字段映射是否正确，可在“对象映射”中添加可选字段，或启用“跳过空值”选项。
相关问答 FAQs
Q1：Directory Bind 是否支持双向同步？
A1：Directory Bind 主要设计为单向同步工具（从源到目标），若需双向同步，可通过配置两个同步任务（如 AD→Google 和 Google→AD）实现，但需注意冲突处理逻辑，避免循环同步。
Q2：如何处理同步过程中的敏感数据（如密码）？
A2：Directory Bind 不会同步密码等敏感信息，仅同步用户属性，若需密码同步，需结合目标系统的密码同步功能（如 Google Directory Sync 的密码哈希同步），并确保传输过程启用 TLS 加密。
