中间件 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-09-19 18:01:17
创建人	孙荣利
创建时间	2026-09-19 18:01:17

该文档由孙荣利创建于 2026-09-19 18:01:17 ，孙荣利在 2026-09-19 18:01:17 修改了该文档。

[TOCM]

## 一、简介

```text
LLDAP 是一个轻量级的 LDAP 服务器实现，它由 Rust 语言编写，目标是为个人或小型团队提供一个简单、易于部署的用户认证与目录服务方案
# 简单说
LLDAP可以提供一套用户密码账号体系，别的系统不用注册，只要别的系统打通LLDAP就可以在别的系统上用LLDAP的用户登录
```

## 二、安装部署

#### 1. 目录结构

```shell
lldap
├── data
└── docker-compose.yml
```

#### 2. 目录准备

```shell
mkdir -p /data/lldap
mkdir -p /data/lldap/data
cd /data/lldap
touch docker-compose.yml
```

#### 3. docker-compose.yml

```yaml
version: "3"  # Compose 文件版本声明（新版已标记过时，仅告警不影响运行，可留可删）
services:
  lldap:  # 定义 lldap 服务（轻量级 LDAP 统一认证服务器）
    image: repo.358369.xyz/lldap/lldap:2025-08-06-debian  # 私有仓库镜像（标签 = 构建日期 + Debian 发行版）
    ports:
      # LDAP 协议端口（ldap://），不建议暴露公网（默认明文传输），仅供内网服务认证使用
      - "3890:3890"
      # LDAPS 加密端口（LDAP Over SSL），需设置 LLDAP_LDAPS_OPTIONS__ENABLED=true 并配置证书才启用，当前注释关闭
      #- "6360:6360"
      # Web 管理前端端口，浏览器访问 http://<服务器IP>:17170
      - "17170:17170"
    volumes:
      # 宿主机 lldap_data 挂载到容器 /data，持久化用户库、配置等数据（删除容器数据不丢）
      - "./data:/data"
    environment:
      - UID=10001  # 容器内进程运行用户 ID，避免文件以 root 属主导致宿主机管理不便
      - GID=20001  # 容器内进程运行组 ID
      - TZ=Asia/Shanghai  # 时区设为上海，保证日志与界面时间一致
      - LLDAP_JWT_SECRET=ubWYz8xHkklODI  # JWT 签名密钥，用于 Web 会话 Token 签发（改动会使所有会话失效）
      - LLDAP_KEY_SEED=cdKv4lAWjZoi0U  # 主密钥种子，加密存储用户密码等敏感数据（丢失/修改将导致密码无法解密）
      - LLDAP_LDAP_BASE_DN=dc=358369,dc=xyz  # LDAP 基础 DN，对应域 hivery.cn，即 wizard 等客户端认证的目录根
      - LLDAP_LDAP_USER_PASS=gpIcbIl0hsRfw17ngUKmwaTqguU1BD  # 内置管理员 admin 的初始密码，首次登录后建议修改
    restart: always  # 容器异常退出或主机重启后自动拉起
```

#### 4. docker compose up -d

```shell
docker compose up -d
```

> **备注**
> 1. 访问地址：管理后台 `http://<服务器IP>:17170`，默认账号 `admin`，密码为 `LLDAP_LDAP_USER_PASS` 对应值。
> 2. LDAP 端口 3890 供内网其他服务（如 wizard）做统一认证，不建议映射到公网。
> 3. `LLDAP_JWT_SECRET` 与 `LLDAP_KEY_SEED` 为敏感密钥，若 compose 文件纳入 Git 管理，建议改为 `.env` 注入，避免明文泄露。
> 4. 首次启动时 `lldap_data` 目录由容器自动创建，也可手动预建。