2026-05-18-22-23-07 增加Docker安装包与发布配置

工程分析/实现方案-2026-05-18-22-23-07.md

@@ -0,0 +1,55 @@
+# 实现方案
+
+开始时间：2026-05-18-22-23-07
+
+## 容器化
+
+1. 新增 `Dockerfile`
+   - 基于 `python:3.12-slim`。
+   - 安装 `ffmpeg`、`libgl1`、`libglib2.0-0`、`libgomp1`。
+   - 安装 Docker 专用 `requirements-docker.txt`，OpenCV 使用 headless 版本。
+   - 复制 `backend`、`frontend`、`storage/samples`、`scripts`。
+   - 默认监听 `8001`。
+
+2. 新增 `requirements-docker.txt`
+   - 保留 FastAPI、Uvicorn、NumPy、scikit-image、Pillow 等运行依赖。
+   - 使用 `opencv-python-headless==4.13.0.92`，避免容器中额外 GUI 依赖和构建不稳定。
+
+3. 新增 `.dockerignore` 和扩展 `.gitignore`
+   - 排除 `.git`、缓存、测试产物、`storage/jobs`、`storage/uploads`、打包目录。
+
+## Compose 文件
+
+1. `docker_compose.yaml`
+   - 纯净模板。
+   - app 服务可直接构建启动。
+   - frpc 服务放在 `frpc` profile 中。
+   - 域名、FRP 地址、token、远端端口等以注释和环境变量形式标记为待填写。
+
+2. `docker_compose_huijutec.yaml`
+   - 直接运行版。
+   - app 端口映射 `10004:8001`。
+   - frpc 连接用户参考配置中的服务器和 token，`remotePort = 10004`。
+   - 预置 `PUBLIC_URL=https://isiseg.huijutec.cn`。
+
+3. `docker_compose_Nas.yaml`
+   - QNAP 版。
+   - build context 使用 `/share/Container/ISISeg`。
+   - 数据目录使用 `/share/Container/ISISeg/data/...`。
+   - 代理使用 `192.168.31.7:7893`。
+   - frpc 远端端口 `10004`。
+
+## 安装包
+
+- `isiseg-clean-install-2026-05-18-22-23-07.tar.gz`
+- `isiseg-huijutec-direct-2026-05-18-22-23-07.tar.gz`
+- `isiseg-qnap-nas-2026-05-18-22-23-07.tar.gz`
+
+每个包包含运行所需源码、Dockerfile、compose 文件和安装说明。
+
+## Gitea 发布
+
+- 提交代码到 main。
+- 创建 tag：`v2026-05-18-22-23-07-docker-packages`。
+- 调用 Gitea API 创建 release。
+- 上传三个 tar.gz 作为 release 附件。