6cae4e9 落盘 compose 时丢了 /:/hostfs:_load_storage_root 经 HOST_PREFIX 解析
storage_root,缺挂载则 DATA_DIR 漂移到容器易失 /vol3/... 层,重建容器后
用户库/.auth_secret/上传全丢(历史用户登录失败、新注册写易失层)。
同时挂载 config.json 双保险,并修正 storage_root=宿主真实数据路径
(容器路径 /app/data 在 hostfs 下会被前缀化到宿主无关目录)。
140 lines
6.1 KiB
Markdown
140 lines
6.1 KiB
Markdown
# it-tools-relay
|
||
|
||
IT-Tools 的自建后端中继服务(Python 标准库 `http.server`,**监听 8091**,无第三方框架依赖)。为 IT-Tools 前端提供:
|
||
|
||
- **翻译代理** `GET /translate` —— 转发 Google Translate(走 `HTTPS_PROXY` 出网,解决国内不通)
|
||
- **授权校验** `GET /check` —— 供 nginx `auth_request` 调用,卡密授权 / 试用窗口判定(网络故障 fail-open,不锁死付费用户)
|
||
- **卡密激活** `POST /activate` —— 代理 CardAuth 验卡,`CARD_AUTH_KEY` 只留在容器内
|
||
- **授权中心 hub** `GET /hub/announcements`(拉项目公告,服务端双保险过滤 `project_id`)+ `POST /hub/report`(安装登记 + 心跳在线统计,`X-Api-Key`/`X-Project-Id=6` 只存在服务端;**先心跳后 check-update**——实测 CardAuth heartbeat 会清空 `client_version/device_info`,check-update 放最后保证版本号落库)
|
||
- 另有大量 AI 对话/生图、TTS/ASR、视频、格式转换、网速测速、IP 查询等接口(`server.py`,约 3700 行)
|
||
|
||
Docker 镜像内置:calibre(`ebook-convert`)、ffmpeg、Piper(本地 TTS)、faster-whisper(本地 ASR)、rembg(抠图)、waifu2x(无损放大)、中文回退字体。模型文件(`hf-cache/`、`piper-models/`、`ai-models/`、`waifu2x/`)已预下载到构建上下文,**构建不需要联网**。
|
||
|
||
镜像也可直接拉取:`192.168.68.19:3200/jinghui/it-tools-relay:latest`(Gitea Container Registry,免登录)。
|
||
|
||
## 环境变量(`.env`)
|
||
|
||
```bash
|
||
cat > .env <<'EOF'
|
||
# CardAuth 授权中心(/check、/activate 用)
|
||
CARD_AUTH_KEY=your-cardauth-project-key
|
||
AUTH_BASE=https://auth.88531.cn/api
|
||
AUTH_USER=admin
|
||
AUTH_PASS=your-auth-pass
|
||
PROJECT_NAME=IT-Tools
|
||
PROJECT_ID=6
|
||
PROJECT_ALIASES=IT-Tools,IT-TOOLS-PRO
|
||
|
||
# IT-Tools 前端接入的中继地址(前端调用方填,非本容器变量)
|
||
# 中继监听 8091
|
||
|
||
# 管理员 / 人机验证
|
||
DEFAULT_ADMIN_USER=admin
|
||
DEFAULT_ADMIN_PW=change-me
|
||
ADMIN_TOKEN=
|
||
TURNSTILE_SECRET=
|
||
|
||
# AI 网关(可选,/ai/* 接口用)
|
||
NEWAPI_URL=https://your-newapi-host/v1/chat/completions
|
||
NEWAPI_KEY=sk-xxx
|
||
NEWAPI_MODEL=qwen3.8-flash
|
||
|
||
# 出网代理(翻译等走 Google 的接口用,可选)
|
||
HTTPS_PROXY=http://host.docker.internal:7890
|
||
RELAY_TIMEOUT=25
|
||
|
||
# 上传限制(MB)
|
||
MAX_UPLOAD_MB=50
|
||
EOF
|
||
```
|
||
|
||
## 方式一:docker run
|
||
|
||
```bash
|
||
docker build -t it-tools-relay .
|
||
docker run -d --name it-tools-relay --restart always \
|
||
--network ittools-net -p 8091:8091 --env-file .env \
|
||
-e DEFAULT_HOST_ROOT=/vol3/1000/HD3/docker/it-tools-relay/data \
|
||
-e HTTPS_PROXY=http://host.docker.internal:7890 \
|
||
-e HTTP_PROXY=http://host.docker.internal:7890 \
|
||
-e NO_PROXY=localhost,127.0.0.1,192.168.68.19 \
|
||
--add-host host.docker.internal:host-gateway \
|
||
--cap-add NET_ADMIN \
|
||
-v /:/hostfs \
|
||
-v /vol3/1000/HD3/docker/it-tools-relay/data:/app/data \
|
||
-v /vol3/1000/HD3/docker/it-tools-relay/data/config.json:/vol3/1000/HD3/docker/it-tools-relay/data/config.json \
|
||
it-tools-relay
|
||
```
|
||
|
||
已有镜像时可省去构建:`docker run ... 192.168.68.19:3200/jinghui/it-tools-relay:latest`。
|
||
|
||
数据(试用记录、用量库、用户库、news.json)持久化在目录 `data/`。要被 IT-Tools 的 nginx 按容器名反代,需加 `--network ittools-net`(`docker network create ittools-net`)。
|
||
|
||
注意事项(缺一不可):
|
||
- `--add-host host.docker.internal:host-gateway` 必须有,代理与宿主服务访问依赖该解析,缺失时境外 RSS 抓取报 `Network unreachable`;
|
||
- `HTTPS_PROXY/HTTP_PROXY` 指向宿主 Mihomo(BBC 等境外源直连不可达),`NO_PROXY` 必须包含内网地址(NewAPI/OCR/授权中心),否则内网请求被绕进代理;
|
||
- 国际新闻走代理抓取,改动代理配置后删除 `data/news.json` 再访问一次 `/news` 即可强制重抓。
|
||
|
||
## 方式二:Docker Compose 部署
|
||
|
||
本仓库根目录 `docker-compose.yml`(含全部参数):
|
||
|
||
```yaml
|
||
services:
|
||
it-tools-relay:
|
||
image: 192.168.68.19:3200/jinghui/it-tools-relay:latest
|
||
container_name: it-tools-relay
|
||
restart: always
|
||
ports:
|
||
- "8091:8091"
|
||
env_file:
|
||
- .env
|
||
environment:
|
||
# 宿主数据目录(/hostfs、宿主路径访问类接口用)
|
||
- DEFAULT_HOST_ROOT=/vol3/1000/HD3/docker/it-tools-relay/data
|
||
# 容器出网走宿主 Mihomo 代理(BBC RSS 等境外源直连不可达)
|
||
- HTTPS_PROXY=http://host.docker.internal:7890
|
||
- HTTP_PROXY=http://host.docker.internal:7890
|
||
# 内网服务(NewAPI/OCR/授权中心)直连,不走代理
|
||
- NO_PROXY=localhost,127.0.0.1,192.168.68.19
|
||
volumes:
|
||
# 数据持久化:试用记录 / 用量库 / 用户库 / news.json
|
||
- ./data:/app/data
|
||
# 宿主全路径(run 段同款):缺失则 DATA_DIR 漂移到容器易失层,重建后用户库/密钥全丢
|
||
- /:/hostfs
|
||
# 存储根配置必须持久:不挂载则落在容器易失层,重建容器后 storage_root 丢失
|
||
# → DATA_DIR 漂移到易失目录 → 用户库/密钥/上传全丢
|
||
- ./data/config.json:/vol3/1000/HD3/docker/it-tools-relay/data/config.json
|
||
cap_add:
|
||
- NET_ADMIN
|
||
extra_hosts:
|
||
# 缺失会导致境外 RSS 抓取 Network unreachable
|
||
- "host.docker.internal:host-gateway"
|
||
networks:
|
||
- ittools-net
|
||
|
||
networks:
|
||
# 接入既有 ittools-net 供 it-tools nginx 反代;external=true 防止重建同名网络
|
||
ittools-net:
|
||
external: true
|
||
```
|
||
|
||
```bash
|
||
git clone http://192.168.68.19:3200/jinghui/it-tools-relay.git
|
||
cd it-tools-relay
|
||
cat > .env # 按上表内容创建 .env
|
||
docker compose up -d --build
|
||
docker compose ps # it-tools-relay 为 running 即就绪
|
||
curl -s http://127.0.0.1:8091/auth-status # 返回 JSON 即服务正常
|
||
```
|
||
|
||
只重建代码(模型目录已缓存):`docker compose up -d --build it-tools-relay`。
|
||
|
||
## 其他镜像变体
|
||
|
||
| 文件 | 用途 |
|
||
|---|---|
|
||
| `Dockerfile` | 主镜像(完整模型 + AI 接口) |
|
||
| `Dockerfile.patch` | `FROM it-tools-relay:latest`,只覆盖 `server.py` / `video_ops.py` / `audio_ops.py` 的热更镜像(构建秒级) |
|
||
| `Dockerfile.lt` | `FROM it-tools-relay:se-patch`,LibreTranslate 相关补丁,需 `docker/lt` 目录的翻译栈配合(见 it-tools-pro 仓库) |
|