59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
# 实现方案-2026-05-25-10-21-17
|
|
|
|
## 实现方案文档路径
|
|
|
|
`工程分析/实现方案-2026-05-25-10-21-17.md`
|
|
|
|
## 修改目标
|
|
|
|
完成一次无源码变更的重新部署，恢复并验证 `https://revoxel.huijutec.cn/` 服务。
|
|
|
|
## 涉及路径
|
|
|
|
- `WebSite/`
|
|
- `WebSite/server.ts`
|
|
- `WebSite/vite.config.ts`
|
|
- `工程分析/需求分析-2026-05-25-10-21-17.md`
|
|
- `工程分析/实现方案-2026-05-25-10-21-17.md`
|
|
- `工程分析/测试方案-2026-05-25-10-21-17.md`
|
|
- `工程分析/经验记录.md`
|
|
|
|
## 技术路线
|
|
|
|
1. 检查工作区状态、`WebSite` 脚本和当前 `tmux`/端口占用情况。
|
|
2. 在 `WebSite` 执行 `npm run build`，确认生产构建通过。
|
|
3. 若公网首页被 Vite host 检查拦截，将 `revoxel.huijutec.cn` 加入 Vite `allowedHosts`。
|
|
4. 使用 `tmux` 会话 `revoxelseg-dicom` 启动或重启：
|
|
`npm run serve -- --host 0.0.0.0 --port 4000`
|
|
5. 通过本机和公网地址验证服务。
|
|
6. 追加经验记录，提交本次工程分析文档和明确属于本次部署修复的配置变更。
|
|
|
|
## 执行步骤
|
|
|
|
- 执行前再次确认已读 `工程分析/经验记录.md`。
|
|
- 若存在旧 `tmux` 服务，向会话发送 `Ctrl-C` 后重新启动。
|
|
- 若不存在旧会话，创建 `tmux new-session -d -s revoxelseg-dicom`。
|
|
- 使用 `curl` 验证：
|
|
- `http://127.0.0.1:4000/api/health`
|
|
- `http://127.0.0.1:4000/`
|
|
- `https://revoxel.huijutec.cn/`
|
|
|
|
## 兼容性与回滚方案
|
|
|
|
- 若新服务启动失败，可保留构建日志并重新启动旧服务命令。
|
|
- 若公网不可达但本机正常，需要继续排查 FRP、NPM 反向代理和域名链路。
|
|
- 本次不改源码，回滚主要是停止新启动的 `tmux` 服务或恢复旧进程。
|
|
|
|
## 预计文件变更
|
|
|
|
- 新增本次三件套文档。
|
|
- 追加 `工程分析/经验记录.md`。
|
|
- `WebSite/server.ts` 和 `WebSite/vite.config.ts` 可能追加公网域名 allowedHosts。
|
|
- `WebSite/dist/` 可能因构建更新，但不作为本次文档备份 commit 的目标。
|
|
|
|
## 提交与部署策略
|
|
|
|
- 先完成构建、部署与验证。
|
|
- 暂存本次工程分析文档、经验记录和 allowedHosts 配置修复。
|
|
- commit message 使用：`2026-05-25-10-21-17 部署并验证 ReVoxelSeg DICOM 服务`。
|