Skip to content

Docker 部署 ​

适合本机或一台已装 Docker 的服务器,一次拉起 nginx、webman、MySQL、Redis。

准备代码与依赖 ​

bash
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 会直接拒绝启动。可用下面命令各生成一串随机值:

bash
docker run --rm php:8.4-cli-bookworm php -r 'echo bin2hex(random_bytes(16)), PHP_EOL;'

启动 ​

bash
docker compose build webman
docker compose run --rm --no-deps --entrypoint composer webman install --no-dev --optimize-autoloader
docker compose up -d

Composer 在 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 密码 / DBREDIS_PASSWORD / 0

向导使用容器网络地址与端口,与宿主机映射的 MYSQL_PORT / REDIS_PORT 无关。docker/.env 用于 Compose,安装器写入的应用配置在 server/.env,安装锁为 server/config/install.lock。

装完执行(不要在宿主机运行 php start.php restart):

bash
docker compose restart webman

管理后台:http://localhost/admin/。用户名默认 admin,密码在安装时设置。

说明 ​

  • nginx 把 / 反代到 webman 8000,把 /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 后重启应用:

bash
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,菜单仅首次导入一次:

bash
# 使用 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 build

build 直接更新挂载的 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。

基于 MIT 许可发布