中间件 - Wizard Doc

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

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

[TOCM]

## 一、简介

```
wizard是知识库的一种实现方式
```

## 二、安装部署

#### 1. 目录结构

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

#### 2. 目录准备

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

#### 3. docker-compose.yml

```yaml
services:  # Compose 服务定义（顶层）
  wizard:  # Wizard 文档管理系统服务（基于 Laravel，用于 API/文档管理）
    container_name: wizard  # 指定容器名称（固定命名，便于 docker 命令直接操作）
    image: repo.358369.xyz/mylxsw/wizard:1.3.2  # 私有仓库镜像：mylxsw/wizard 版本 1.3.2（PHP/Laravel 编写）
    environment:  # 环境变量（容器启动时注入）
      # 数据库配置（MySQL，独立部署于 192.168.51.11）
      DB_HOST: localhost  # MySQL 主机地址（wizard 的业务数据存于此库）
      DB_PORT: 3306  # MySQL 端口
      DB_DATABASE: wizard  # 数据库名
      DB_USERNAME: wizard  # 数据库账号
      DB_PASSWORD: wizard  # 数据库密码（配套账号用于连接 MySQL）
      # 功能开关
      WIZARD_VERSION_CHECK: false  # 关闭版本检查（避免启动时请求外网检查更新）
      WIZARD_REGISTER_ENABLED: false  # 关闭自助注册（禁止公开注册，仅 LDAP 用户可登录）
      # LDAP 集成配置（对接 lldap，位于 192.168.51.23:3890）
      WIZARD_USE_LDAP: true  # 启用 LDAP 作为统一认证源
      LDAP_HOSTS: localhost  # LDAP 服务器地址（即你们部署的 lldap 主机）
      LDAP_PORT: 3890  # LDAP 服务端口（对应 lldap 映射的 3890）
      LDAP_BASE_DN: ou=people,dc=358369,dc=xyz  # 用户目录基础 DN：用户都建在 people 组织单元下
      LDAP_ACCOUNT_PREFIX: uid=  # 登录账号前缀：输入用户名时自动加此前缀，如 admin → uid=admin
      LDAP_ACCOUNT_SUFFIX: ',ou=people,dc=358369,dc=xyz'  # 登录账号后缀：与前缀拼成完整用户 DN 用于查找
      LDAP_USERNAME: uid=wizard,ou=people,dc=358369,dc=xyz  # 绑定账号 DN：wizard 以此服务账号连接 LDAP 执行查询
      LDAP_PASSWORD: gpIcbIl0hsRfw17ngUKmwaTqguU1BD  # 上述绑定账号的密码
      LDAP_SCHEMA: "Adldap\Schemas\OpenLDAP"  # Adldap 库使用的目录模式：OpenLDAP（对应 lldap）
      LDAP_SCOPES_CLASS: "Adldap\Laravel\Scopes\UidScope"  # 用户查询作用域：按 uid 属性限定搜索范围
      LDAP_LOGGING: true  # 记录 LDAP 认证/查询日志，便于登录问题排障
      LDAP_LOCATE_USERS_BY: uid  # 用哪个 LDAP 属性定位用户（此处为 uid）
      LDAP_BIND_USER_BY: uid  # 登录时用哪个属性做绑定认证（用户输入的账号匹配 uid）
      LDAP_SYNC_EMAIL_ATTR: mail  # 将 LDAP 的 mail 属性同步为 wizard 用户邮箱
      # LDAP 连接安全配置
      LDAP_USE_SSL: false  # 不启用 LDAPS（SSL 加密）
      LDAP_USE_TLS: false  # 不启用 TLS 加密（明文连接，故 3890 不宜暴露公网）
      # 密码同步 / 登录兜底
      LDAP_PASSWORD_SYNC: true  # 将 LDAP 密码同步到本地库，形成密码副本
      LDAP_LOGIN_FALLBACK: false  # LDAP 认证失败时不允许回退使用本地账号密码
      # 用户信息映射
      LDAP_SYNC_NAME_ATTR: cn  # 取 LDAP 的 cn 属性作为用户显示名称
      # 登录范围限制
      WIZARD_LDAP_ONLY_MEMBER_OF: ''  # 仅允许指定组成员登录，留空=所有 LDAP 用户均可登录
    volumes:  # 数据卷（目录挂载）
      - ./data:/webroot/storage/app/public  # 宿主机 data 目录挂载为上传文件存储（持久化）
    ports:  # 端口映射
      - 11280:80  # 宿主机 11280 → 容器 80（Web 访问入口）
    restart: always  # 容器异常退出/主机重启后自动拉起
```

#### 4. docker compose up -d

```shell
docker compose up -d

# 初始化wizard表
docker exec wizard php artisan migrate --force

# LLDAP中要将 wizard 用户加入到 lldap_strict_readonly 组中
```

> **备注**
> 1. 镜像地址：原配置通过短链 `https://link.wtturl.cn/?target=...` 引用，解码后实际地址为 `repo.hivery.cn/mylxsw/wizard:1.3.2`，此处已直接使用实际地址，保证 `docker compose` 可直接拉取。
> 3. 访问地址：`http://<服务器IP>:11280`
> 4. 已开启 LDAP 登录（`WIZARD_USE_LDAP: true`），并关闭自助注册（`WIZARD_REGISTER_ENABLED: false`）。