Files
it-tools-relay/README.md
T
3970260761 b30ffda52e fix: compose/README 补回 -v /:/hostfs(canonical run line 同款)+ config.json 持久挂载
6cae4e9 落盘 compose 时丢了 /:/hostfs:_load_storage_root 经 HOST_PREFIX 解析
storage_root,缺挂载则 DATA_DIR 漂移到容器易失 /vol3/... 层,重建容器后
用户库/.auth_secret/上传全丢(历史用户登录失败、新注册写易失层)。
同时挂载 config.json 双保险,并修正 storage_root=宿主真实数据路径
(容器路径 /app/data 在 hostfs 下会被前缀化到宿主无关目录)。
2026-11-12 20:04:17 +08:00

140 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 仓库) |