Docker 部署
适合本机或一台已装 Docker 的服务器,一次拉起 nginx、webman、MySQL、Redis。
准备代码与依赖
git clone https://github.com/yuandianxitong/ydadmin.git
cd ydadmin/docker
cp .env.example .env编辑 docker/.env,填写 MYSQL_ROOT_PASSWORD、MYSQL_PASSWORD、REDIS_PASSWORD。这三个没有默认值,不填 docker compose 会直接拒绝启动。可用下面命令各生成一串随机值:
docker run --rm php:8.4-cli-bookworm php -r 'echo bin2hex(random_bytes(16)), PHP_EOL;'启动
docker compose build webman
docker compose run --rm --no-deps --entrypoint composer webman install --no-dev --optimize-autoloader
docker compose up -dComposer 在 Webman 镜像内运行,宿主机无需安装 PHP 8.4 或 Composer;--no-deps 避免安装依赖时提前启动数据库等服务。上述命令均在 docker/ 中执行。
浏览器打开 http://localhost/install/,按向导完成安装,连接信息如下:
| 安装项 | 填写值 |
|---|---|
| 数据库主机 / 端口 | mysql / 3306 |
| 数据库名 | docker/.env 的 MYSQL_DATABASE,默认 ydadmin,向导会预填此值 |
| 数据库用户 / 密码 | MYSQL_USER(默认 ydadmin)/ MYSQL_PASSWORD |
| Redis 主机 / 端口 | redis / 6379 |
| Redis 密码 / DB | REDIS_PASSWORD / 0 |
向导使用容器网络地址与端口,与宿主机映射的 MYSQL_PORT / REDIS_PORT 无关。docker/.env 用于 Compose,安装器写入的应用配置在 server/.env,安装锁为 server/config/install.lock。
装完执行(不要在宿主机运行 php start.php restart):
docker compose restart webman管理后台:http://localhost/admin/。用户名默认 admin,密码在安装时设置。
说明
- nginx 把
/反代到 webman8000,把/ws反代到8001,并设置client_max_body_size 50m。 - MySQL 与 Redis 默认只绑定宿主机回环地址;需要外连时再改
docker/.env里的绑定项,并自行评估暴露面。 - Nginx 的固定容器 IP 默认为
172.30.84.2,启动脚本将其写入应用的TRUSTED_PROXIES,登录日志与操作日志由此记录实际客户端 IP。若子网冲突,成对修改DOCKER_SUBNET与NGINX_INTERNAL_IP,然后docker compose up -d --force-recreate重建容器。不要把整个私网或所有来源设为可信代理。 - 镜像包含验证码所需 GD(PNG / JPEG / WebP / FreeType)以及上传检测所需 fileinfo。
- 安装器默认设置
APP_DEBUG=false,生成器的预览、生成和更新在APP_DEBUG=false时关闭。仅在独立开发环境将server/.env改为APP_DEBUG=true并执行docker compose restart webman,详见代码生成器。
开发环境生成业务模块
本节仅用于独立开发环境。在项目根操作;docker/.env 是 Compose 配置,生成器开关位于 server/.env。设置 APP_DEBUG=true 后重启应用:
docker compose -f docker/docker-compose.yml restart webman
docker compose -f docker/docker-compose.yml exec -T webman php webman make:crud biz_tickets --module=biz --model=BizTicket --comment="业务工单" --preview
docker compose -f docker/docker-compose.yml exec -T webman php webman make:crud biz_tickets --module=biz --model=BizTicket --comment="业务工单"表需预先存在,示例 DDL 见 第一个业务模块。Compose 将 server/ 挂到 /var/www/html、admin/ 挂到 /var/www/admin,生成文件会写回宿主机;未挂载 Admin 源码时禁止生成。
生成成功只是写入源码,随后还需完成以下步骤。先审核菜单 SQL,需要时调整 parent_id,菜单仅首次导入一次:
# 使用 MySQL 容器内已有环境变量,不把密码写进命令或日志
# 此处变量必须保留在单引号内,交由容器 shell 展开
docker compose -f docker/docker-compose.yml exec -T mysql sh -c 'MYSQL_PWD="$MYSQL_PASSWORD" mysql --default-character-set=utf8mb4 -u"$MYSQL_USER" "$MYSQL_DATABASE"' < server/database/generated/biz-biz_ticket-menu.sql
# 新控制器/API 路由需在运行中的容器内 reload
docker compose -f docker/docker-compose.yml exec -T webman php start.php reload
# 以下在宿主机/CI 的 Node + pnpm 环境执行,不在 PHP 容器里执行
pnpm --dir admin buildbuild 直接更新挂载的 server/public/admin/。若宿主机没有依赖,先 pnpm --dir admin install --frozen-lockfile;若没有 Node/pnpm,使用已配置前端工具链的构建机,不能省略 build。--reload 选项只执行第二步,不代替 SQL 或前端构建。
菜单导入后超管重新登录;普通角色还需授权菜单和按钮。页面地址为 /admin/biz/biz-ticket(history,无 #)。开发完成后将 server/.env 恢复 APP_DEBUG=false 并执行 docker compose -f docker/docker-compose.yml restart webman。