# ReVoxelSeg DICOM Docker 通用运行包

这是“基于模型逆向体素化及 DICOM 分割标注系统”的通用 Docker 程序目录。目录内包含运行所需源码、默认 DICOM 演示数据和默认 STL 模型数据，因此可以脱离原始工程目录独立构建和运行。

## 目录内容

- `WebSite/`：前后端一体服务源码。
- `Head_CT_DICOM/`：默认 DICOM 影像序列。
- `Head_CT_ReConstruct/`：默认 STL 模型。
- `Dockerfile`：Docker 镜像构建文件。
- `docker_compose.yaml`：通用 Docker Compose 部署文件。
- `.env.example`：通用环境变量示例。
- `data/`：运行后自动生成，保存项目状态和上传资产。
- `exports/`：运行后自动生成，保存导出结果。

本通用版本不包含任何固定公网域名、固定 FRP 服务地址、固定鉴权 token 或固定远端端口。需要公网映射时，请按实际环境填写 `.env`。

## 本机直接部署

在本目录执行：

```bash
docker compose -f docker_compose.yaml up -d --build
```

默认访问：

```text
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
```

启用 FRPC 后查看：

```bash
docker compose --profile frpc -f docker_compose.yaml logs -f revoxelseg_frpc
```

## 健康检查

```bash
curl http://127.0.0.1:4000/api/health
```

正常返回：

```json
{"ok":true,"service":"revoxelseg-dicom"}
```

## 停止服务

```bash
docker compose -f docker_compose.yaml down
```