2026-05-21-11-13-49 记录独立Docker程序包分支

工程分析/经验记录.md

@@ -1513,3 +1513,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 后续部署变更应先停止旧 4000 服务，再启动新部署方式，避免端口冲突。Docker 构建要明确区分默认演示资产、业务源码和运行态挂载目录；NAS 版 Compose 应使用绝对路径，方便 Container Station 直接导入。frpc 配置变更后必须查看 frpc 日志，确认 `login to server success` 和 `start proxy success`，再用局域网地址和公网域名分别验证。
+
+## 2026-05-21-11-13-49 独立 Docker 程序包要脱离主工程验证
+
+A. 具体问题
+
+用户要求将完整 Docker 程序放到 `~/Desktop/ReVoxelSeg_DICOM_Docker`，后续即使没有原始 `ReVoxelSeg_DICOM` 文件夹也能直接运行；独立目录不应包含工程分析、软著材料和其他杂项，并要求 Docker Compose 文件放在程序根目录，同时在 Gitea 新开分支存储。
+
+B. 产生问题原因
+
+之前 Docker 部署文件位于主项目 `Docker部署/` 子目录，构建上下文依赖原始工程根目录。如果直接复制该子目录，缺少 `WebSite/`、默认 DICOM 和 STL 数据，无法脱离主工程运行；如果直接复制整个主工程，又会把工程分析、软著、参考模板、运行态数据和未跟踪测试文件一起带入独立部署包。
+
+C. 解决问题方案
+
+新建 `/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`，只同步 `WebSite/`、`Head_CT_DICOM/`、`Head_CT_ReConstruct/`，并排除 `node_modules`、`dist`、`data`、`exports` 和本地环境文件。将 `Dockerfile`、本机 `docker_compose.yaml`、NAS `docker_compose.nas.yaml` 和 README 放在独立目录根部。停止旧 Compose 后从独立目录执行构建和启动，验证局域网地址、公网域名、健康接口和 frpc 日志。最后在独立目录初始化 Git 仓库，推送到 Gitea 新分支 `docker-standalone-20260521`。
+
+D. 后续如何避免问题
+
+后续若维护 Docker 独立包，应优先在 `ReVoxelSeg_DICOM_Docker` 目录内修改和验证，不要依赖主工程相对路径。根目录 Compose 文件中，本机版保留为 `docker_compose.yaml`，NAS 版使用 `docker_compose.nas.yaml`，避免同名文件冲突。独立分支内容结构与 main 不同，推送前必须检查目录纯净度，确认不含工程分析、软著材料、node_modules、dist、data、exports 等无关内容。