cf4e57cf79e2946fd41286a930aec41f77f477b2
- POST /ai/custom-models: 测试 OpenAI 兼容提供商并拉取模型(KEY仅请求透传不落盘) - POST /ai/gen-image: 可选 provider 字段 → _provider_images_gen 用用户 base_url+KEY 直连上游 - 生成成功落盘 DATA_DIR/gen_images/<machine>/ + index.json(每机100张超限清旧, thread lock) - GET /ai/img-history?machine= 历史列表; GET /ai/img/<m>/<id>[?dl=1] 图片文件/附件下载 - 图片文件端点从尾部解析路径段(兼容 nginx 剥 /relay 前缀与直连两条链路)
it-tools-relay
IT-Tools 的自建后端中继服务(Python 标准库 http.server,监听 8091,无第三方框架依赖)。为 IT-Tools 前端提供:
- 翻译代理
GET /translate—— 转发 Google Translate(走HTTPS_PROXY出网,解决国内不通) - 授权校验
GET /check—— 供 nginxauth_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)
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
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。
其他镜像变体
| 文件 | 用途 |
|---|---|
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 仓库) |
Releases
15
授权应用管理:显示开关 + 按功能试用时长
Latest
Languages
Python
99.6%
Dockerfile
0.4%