OpenLDAP 测试用模拟服务器 Docker 镜像

!Docker Stars !Docker Pulls

该镜像提供了一个用于测试LDAP应用（如单元测试）的OpenLDAP服务器。默认情况下，服务器会使用示例域ldapmock.local以及一组posix用户/组进行初始化。

本镜像基于@rroemhild的docker-test-ldap项目构建。

本镜像非自动构建，源代码可在相关Git仓库获取。

如标题所示，本镜像仅用于测试，绝不可用于任何生产环境。 slapd配置极简，容器不将任何数据存储在持久卷中。模拟数据在容器创建时引导生成，删除容器时即丢失。

特性

• 支持TLS（构建时生成自签名证书）
• 容器启动时初始化默认模拟数据或自定义配置数据（见下文）
• 镜像大小约110MB（bzip压缩后约30MB）

使用方法

首先需将镜像拉取到本地

bash
docker pull thoteam/slapd-server-mock

使用默认数据启动

可快速启动一个使用默认模拟数据初始化的容器：

bash
# 在Docker网络中供其他容器访问
docker run -d --name my_slapd_mock --network my-network thoteam/slapd-server-mock
# 从本地主机或网络中其他主机访问slapd容器
docker run -d -p 389:389 -p 636:636 --name my_slapd_mock thoteam/slapd-server-mock

自定义容器

可通过环境变量和挂载自定义文件轻松定制用于初始化模拟实例的数据。

环境变量

可在容器中设置以下环境变量：

以下变量由上述变量计算得出（若手动设置将覆盖计算值）：

引导配置和数据

容器命令run.sh会启动slapd-init.sh脚本。

slapd-init.sh脚本期望在$BOOTSTRAP_DIR目录下存在两个LDIF模板文件：

• config.ldif.TEMPLATE：包含slapd配置和 schema 的调整指令
• data.ldif.TEMPLATE：包含服务器中实际存在的条目（如用户和组）

这些文件可包含bash变量表达式，容器启动时会通过gettext包的envsubst命令替换为环境变量值。默认数据模板允许根据所选域名配置所有条目的LDAP_BASEDN。

要覆盖这些文件，只需将本地文件挂载到容器中相应位置。如有需要，可通过设置$BOOTSTRAP_DIR更改容器中默认的/bootstrap目录位置。

bash
# 仅覆盖数据
docker run -d --name my_slapd_mock -v /path/to/my/data.ldif:/bootstrap/data.ldif.TEMPLATE thoteam/slapd-server-mock

# 同时覆盖数据和配置
docker run -d --name my_slapd_mock -v /path/to/my/bootstrap_dir:/bootstrap thoteam/slapd-server-mock

# 在自定义位置覆盖
docker run -d --name my_slapd_mock -v /path/to/my/bootstrap_dir:/customdir -e BOOTSTRAP_DIR=/customdir thoteam/slapd-server-mock

暴露端口

• 389 (ldap://)
• 636 (ldaps://)

默认LDAP结构

默认LDAP对象定义详见bootstrap/data.ldif。所有用户的密码均为：password

dc=ldapmock,dc=local
|    cn=admin,dc=ldapmock,dc=local
|
└─── ou=people,dc=ldapmock,dc=local
|    |    uid=adminuser1,ou=people,dc=ldapmock,dc=local
|    |    uid=adminuser2,ou=people,dc=ldapmock,dc=local
|    |    uid=developper1,ou=people,dc=ldapmock,dc=local
|    |    uid=developper2,ou=people,dc=ldapmock,dc=local
|    |    uid=developper3,ou=people,dc=ldapmock,dc=local
|    |    uid=developper4,ou=people,dc=ldapmock,dc=local
|
└─── ou=groups,dc=ldapmock,dc=local
     |
     └─── cn=admin,ou=groups,dc=ldapmock,dc=local
     |    |    memberUID:adminuser1
     |    |    memberUID:adminuser2
     |
     └─── cn=developers,ou=groups,dc=ldapmock,dc=local
          |    memberUID:developper1
          |    memberUID:developper2
          |    memberUID:developper3
          |    memberUID:developper4