akhilrajmailbox/ldap-server

LDAP Server with Web UI (LAM / phpLDAPadmin)

镜像概述

本镜像提供了一个开箱即用的 LDAP（轻量级目录访问协议）服务器环境，并集成了 Web 管理界面。根据版本不同，内置了 LDAP Account Manager (LAM) 或 phpLDAPadmin，方便用户通过图形化界面管理 LDAP 目录树、用户和权限。镜像支持 SSL/TLS 加密配置，并提供针对 Docker Swarm 集群和传统单机环境的部署方案。

核心功能和特性

• 集成 LDAP 服务：内置 OpenLDAP (slapd) 服务，提供高性能的目录存储与查询能力。
• 双版本 Web UI 支持：
  • LAM 版本（基于 Ubuntu 22.04）：提供现代化的 LDAP Account Manager 界面，推荐用于 Docker Swarm 生产环境。
  • phpLDAPadmin 版本（基于 Ubuntu 14.04）：提供经典的 phpLDAPadmin 界面，适用于传统单机快速部署。
• SSL/TLS 安全加密：支持自定义 SSL 证书配置，保障 LDAP 通信（LDAPS）和 Web UI（HTTPS）的数据安全。
• 集群与安全管理：完美适配 Docker Swarm，支持通过 Docker Secrets 安全注入管理员密码和 SSL 证书。
• 数据持久化：提供完善的目录挂载方案，确保 LDAP 数据库、配置文件和备份数据不丢失。

使用场景和适用范围

• 企业内网统一身份认证（SSO）与单点登录基础设施。
• 集中式用户、用户组及权限管理系统。
• DevOps 工具链（如 Jenkins, GitLab, SonarQube 等）的底层认证提供者。
• 需要轻量级目录服务的中小型微服务架构。

---

环境变量与配置参数

LAM 版本 (Swarm 部署)

在 Docker Swarm 环境中，敏感信息建议通过 Secrets 传递，常规配置通过环境变量传递：

phpLDAPadmin 版本 (单机部署)

通过 env-file 传递以下环境变量：

---

部署指南

方案一：Docker Swarm 部署 (推荐，使用 LAM)

1. 前置条件

• Docker Engine 19.03.0+ (Compose specification: 3.8)。
• 客户端和守护进程 API 版本至少为 1.24。

2. 创建自定义 Overlay 网络

bash
docker network create --driver=overlay --subnet=172.29.1.0/24 swarm-network

3. 创建 Docker Secrets

bash
echo "YourAdminPassword" | docker secret create LDAP_ADMIN_PASS_SECRET -
echo "YourHtPassword" | docker secret create LDAP_HTPASSWORD_SECRET -
docker secret create MY_SSL_CERT_SECRET ./example.crt
docker secret create MY_SSL_KEY_SECRET ./example.key
docker secret create MY_SSL_BUNDLE_SECRET ./example-bundle.crt

4. 创建数据持久化目录

bash
mkdir -p /DevOps/ldap-server/{apache2,lib-ldap-account-manager,etc-ldap-account-manager,ldap,ldapdb-backups,slapd.d}

5. 编写 Compose 文件并部署

创建 Ldap-swarm.yml 文件：

yaml
version: '3.8'
services:
  ldap-server:
    image: docker.xuanyuan.run/akhilrajmailbox/ldap-server:lam-1.0.0
    environment:
      LDAP_DOMAIN: "devops.example.com"
      LDAP_ORGANISATION: "devops"
      SSL_CONFIG: "y"
      HTPASSWORD_FILE: "/run/secrets/LDAP_HTPASSWORD_SECRET"
      LDAP_ADMIN_PASS_FILE: "/run/secrets/LDAP_ADMIN_PASS_SECRET"
      SSL_CERT: "/run/secrets/MY_SSL_CERT_SECRET"
      SSL_KEY: "/run/secrets/MY_SSL_KEY_SECRET"
      SSL_CACERT: "/run/secrets/MY_SSL_BUNDLE_SECRET"
    secrets:
      - LDAP_HTPASSWORD_SECRET
      - LDAP_ADMIN_PASS_SECRET
      - MY_SSL_CERT_SECRET
      - MY_SSL_KEY_SECRET
      - MY_SSL_BUNDLE_SECRET
    ports:
      - target: 636
        published: 636
        protocol: tcp
        mode: host
      - target: 443
        published: 443
        protocol: tcp
        mode: host
    deploy:
      mode: replicated
      replicas: 1
      update_config:
        parallelism: 1
        delay: 10s
        failure_action: pause
        monitor: 5s
        order: stop-first
      restart_policy:
        condition: any
        delay: 10s
        max_attempts: 5
      placement:
        max_replicas_per_node: 1
        constraints:
          - "node.role==manager"
          - "node.platform.os==linux"
      resources:
        limits:
          cpus: "1"
          memory: 2G
        reservations:
          cpus: "0.100"
          memory: 0.5G
    volumes:
      - /DevOps/ldap-server/apache2:/etc/apache2
      - /DevOps/ldap-server/lib-ldap-account-manager:/var/lib/ldap-account-manager
      - /DevOps/ldap-server/etc-ldap-account-manager:/etc/ldap-account-manager
      - /DevOps/ldap-server/ldap:/var/lib/ldap
      - /DevOps/ldap-server/ldapdb-backups:/var/backups
      - /DevOps/ldap-server/slapd.d:/etc/ldap/slapd.d
    networks:
      - swarm-network

secrets:
  LDAP_HTPASSWORD_SECRET:
    external: true
  LDAP_ADMIN_PASS_SECRET:
    external: true
  MY_SSL_CERT_SECRET:
    external: true
  MY_SSL_KEY_SECRET:
    external: true
  MY_SSL_BUNDLE_SECRET:
    external: true

networks:
  swarm-network:
    external: true
    name: swarm-network

执行部署命令：

bash
docker stack deploy --compose-file=Ldap-swarm.yml ldap-stack

6. 常用运维命令

bash
# 查看 stack 状态
docker stack ls
docker stack ps ldap-stack
docker stack services ldap-stack

# 查看日志
docker logs -f $(docker ps -q -f name=ldap-stack)

# 进入容器
docker exec -it $(docker ps -q -f name=ldap-stack) /bin/bash

# 移除 stack
docker stack rm ldap-stack

---

方案二：传统 Docker Run 部署 (使用 phpLDAPadmin)

1. 准备环境变量文件

创建 env-file 文件：

env
LDAP_ADMIN_PASS=ubuntu
LDAP_DOMAIN=akhil.system.local.in
LDAP_ORGANISATION=infra
HTPASSWORD=admin
ALIAS=myldap
SSL_CONFIG=N

2. 运行容器

bash
MOUNT_LOCATION=/path/to/your/ldap-data
docker run -d \
  --env-file env-file \
  -v $MOUNT_LOCATION/apache2:/etc/apache2 \
  -v $MOUNT_LOCATION/phpldapadmin:/etc/phpldapadmin \
  -v $MOUNT_LOCATION/ldap:/var/lib/ldap \
  -v $MOUNT_LOCATION/slapd.d:/etc/ldap/slapd.d \
  -p 8080:80 \
  -p 389:389 \
  --name ldap-server \
  --hostname ldap.local \
  docker.xuanyuan.run/akhilrajmailbox/ldap-server:latest

---

访问与登录

LAM 版本 (Web UI)

• 访问地址：https://<your-ip-or-domain>:443/
• 登录凭据：
  • 用户名：cn=admin,dc=devops,dc=example,dc=com (请根据实际配置的 LDAP_DOMAIN 调整 DC 部分)
  • 密码：创建 Secret 时设置的 LDAP_ADMIN_PASS

phpLDAPadmin 版本 (Web UI)

• 访问地址：http://<your-ip>:<port>/<ALIAS> (例如 http://192.168.1.100:8080/myldap)
• Web 界面安全登录：
  • 用户名：admin
  • 密码：环境变量中设置的 HTPASSWORD
• LDAP 目录登录：
  • 登录 DN：cn=admin,dc=akhil,dc=system,dc=local,dc=in (请根据实际配置的 LDAP_DOMAIN 调整 DC 部分)
  • 密码：环境变量中设置的 LDAP_ADMIN_PASS