3.1 KiB
3.1 KiB
测试方案：Docker 双环境部署与 FRPC 公网映射
测试方案文档路径：工程分析/测试方案-2026-05-21-10-38-49.md
静态检查
- 检查 Dockerfile 路径、工作目录、复制路径和启动命令。
- 使用
docker compose -f Docker部署/本机/docker_compose.yaml config校验本机 Compose。 - 使用
docker compose -f Docker部署/威联通NAS/docker_compose.yaml config校验 NAS Compose。 - 确认 frpc 配置包含：
serverAddr = "82.157.255.195"serverPort = 7000auth.token = "en.xjtu.edu.cn"localIP = "revoxelseg_web"localPort = 4000remotePort = 10008
构建检查
- 在
WebSite/下执行npm run lint。 - 在
WebSite/下执行npm run build。 - 使用本机 Compose 执行 Docker 镜像构建。
关键业务场景验证
- 容器启动后访问
/api/health返回ok: true。 - 首页
/返回200 OK。 - 默认项目数据可由容器读取。
- 本机端口
4000可访问。
医学影像数据相关边界验证
- 确认默认 DICOM 与 STL 目录被复制进镜像，运行态数据目录挂载不覆盖默认演示资产。
- 确认
WebSite/data和WebSite/exports被挂载为持久化目录，避免容器重建后用户项目和导出结果完全丢失。
部署验证
- 停止旧 tmux 服务后，使用本机 Docker Compose 启动服务。
- 验证
http://127.0.0.1:4000/api/health。 - 验证
http://127.0.0.1:4000/。 - 查看
revoxelseg_frpc日志，确认 frpc 已执行并尝试连接服务端。
Git/Gitea 备份验证
- 仅暂存本次 Docker 部署文件与工程分析文档。
- Commit message 包含
2026-05-21-10-38-49与简要描述。 - 推送到
http://192.168.31.5:5002/admin/REVOXELSEG_DICOM.git。
风险与回归关注点
- Docker 镜像构建时间和体积受默认医学数据大小影响。
- frpc 公网访问依赖远端 FRP 服务和 NPM 反向代理，若服务端不可用，本机健康检查仍应通过。
- 容器运行后不要再同时启动 tmux 版 4000 服务，以免端口冲突。
实际执行结果
- 已先停止旧
tmux运行服务，4000 端口空闲后再启动 Docker Compose。 npm run lint：通过。npm run build：通过，仅保留 Vite chunk size 提示。docker compose -f Docker部署/本机/docker_compose.yaml config：通过，frpc 远端端口为10008。docker compose -f Docker部署/威联通NAS/docker_compose.yaml config：通过，NAS 版路径展开为/share/Container/revoxelseg_dicom。docker compose -f Docker部署/本机/docker_compose.yaml up -d --build：通过。revoxelseg_web：状态 healthy，端口映射为0.0.0.0:4000->4000/tcp。revoxelseg_frpc：日志显示login to server success与[ReVoxelSeg_DICOM] start proxy success。curl http://127.0.0.1:4000/api/health：返回{"ok":true,"service":"revoxelseg-dicom"}。curl http://127.0.0.1:4000/：返回200 OK。curl http://192.168.3.11:4000/：返回200 OK。curl https://revoxel.huijutec.cn/：返回200 OK，响应头包含x-served-by: revoxel.huijutec.cn。