it-tools-relay

IT-Tools 的自建后端中继服务(Python 标准库 http.server,监听 8091,无第三方框架依赖)。为 IT-Tools 前端提供:

  • 翻译代理 GET /translate —— 转发 Google Translate(走 HTTPS_PROXY 出网,解决国内不通)
  • 授权校验 GET /check —— 供 nginx auth_request 调用,卡密授权 / 试用窗口判定(网络故障 fail-open,不锁死付费用户)
  • AI 生图额度 POST /ai/quota(前端经 /relay/ai/quota,带 model 返回上游真实配额 upstream/upstream_daily/upstream_remaining/upstream_note)—— 两级真实限额:
    • 机器级:未授权用内置渠道每日 DAILY_FREE_LIMIT 次(默认 10,北京时间 0 点重置,daily_gen.json 落盘),生成成功才扣次,自带提供商/KEY 生成不计次;
    • 上游共享池(已授权同样受保护——内置模型上游是站主免费额度,不存在无限次):flux*/dall-e-3 走 Cloudflare Workers AI,官方 10,000 Neurons/天 ÷ 57.6 Neurons/张(1024×1024/4 步)≈ 173 张/天(CF_DAILY_LIMIT 默认 173,北京时间约 08:00 重置,daily_gen_cf.json 全站计数);pollinations-* 走 Pollinations(API Key 预算制,无固定日限,上游错误透传);
    • 额度用尽生图返回 403(含官方配额出处文案)并引导配置自己的 KEY
  • 卡密激活 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,免登录)。

授权功能接口

接口 方法 说明
/ai/face-swap POST AI 换脸(授权):multipart source/target(文件)+ consent=1(必填授权承诺),需 X-Machine-Id 头;多脸取最大,返回站内图片 URL
/ai/gen-image POST AI 生图(每日免费额度):JSON machine/prompt/model/width/height;尺寸需按模型档位传(dall-e-3 仅 1024×1024 / 1792×1024 / 1024×1792)
/ai/image-models GET 生图模型列表
/draft/save POST 草稿保存(全站自动保存):JSON machine/tool/state,落盘 data/drafts/<machine>/<tool>.json,state 上限 300KB;需 X-Machine-Id 头,tool 做路径穿越防护
/draft/load GET 草稿读取:?machine=&tool=,无草稿返回 data: null
/draft/delete POST 草稿删除:离开站点时清理,返回 deleted: true/false

PROTECTED_TOOLS 集合含 face-swap、poster-maker(海报前端门控),与前端 license.ts 双端同步。

环境变量(.env)

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

# AI 生图内置免费额度(可选)
DAILY_FREE_LIMIT=10          # 未授权机器每日次数(北京 0 点重置)
CF_DAILY_LIMIT=173           # Cloudflare 共享池张数/天(官方 10,000 Neurons ÷ 57.6/张)
CF_DAILY_FILE=/app/data/daily_gen_cf.json

# 出网代理(翻译等走 Google 的接口用,可选)
HTTPS_PROXY=http://host.docker.internal:7890
RELAY_TIMEOUT=25

# 上传限制(MB)
MAX_UPLOAD_MB=50
EOF

方式一:docker run

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(含全部参数):

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
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。

中文提示词自动转英文(2026-11-13)

_handle_gen_image / _handle_edit_image 发起生成前经 _translate_prompt():提示词含中文时用 IMG_PROMPT_MODEL(默认 mimo-v2.6-flash,走 NEWAPI_URL + NEWAPI_KEY)转成高质量英文生图提示词再发上游(Flux/SDXL 系对英文理解最好);进程内缓存 300 条;翻译失败/超时/结果仍含中文一律回退原文,绝不阻断生图;纯英文提示词原样透传。实际发送的英文随响应 prompt_en 字段返回(前端结果图操作行显示「🌐 已自动转英文发送(悬停查看)」);生成历史仍存用户原文。

其他镜像变体

文件 用途
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 仓库)
S
Description
IT-TOOLS-PRO relay 服务(代理/本地翻译/OCR/测速/授权门)
Readme
1.4 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 99.6%
Dockerfile 0.4%