eryajf/go-ldap-admin-ui

go-ldap-admin-ui 镜像文档

镜像概述

eryajf/go-ldap-admin-ui 是一个用于快速部署 LDAP 管理系统的 Docker 镜像，旨在提供便捷的本地体验和测试环境。通过 docker-compose 可一键拉起包含 MySQL 数据库、openLDAP 服务、phpldapadmin 管理工具、go-ldap-admin 服务端及 UI 前端的完整系统，帮助用户快速上手 LDAP 管理功能。

注意：docker-compose 部署方式目前不建议直接用于生产环境，如需生产部署，请自行调整配置文件。

核心功能与特性

• 完整组件集成：包含 MySQL-5.7、openLDAP-1.4.0、phpldapadmin-0.9.0、go-ldap-admin-server、go-ldap-admin-ui 五大组件
• 架构兼容性：支持 AMD 与 ARM 架构，已在 M1 版 Mac 及 Intel 版 CentOS7 系统测试通过
• 国内镜像加速：默认使用上海交通大学镜像代理，解决国内拉取镜像缓慢问题
• 初始化配置：预置 LDAP 基础结构（用户根目录、钉钉/企业微信/飞书根部门等）及 MySQL 数据库
• 便捷部署：通过 docker-compose 一键启动，无需复杂手动配置

端口映射说明

启动前请确保宿主机端口未被占用，避免冲突。

使用方法

快速部署步骤

1. 克隆项目仓库：

   bash
   git clone https://github.com/eryajf/go-ldap-admin.git
   

2. 进入 docker-compose 目录：

   bash
   cd docs/docker-compose
   

3. 启动服务：

   bash
   docker-compose up -d
   

访问方式

• go-ldap-admin UI：访问 http://localhost:8090，默认用户名/密码：admin/123456
• phpldapadmin：访问 http://localhost:8091，默认用户名/密码：cn=admin,dc=eryajf,dc=net/123456

非本地部署时，将 localhost 替换为部署主机 IP，如 http://192.168.10.10:8090。

服务验证

检查容器状态

通过以下命令确认所有容器正常运行：

bash
docker-compose ps

正常输出示例：

           Name                         Command                  State                              Ports
--------------------------------------------------------------------------------------------------------------------------------
go-ldap-admin-mysql          /entrypoint.sh --default-a ...   Up (healthy)   0.0.0.0:3307->3306/tcp,:::3307->3306/tcp, 33060/tcp
go-ldap-admin-openldap       /container/tool/run --copy ...   Up             0.0.0.0:388->389/tcp,:::388->389/tcp, 636/tcp
go-ldap-admin-phpldapadmin   /container/tool/run              Up             443/tcp, 0.0.0.0:8091->80/tcp,:::8091->80/tcp
go-ldap-admin-server         /bin/sh -c ./wait && ./go- ...   Up             0.0.0.0:8888->8888/tcp,:::8888->8888/tcp
go-ldap-admin-ui             /bin/sh -c nginx -g "daemo ...   Up             0.0.0.0:8090->80/tcp,:::8090->80/tcp

验证后端服务健康

通过以下命令检查后端服务是否正常响应：

bash
curl -s localhost:8888/api/base/ping | jq

正常响应示例：

json
{
  "code": 200,
  "data": "pong",
  "msg": "ok"
}

配置说明

目录结构

进入 docker-compose 目录后，结构如下：

docker-compose/
├── config/
│   ├── init.ldif       # LDAP 初始化配置文件
│   └── my.cnf          # MySQL 配置文件
└── docker-compose.yaml # 主编排文件

docker-compose.yaml 核心配置说明

MySQL 服务

yaml
mysql:
  image: docker.mirrors.sjtug.sjtu.edu.cn/mysql/mysql-server:5.7
  environment:
    TZ: Asia/Shanghai
    MYSQL_ROOT_PASSWORD: 123456  # root 密码
    MYSQL_DATABASE: go_ldap_admin  # 自动创建数据库
  volumes:
    - ./data/mysql:/var/lib/mysql/data  # 数据持久化
    - ./config/my.cnf:/etc/mysql/my.cnf  # 配置文件映射

openLDAP 服务

yaml
openldap:
  image: docker.mirrors.sjtug.sjtu.edu.cn/osixia/openldap:1.4.0
  environment:
    LDAP_ORGANISATION: "eryajf.net"
    LDAP_DOMAIN: "eryajf.net"
    LDAP_ADMIN_PASSWORD: "123456"  # LDAP 管理员密码
  volumes:
    - ./data/openldap/database:/var/lib/ldap  # 数据持久化
    - ./config/init.ldif:/container/service/slapd/assets/config/bootstrap/ldif/custom/init.ldif  # 初始化数据

go-ldap-admin-server 服务

yaml
go-ldap-admin-server:
  image: docker.mirrors.sjtug.sjtu.edu.cn/eryajf/go-ldap-admin-server
  environment:
    WAIT_HOSTS: mysql:3306, openldap:389  # 等待依赖服务就绪
  # 可按需挂载配置文件：
  # volumes:
  #   - ./config/config.yml:/app/config.yml

初始化 LDAP 数据说明

init.ldif 预置以下基础结构：

dn: ou=people,dc=eryajf,dc=net
ou: people
description: 用户根目录
objectClass: organizationalUnit

dn: ou=dingtalkroot,dc=eryajf,dc=net
ou: dingtalkroot
description: 钉钉根部门
objectClass: top
objectClass: organizationalUnit

dn: ou=wecomroot,dc=eryajf,dc=net
ou: wecomroot
description: 企业微信根部门
objectClass: top
objectClass: organizationalUnit

dn: ou=feishuroot,dc=eryajf,dc=net
ou: feishu
description: 飞书根部门
objectClass: top
objectClass: organizationalUnit

镜像升级说明

服务镜像（eryajf/go-ldap-admin-server 和 eryajf/go-ldap-admin-ui）使用 latest 标签，主分支更新后会自动构建。如需升级，删除本地镜像后重新拉取：

bash
docker rmi docker.mirrors.sjtug.sjtu.edu.cn/eryajf/go-ldap-admin-server
docker rmi docker.mirrors.sjtug.sjtu.edu.cn/eryajf/go-ldap-admin-ui
docker-compose pull
docker-compose up -d