eryajf/go-ldap-admin-server

go-ldap-admin-server 镜像文档

镜像概述

go-ldap-admin-server镜像是一个集成了LDAP管理所需全套组件的Docker解决方案，旨在提供便捷的本地部署和LDAP管理平台体验。通过docker-compose可快速拉起包含MySQL数据库、openLDAP服务、phpldapadmin管理界面、go-ldap-admin后端服务及前端UI的完整环境，适合开发者进行功能测试、学习LDAP管理操作。

注意：docker-compose部署方式目前不建议直接用于生产环境。如需生产环境部署，请自行调整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系统测试通过
• 快速部署：通过docker-compose一键启动，自动完成服务配置与初始化
• 预置数据：openLDAP已初始化用户根目录及第三方应用根部门（钉钉、企业微信、飞书）
• 国内加速：默认使用上海交通大学镜像代理，提升国内拉取速度

端口映射说明

部署前请确保宿主机端口未被占用

部署步骤

1. 克隆项目代码

bash
git clone https://github.com/eryajf/go-ldap-admin.git
cd docs/docker-compose

2. 启动服务

bash
docker-compose up -d

3. 访问服务

• 平台前端：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/
├── 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_ROOT_HOST: "%"               # 允许远程访问
    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"      # 管理员密码
  volumes:
    - ./data/openldap/database:/var/lib/ldap    # 数据存储
    - ./data/openldap/config:/etc/ldap/slapd.d   # 配置存储
    - ./config/init.ldif:/container/service/slapd/assets/config/bootstrap/ldif/custom/init.ldif # 初始化数据

应用服务

• go-ldap-admin-server：后端API服务，依赖MySQL和openLDAP
• go-ldap-admin-ui：前端界面，依赖后端服务

初始化LDAP数据说明

init.ldif文件预置以下目录结构：

dn: ou=people,dc=eryajf,dc=net              # 用户根目录
dn: ou=dingtalkroot,dc=eryajf,dc=net        # 钉钉根部门
dn: ou=wecomroot,dc=eryajf,dc=net           # 企业微信根部门
dn: ou=feishuroot,dc=eryajf,dc=net          # 飞书根部门

镜像更新

服务镜像（eryajf/go-ldap-admin-server和eryajf/go-ldap-admin-ui）使用latest标签，主分支更新后自动构建。更新方法：

bash
docker-compose down
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 up -d