2026-05-21-11-13-49 独立Docker程序包

README.md

@@ -0,0 +1,109 @@
+# ReVoxelSeg DICOM Docker 独立运行包
+
+这是“基于模型逆向体素化及 DICOM 分割标注系统”的独立 Docker 程序目录。目录内已经包含运行所需源码、默认 DICOM 演示数据和默认 STL 模型数据，因此即使没有原始 `ReVoxelSeg_DICOM` 工程目录，也可以直接在本目录构建和运行。
+
+## 目录内容
+
+- `WebSite/`：前后端一体服务源码。
+- `Head_CT_DICOM/`：默认 DICOM 影像序列。
+- `Head_CT_ReConstruct/`：默认 STL 模型。
+- `Dockerfile`：Docker 镜像构建文件。
+- `docker_compose.yaml`：本机 Docker Compose 部署文件。
+- `docker_compose.nas.yaml`：威联通 NAS / QTS Container Station 部署文件。
+- `data/`：运行后自动生成，保存项目状态和上传资产。
+- `exports/`：运行后自动生成，保存导出结果。
+
+本目录不包含工程分析、软著撰写材料、参考模板、旧运行产物和开发依赖缓存。
+
+## 本机部署
+
+在本目录执行：
+
+```bash
+docker compose -f docker_compose.yaml up -d --build
+```
+
+访问：
+
+```text
+http://192.168.3.11:4000/
+http://127.0.0.1:4000/
+```
+
+查看状态和日志：
+
+```bash
+docker compose -f docker_compose.yaml ps
+docker compose -f docker_compose.yaml logs -f revoxelseg_web
+docker compose -f docker_compose.yaml logs -f revoxelseg_frpc
+```
+
+停止：
+
+```bash
+docker compose -f docker_compose.yaml down
+```
+
+## 威联通 NAS / QTS 部署
+
+建议将完整目录放到：
+
+```text
+/share/Container/revoxelseg_dicom
+```
+
+然后在 QTS Container Station 中导入或粘贴：
+
+```text
+docker_compose.nas.yaml
+```
+
+SSH 部署命令：
+
+```bash
+cd /share/Container/revoxelseg_dicom
+docker compose -f docker_compose.nas.yaml up -d --build
+```
+
+如果目录不是 `/share/Container/revoxelseg_dicom`，请修改 `docker_compose.nas.yaml` 中的 `build.context`、`data` 和 `exports` 挂载路径。
+
+## FRPC 公网映射
+
+两份 Compose 都内置 frpc 配置：
+
+```toml
+serverAddr = "82.157.255.195"
+serverPort = 7000
+
+auth.method = "token"
+auth.token = "en.xjtu.edu.cn"
+
+transport.poolCount = 5
+transport.heartbeatTimeout = -1
+
+[[proxies]]
+name = "ReVoxelSeg_DICOM"
+type = "tcp"
+localIP = "revoxelseg_web"
+localPort = 4000
+remotePort = 10008
+```
+
+FRPC 在线且 NPM 反向代理配置生效后，可通过：
+
+```text
+https://revoxel.huijutec.cn/
+```
+
+## 健康检查
+
+```bash
+curl http://127.0.0.1:4000/api/health
+```
+
+正常返回：
+
+```json
+{"ok":true,"service":"revoxelseg-dicom"}
+```
+