2026-05-24-09-58-56 恢复Docker部署并清理发布分支

工程分析/经验记录.md

@@ -1621,3 +1621,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 后续撰写项目介绍、软著说明、验收材料或宣传文案时，应先核对工程整体分析和最新源码功能，再区分“已实现能力”“演示能力”和“后续预留能力”。涉及医学影像、分割、诊断和算法效果的表述必须保守准确，不能为了文字完整性虚构尚未落地的临床级能力。
+
+## 2026-05-24-09-58-56 Docker 发布分支清理与公网生产模式部署
+
+A. 具体问题
+
+用户误删了主工程 `Docker部署/` 目录，同时 Gitea 中遗留四个 Docker 发布辅助分支。恢复本机 `tmux` 服务后，本机页面和公网 API 正常，但公网根路径一度返回 `403 Blocked request. This host ("revoxel.huijutec.cn") is not allowed.`。
+
+B. 产生问题原因
+
+`Docker部署/` 是已跟踪目录，被工作区删除后可从 Git 历史恢复。四个远端分支只是用于固化 v2026.05.21 Docker 发布包配置，Release 已由 tag 和附件承载，不再需要分支长期保留。公网 403 则是因为普通 `npm run serve` 未设置 `NODE_ENV=production`，服务进入 Vite 开发中间件，Vite 对公网 Host 执行 allowedHosts 拦截；同时公网访问还依赖 frpc 隧道，单独启动 Web 服务不足以恢复域名入口。
+
+C. 解决问题方案
+
+使用 `git restore -- Docker部署` 恢复主工程 Docker 部署文件。确认 Gitea Release `ReVoxelSeg DICOM Docker 部署包 v2026.05.21` 及 3 个附件、相关 tag 均存在后，删除 `docker-standalone-20260521`、`release/docker-machine-20260521`、`release/docker-nas-20260521`、`release/docker-generic-20260521` 四个远端分支。部署时先执行 `npm run lint` 与 `npm run build`，再用 `tmux` 运行 `NODE_ENV=production npm run serve -- --host 0.0.0.0 --port 4000`，并单独启动 host 网络的 `revoxelseg-dicom-frpc` 容器将本机 `127.0.0.1:4000` 映射到 FRP 远端 `10008`。最终验证本机健康接口、首页、公网首页、公网 API、项目数据和登录接口均可用。
+
+D. 后续如何避免问题
+
+清理发布辅助分支前必须先确认对应 Release、tag 和附件均可读，再删除分支而不是删除 tag 或 Release。通过公网域名部署 `npm run serve` 时应使用 `NODE_ENV=production`，否则 Vite 开发中间件可能拦截公网 Host。公网域名验证要同时检查 Web 服务、frpc 登录与代理成功日志、`/api/health`、首页 HTML 和关键业务 API，避免只看本机 4000 端口。