将 OpenLDAP 的常用管理操作全部 Web 化:目录树浏览、全局搜索、用户管理(增删改、重置密码、启用/禁用)、组管理、OU 管理,并通过 LDAP 账号登录(管理员可管理全库,普通用户可自助查看/修改自己的密码)。
- 后端:Node.js + Express + ldapjs
- 前端:原生 HTML/JS/CSS 单页应用
- 测试环境:Docker(osixia/openldap)
# 1. 准备环境配置
cp .env.example .env # 按实际环境修改 LDAP 连接信息
# 2. 启动 OpenLDAP 测试环境(已有服务器可跳过)
docker compose up -d
# 3. (测试环境可选)启用 ppolicy 账号锁定支持 + 初始化示例数据
bash scripts/setup-ldap.sh
# 4. 安装依赖并启动
npm install
npm start访问 http://localhost:3000,使用 LDAP 账号登录:
- 测试环境管理员:用户名
admin,密码admin123 - 普通用户:如测试数据中的
zhangsan / Passw0rd!
| 变量 | 说明 | 默认值 |
|---|---|---|
| LDAP_URL | LDAP 服务器地址 | ldap://localhost:389 |
| LDAP_BIND_DN | 管理服务绑定的 DN | cn=admin,dc=example,dc=org |
| LDAP_BIND_PASSWORD | 管理绑定密码 | admin123 |
| LDAP_BASE_DN | 管理范围 Base DN | dc=example,dc=org |
| LDAP_USER_SEARCH_BASE | 用户登录搜索基础 | 同 BASE_DN |
| LDAP_USER_SEARCH_FILTER | 登录用户搜索过滤器 | (uid={0}) |
| LDAP_ADMIN_UIDS | 拥有管理权限的 uid 列表 | admin |
| LDAP_ADMINS | 拥有管理权限的 DN 列表 | - |
| PORT | Web 服务端口 | 3000 |
| SESSION_SECRET | 会话密钥(务必修改) | - |
| 方法 | 路径 | 说明 | 权限 |
|---|---|---|---|
| POST | /api/auth/login | LDAP 账号登录 | - |
| POST | /api/auth/logout | 退出 | 登录 |
| GET | /api/auth/me | 当前用户信息 | 登录 |
| POST | /api/auth/me/password | 自助修改密码 | 登录 |
| GET | /api/directory/children | 目录树子节点(懒加载) | 登录 |
| GET | /api/directory/search | 全局搜索 | 登录 |
| GET | /api/directory/entry | 条目详情 | 登录 |
| POST | /api/directory/ou | 创建 OU | 管理员 |
| DELETE | /api/directory/entry | 删除条目(?recursive=true 递归) | 管理员 |
| POST | /api/directory/entry/rename | 重命名/移动 | 管理员 |
| GET | /api/users/list | 用户列表(支持关键字) | 管理员 |
| POST | /api/users | 创建用户 | 管理员 |
| GET/PUT/DELETE | /api/users/detail | 用户详情/更新/删除 | 管理员 |
| POST | /api/users/detail/password | 重置密码(generate=true 随机生成) | 管理员 |
| POST | /api/users/detail/enable | 启用/禁用账号 | 管理员 |
| GET | /api/groups/list | 组列表 | 管理员 |
| POST | /api/groups | 创建组 | 管理员 |
| PUT | /api/groups/detail | 更新组信息 | 管理员 |
| POST | /api/groups/detail/members | 成员增删 | 管理员 |
| DELETE | /api/groups/detail | 删除组 | 管理员 |
禁用账号通过 shadowAccount 的 shadowExpire=1(1970-01-01,恒为过期)实现,使用 OpenLDAP 默认自带 schema,无需额外 overlay。本服务登录时会拒绝已禁用账号;依赖 NSS/PAM shadow 语义的系统同样会视其为过期账号。
测试环境首次启动后可运行 bash scripts/setup-ldap.sh 初始化 OU、示例用户和组。
- 修改 SESSION_SECRET 为随机值
- 前置 Nginx 做 HTTPS
.env中 LDAP_ADMINS / LDAP_ADMIN_UIDS 精确指定管理员- 如需限制管理范围,将 LDAP_BASE_DN 设为子树
# 端到端 API 测试(需先启动 OpenLDAP 测试容器与本服务)
node scripts/test-api.mjs覆盖:登录/会话、目录树、用户 CRUD、重置密码、禁用/启用、组管理、OU 管理、中英文搜索、自助改密、权限隔离、越界 DN 防护等 29 项。
已知问题:ldapjs 的 LDAP 子串过滤器对非 ASCII 字符存在编码 bug,中文关键字搜索已自动降级为"服务端拉取 + 应用层过滤",功能不受影响。