2026-05-21-14-19-12 通用Docker Release配置

README.md

@@ -1,6 +1,6 @@
-# ReVoxelSeg DICOM Docker 独立运行包
+# ReVoxelSeg DICOM Docker 通用运行包
 
-这是“基于模型逆向体素化及 DICOM 分割标注系统”的独立 Docker 程序目录。目录内已经包含运行所需源码、默认 DICOM 演示数据和默认 STL 模型数据，因此即使没有原始 `ReVoxelSeg_DICOM` 工程目录，也可以直接在本目录构建和运行。
+这是“基于模型逆向体素化及 DICOM 分割标注系统”的通用 Docker 程序目录。目录内包含运行所需源码、默认 DICOM 演示数据和默认 STL 模型数据，因此可以脱离原始工程目录独立构建和运行。
 
 ## 目录内容
 
@@ -8,14 +8,14 @@
 - `Head_CT_DICOM/`：默认 DICOM 影像序列。
 - `Head_CT_ReConstruct/`：默认 STL 模型。
 - `Dockerfile`：Docker 镜像构建文件。
-- `docker_compose.yaml`：本机 Docker Compose 部署文件。
-- `docker_compose.nas.yaml`：威联通 NAS / QTS Container Station 部署文件。
+- `docker_compose.yaml`：通用 Docker Compose 部署文件。
+- `.env.example`：通用环境变量示例。
 - `data/`：运行后自动生成，保存项目状态和上传资产。
 - `exports/`：运行后自动生成，保存导出结果。
 
-本目录不包含工程分析、软著撰写材料、参考模板、旧运行产物和开发依赖缓存。
+本通用版本不包含任何固定公网域名、固定 FRP 服务地址、固定鉴权 token 或固定远端端口。需要公网映射时，请按实际环境填写 `.env`。
 
-## 本机部署
+## 本机直接部署
 
 在本目录执行：
 
@@ -23,76 +23,54 @@
 docker compose -f docker_compose.yaml up -d --build
 ```
 
-访问：
+默认访问：
 
 ```text
-http://192.168.3.11:4000/
-http://127.0.0.1:4000/
+http://localhost:4000/
 ```
 
-查看状态和日志：
+如需改端口，复制环境变量文件后修改 `HOST_PORT`：
+
+```bash
+cp .env.example .env
+docker compose --env-file .env -f docker_compose.yaml up -d --build
+```
+
+## 启用 FRPC 公网映射
+
+复制配置模板：
+
+```bash
+cp .env.example .env
+```
+
+编辑 `.env`，填写：
+
+- `FRP_SERVER_ADDR`
+- `FRP_SERVER_PORT`
+- `FRP_AUTH_METHOD`
+- `FRP_AUTH_TOKEN`
+- `FRP_PROXY_NAME`
+- `FRP_REMOTE_PORT`
+- `APP_URL`
+
+启动 Web 与 FRPC：
+
+```bash
+docker compose --env-file .env --profile frpc -f docker_compose.yaml up -d --build
+```
+
+## 查看状态
 
 ```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
 ```
 
-停止：
+启用 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/
+docker compose --profile frpc -f docker_compose.yaml logs -f revoxelseg_frpc
 ```
 
 ## 健康检查
@@ -107,3 +85,8 @@ curl http://127.0.0.1:4000/api/health
 {"ok":true,"service":"revoxelseg-dicom"}
 ```
 
+## 停止服务
+
+```bash
+docker compose -f docker_compose.yaml down
+```