# 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 仓库) |