2026-06-04-09-46-36 部署并验证局域网 4000 服务

工程分析/经验记录.md

@@ -1995,3 +1995,21 @@ C. 解决问题方案
 D. 后续如何避免问题
 
 面向 Windows 用户直接查看的复杂导出包优先使用 ZIP，不要用需要 PAX 扩展的 tar.gz；如果必须使用 tar.gz，必须避免非 ASCII 和长路径，或确认目标解压器正确隐藏 PAX。导出包内部结构应以机器可读和人工可读为准，分类分割文件名保持类别名，映射关系单独放入 `labels.json`。
+
+## 2026-06-04-09-46-36 局域网部署要同时确认网卡地址和监听地址
+
+A. 具体问题
+
+用户要求通过 `http://192.168.3.11:4000/` 访问程序。本次部署前没有现存 `revoxelseg-dicom` tmux 会话，`4000` 端口也未被占用，需要重新创建长期运行会话并确保服务对局域网开放。
+
+B. 产生问题原因
+
+局域网访问不仅依赖服务启动成功，还依赖本机实际存在目标网卡地址、Node 服务监听 `0.0.0.0` 而不是只监听 `127.0.0.1`。如果只验证本机 localhost，可能遗漏局域网地址不可达的问题。
+
+C. 解决问题方案
+
+先确认本机网卡包含 `192.168.3.11`，再执行 `npm run build`。构建通过后创建 `tmux` 会话 `revoxelseg-dicom`，在 `WebSite` 中启动 `npm run serve -- --host 0.0.0.0 --port 4000`。随后同时验证 `127.0.0.1` 和 `192.168.3.11` 的 `/api/health` 与首页，确认均返回正常响应。
+
+D. 后续如何避免问题
+
+后续做局域网部署时，部署验证必须同时覆盖三点：目标 IP 是否属于当前机器、端口是否监听在 `0.0.0.0`、目标 IP 的 API 和首页是否都能访问。若没有既有 tmux 会话，可直接创建同名会话；若端口被占用，则先记录占用来源再处理。