mwaeckerlin/openldap

OpenLDAP Server

镜像概述和主要用途

基于Ubuntu默认配置的OpenLDAP服务器，初始设置通过环境变量进行配置，提供LDAP核心服务及TLS/SSL加密功能，支持数据备份与恢复机制，适用于企业内部用户认证、权限管理、目录服务等场景。

核心功能和特性

• 通过环境变量实现初始参数配置，简化部署流程
• 支持LDAP（389端口）和LDAP+SSL（636端口）协议
• 提供数据自动备份与手动恢复功能，保障数据安全
• 可自定义索引配置，优化目录查询性能
• 支持SSL/TLS加密，需挂载Let's Encrypt证书配置

使用场景和适用范围

适用于需要轻量级目录服务的场景，包括但不限于：

• 企业内部用户身份认证系统
• 应用系统权限管理目录
• 统一用户信息管理平台
• 邮件系统地址簿服务

详细配置说明

环境变量

• DOMAIN（必填）
  域名，例如example.org。根据域名生成可分辨名称（DN），格式为cn=example,cn=org。
• PASSWORD（可选）
  管理员密码，管理员账号由DOMAIN派生，格式为cn=admin,dc=example,dc=org。若未提供，将自动生成随机密码并输出到Docker日志。
• DEBUG（可选）
  调试级别，默认为0（无调试输出），数值越高输出越详细。
• INDEXES（可选）
  LDAP服务器需维护的索引列表，空格分隔，例如：index uid eq index cn eq。

端口

• 389：LDAP基础服务端口，支持startTLS加密
• 636：LDAP+SSL加密服务端口

卷

• /var/lib/ldap：LDAP数据库存储目录，需持久化以保留数据
• /ssl：SSL证书挂载目录，需映射Let's Encrypt配置目录（/etc/letsencrypt）以启用TLS/SSL
• /etc/ldap：配置文件目录，包含服务器核心配置
• /var/backups：自动备份文件存储目录
• /var/restore：恢复文件存放目录，重启容器时将自动从此目录恢复备份

使用示例

启动OpenLDAP服务器

bash
docker run -it --rm --name openldap \
           -p 389:389 \
           -e DEBUG=1 \
           -e DOMAIN=my-company.com \
           -e PASSWORD=1234567890 \
           mwaeckerlin/openldap

访问说明

启动后可通过LDAP客户端工具（如Apache Directory Studio）访问服务：

• 服务器地址：ldap://localhost:389
• 管理员账号：cn=admin,dc=my-company,dc=com（由DOMAIN自动生成）
• 管理员密码：1234567890（通过PASSWORD参数设置）

备份与恢复

创建备份

通过以下命令生成LDAP数据备份文件：

bash
slapcat -l data.ldif

恢复备份

1. 将备份文件（命名需匹配*data.ldif格式）复制到/var/restore卷中
2. 重启容器，系统将自动检测并恢复备份
3. 恢复成功后，备份文件将被移动到/var/backups/<date>-restored-data.ldif（为恢复日期）

自动备份机制

每次容器重启时，系统会自动在/var/backups/<date>-startup-data.ldif生成数据备份（为启动日期）。

2018-04-13后升级注意事项

基础镜像已从Ubuntu更换为Alpine，镜像大小从约500MB减少至约15MB，但存在以下不兼容变更：

• 配置文件格式变更为slapd.conf
• 数据库类型从hdb变更为mdb

重要：旧版本数据库无法直接迁移使用，需先通过旧版本容器创建数据备份，升级后再通过恢复机制导入数据。