快速开始
前置
| 依赖 | 版本 |
|---|---|
| JDK | 21 |
| Node.js / pnpm | 22 / 10+ |
| Docker + Compose | 支持 Compose v2 |
| 数据库 | 无需单独安装,随编排启动 |
Windows 建议在 WSL2 中运行 Docker 命令;仓库脚本同时提供 PowerShell 与 Bash 版本。
1. 构建产物
bash
# 后端(Windows PowerShell 把 ./mvnw 换成 .\mvnw.cmd)
cd code/back-end
./mvnw clean package -DskipTests
# 前端
cd ../front-end
pnpm install
pnpm build:prod2. 启动一套环境
两套编排组件一致、仅数据库方言不同,端口已错开,可同时运行:
| PostgreSQL 栈 | MySQL 8.0 栈 | |
|---|---|---|
| 前端 | 80 | 81 |
| 后端 | 8080 | 8081 |
| 数据库 | 5432 | 3306 |
| Redis | 6379 | 6380 |
| Milvus | 19530 | 19531 |
| MinIO | 9000 / 控制台 9001 | 9002 / 控制台 9003 |
bash
cd deploy/deploy-pg
docker compose up -d --build启动后访问 http://localhost,初始账号 admin / admin123。
3. 补齐模型密钥
登录后进入「模型配置」,为对话模型与向量模型填入自己的 API Key。未配置时健康自检会提示,AI 对话不可用。
4. 启用沙箱(可选)
沙箱执行默认关闭,默认编排也不挂宿主 socket:
bash
# 1. 构建沙箱基础镜像(默认 bizbuddy/sandbox:1.1.3)
deploy/sandbox-image/build.ps1
# 2. 用沙箱目标重建后端,并叠加覆盖层
cd deploy/deploy-pg
ADMIN_BUILD_TARGET=sandbox docker compose \
-f docker-compose.yml -f docker-compose.sandbox.yml up -d --build随后到「模型与推理 → 沙箱执行」页开启、选择镜像与灰度智能体并保存。保存前会用 docker image inspect 校验镜像契约,镜像不可用会被拒绝。
覆盖层会启动受限 socket 代理,应用容器内不再出现
/var/run/docker.sock。离线环境需提前准备node:22-alpine。
5. 升级
从 1.0.0 升级
- 备份数据库;
- 替换后端 / 前端产物或镜像,正常
up -d启动,不要执行down -v; - Flyway 自动登记 V1 基线并执行
V2__1_1_0_upgrade.sql; - 重启
web容器(nginx 缓存了后端容器 IP),确认健康自检 0 FAIL。
回滚
V2 已应用后,不能直接用 1.0.0 的产物回滚——旧版本找不到该迁移会拒绝启动。回滚请恢复升级前的数据库备份。
全新初始化
bash
docker compose down -v # 会删除全部数据,请先备份
docker compose up -d --build常见问题
启动后访问 502
重建后端容器会更换 IP,nginx 启动时缓存了旧 IP。重启 web:
bash
docker compose restart web保存沙箱策略被拒绝
检查是否用 ADMIN_BUILD_TARGET=sandbox 构建、是否叠加覆盖层、沙箱镜像是否已构建且契约正确。
跟踪过 develop 的开发库无法启动
若历史表里是旧的 V2~V7,先删除 V2~V7 行并保留 V1,再启动由幂等脚本重跑合并 V2。详见版本发布页。
更多排障与配置见仓库 docs/。