streamsets/openldap

Docker OpenLDAP 镜像文档

镜像概述

本镜像为 https://github.com/dinkel/docker-openldap 的分支版本，旨在提供轻量级目录访问协议（OpenLDAP）服务器的容器化部署方案。OpenLDAP 是一款开源的目录服务实现，用于存储和管理用户、组织、设备等结构化目录信息，广泛应用于企业级身份认证与授权场景。

核心功能与特性

• 基于 OpenLDAP 官方组件构建，提供标准 LDAP 协议支持
• 支持目录数据持久化存储，确保服务重启后数据不丢失
• 可配置的目录结构，支持自定义域名（Domain）和组织信息
• 内置基础访问控制策略，可通过配置文件扩展权限管理
• 支持通过环境变量快速配置核心参数（如管理员密码、域名等）

使用场景与适用范围

• 企业内部用户身份认证与权限管理系统
• 应用系统的集中式用户目录服务
• 开发测试环境中的 LDAP 服务模拟
• 需要轻量级目录服务支持的中小型系统

使用方法与配置说明

基本运行命令

通过以下命令可快速启动 OpenLDAP 服务：

bash
docker run -d \
  --name openldap \
  -p 389:389 \
  -e LDAP_DOMAIN=example.com \
  -e LDAP_ORGANISATION="Example Organization" \
  -e LDAP_ADMIN_PASSWORD=admin123 \
  -v openldap-data:/var/lib/ldap \
  -v openldap-config:/etc/ldap/slapd.d \
  [镜像名称]

参数说明

环境变量

数据卷挂载

验证服务

服务启动后，可通过 LDAP 客户端工具（如 ldapsearch）验证连接：

bash
ldapsearch -x -H ldap://localhost:389 -b "dc=example,dc=com" -D "cn=admin,dc=example,dc=com" -w admin123

若返回目录信息，则表示服务运行正常。

docker-compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  openldap:
    image: [镜像名称]
    container_name: openldap
    ports:
      - "389:389"
    environment:
      - LDAP_DOMAIN=example.com
      - LDAP_ORGANISATION=Example Organization
      - LDAP_ADMIN_PASSWORD=admin123
    volumes:
      - openldap-data:/var/lib/ldap
      - openldap-config:/etc/ldap/slapd.d
    restart: unless-stopped

volumes:
  openldap-data:
  openldap-config:

启动服务：

bash
docker-compose up -d

注意事项

• 生产环境中建议启用 TLS/SSL 加密（可通过挂载证书文件实现）
• 管理员密码应使用强密码，并避免明文暴露
• 数据卷需定期备份，防止数据丢失
• 如需自定义 LDAP 架构或访问控制策略，可通过挂载配置文件实现扩展