REVOXELSEG_DICOM/工程分析/实现方案-2026-05-21-10-38-49.md

实现方案：Docker 双环境部署与 FRPC 公网映射

实现方案文档路径：工程分析/实现方案-2026-05-21-10-38-49.md

修改目标

新增完整容器化部署方案，使项目可通过 Docker Compose 在本机和威联通 NAS Container Station 中运行，并通过内置 frpc 服务映射到 82.157.255.195:10008，配合 revoxel.huijutec.cn 访问。

涉及路径

• .dockerignore
• Docker部署/Dockerfile
• Docker部署/README.md
• Docker部署/本机/docker_compose.yaml
• Docker部署/威联通NAS/docker_compose.yaml
• 工程分析/需求分析-2026-05-21-10-38-49.md
• 工程分析/实现方案-2026-05-21-10-38-49.md
• 工程分析/测试方案-2026-05-21-10-38-49.md
• 工程分析/经验记录.md

技术路线

1. 停止现有 tmux 会话中的 npm run serve 服务。
2. 新增 Dockerfile：
   • 使用 Node 官方镜像。
   • 复制 WebSite/package*.json 并执行 npm ci。
   • 复制 WebSite 源码、默认 DICOM 数据和默认 STL 数据。
   • 执行 npm run build。
   • 使用 NODE_ENV=production 通过 npm run serve -- --host 0.0.0.0 --port 4000 启动。
3. 新增本机 Compose：
   • revoxelseg_web 暴露 4000:4000。
   • 挂载本机部署目录下的 data/、exports/。
   • revoxelseg_frpc 使用 snowdreamtech/frpc:latest，启动时写入 /tmp/frpc.toml。
4. 新增 QNAP Compose：
   • build context 使用 /share/Container/revoxelseg_dicom 绝对路径。
   • 运行态目录挂载到 /share/Container/revoxelseg_dicom/data 与 exports。
   • frpc 直接内嵌同样的远端映射配置。
5. 新增 README 说明部署、访问、停止、日志查看和路径修改方式。

执行步骤

1. 创建 Docker部署/、Docker部署/本机/、Docker部署/威联通NAS/。
2. 写入 Dockerfile、两份 Compose 与 README。
3. 执行 npm run lint 与 npm run build。
4. 执行 docker compose -f Docker部署/本机/docker_compose.yaml config 校验语法。
5. 构建并启动本机 Docker 部署。
6. 验证 http://127.0.0.1:4000/api/health 与 http://127.0.0.1:4000/。
7. 检查 frpc 容器日志是否启动并尝试连接服务端。
8. 更新经验记录并提交本次相关文件。

兼容性与回滚方案

• 回滚到旧部署：执行 docker compose -f Docker部署/本机/docker_compose.yaml down 后，按旧方式进入 WebSite 执行 npm run serve -- --host 0.0.0.0 --port 4000。
• 如果 QNAP 路径不同，只需修改 NAS Compose 中的 build.context 和 volume 宿主机路径。
• 如果远端端口冲突，修改 frpc remotePort 和 NPM 反向代理目标端口即可。

预计文件变更

新增 Docker 部署文件，不修改业务源码。

提交与部署策略

提交包含 Docker 部署文件与工程分析文档；部署以本机 Docker Compose 作为验证环境。软著材料和无关工作区变化不纳入提交。