綦桐AI网关 · 线上版

从安卓到 Docker · 一键部署的 AI 网关服务器
OpenAI 兼容 Claude 兼容 Gemini 兼容 一键 Docker
v3.18.22 · 深色科技风 · 公益站运营

1️⃣ 这是什么?

綦桐AI网关线上版 = 把安卓版完整功能搬到服务器,一个 Docker 命令搞定

🎛️
统一管理
多个 AI 服务商(OpenAI / DeepSeek / Claude / Ollama / 中转)一个后台全管理
🔌
三格式兼容
对外提供 OpenAI / Claude / Gemini 三大格式 API,16+ 接口全兼容
🚀
qtai-sj 智能
虚拟模型自动选最快可用,全网关一个 key 随便调
🛡️
智能故障转移
模型失败自动切换池内下一个,绝不空白断开
👥
多租户
用户注册 / 密钥隔离 / 余额充值 / 分销返佣,公益站运营利器
📱
全端适配
手机 / 电脑自适应,深色科技风 UI 一比一对齐安卓版

2️⃣ 功能全景

模块核心能力
服务商OpenAI / DeepSeek / Claude / Ollama / 自定义,代理支持(HTTP/SOCKS5)
模型增删改查 / 启停 / 公用私有 / 定价 / 同步上游模型列表
测速排行三指标(TTFT/TPS/总耗时)+ 后台持续测速 + 进度条,离开页面也在跑
强制故障池点灯强制切换 / 多模型绑定 / 故障自动切换 / 用户级隔离
API密钥独立密钥 / 模型权限 / qtai-sj 访问控制 / 启停 / 限流防刷(QPS+日配额)
路由规则按路径/模型/密钥转发到指定模型,block 拦截
用量统计按模型汇总 / 按密钥分组 / 每次传输明细(token/流量/费用)
用户中心注册登录 / 邀请码 / 余额 / 充值扣款 / 分销返佣 / 权限管控
内置聊天完整会话 / 人格注入 / 大脑记忆 / 打字机效果
工单公告公告发布 / 工单中心(聊天式)/ 操作日志 / 钉钉+邮箱通知
技能系统自定义技能 / Git导入 / MCP 控制接口(远程控制网关)
安全加固限流防刷 / 暴力破解告警 / 7天免登录 / API错误像AI回答(不报错)

3️⃣ 一分钟部署

git clone https://github.com/qtgf520/Docker-qitong-ai-gateway.git cd Docker-qitong-ai-gateway docker compose build --no-cache docker compose up -d
🌐
Web 后台
http://服务器IP:18080
⚡
网关 API
http://服务器IP:18889/v1
📦
一键管理
start.sh up/down 构建启动停服

4️⃣ 教学:后台管理

  1. 打开 http://IP:18080 → 注册 / 登录(管理员默认创建)
  2. 首页看板:运行时长 / 可用模型 / 健康率 / 故障转移 / 我的余额
  3. 服务商:添加 AI 服务商(OpenAI/DeepSeek/中转),填 Base URL + API Key
  4. 模型:添加 / 同步模型,设公用(所有人可用)或私有(自己用)
  5. 测速排行:点「开始批量测速」→ 逐个跑,看 TTFT/TPS/总耗时
  6. 强制故障池:点灯加入池,失败自动切换;点灯=强制切换当前活跃
  7. API密钥:生成 key 给下游用户,控制权限和限流
  8. 用量统计:按模型/密钥/每次传输明细,费用清清楚楚

5️⃣ 教学:对接 API(三行代码)

# OpenAI 兼容(任何语言 / 任何客户端) curl http://你的服务器:18889/v1/chat/completions \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{"model":"qtai-sj","messages":[{"role":"user","content":"你好"}]}'
✦ 支持的接口
/v1/models · /v1/chat/completions · /v1/completions · /v1/embeddings · /v1/images/generations · /v1/audio/transcriptions · /v1/responses · Claude /v1/messages · Gemini /v1beta/models/{model}:generateContent · /v1/realtime (WS) · /health

6️⃣ 特色亮点

🧠
人格系统
自定义名字/性格/语气/背景 + 大五人格滑块,让 AI 有"人设"
💾
记忆系统
大脑记忆自动注入聊天,模型独立记忆开关,越聊越懂你
🌐
15 国语言
全界面 i18n 翻译,切换语言立即生效,国际化运营无忧
💬
友好错误
API 出错返回像正常 AI 回答(OpenAI 风格错误体),绝不 500 报错
🔔
通知系统
钉钉 Webhook + 邮箱 SMTP,新用户/新工单/暴力破解实时告警
🔗
Git 导入技能
自定义技能支持 Git raw / URL 一键导入,扩展无限可能

7️⃣ 商业化 · 公益站运营

💰
余额体系
充值 / 扣款 / 模型定价(元/百万Token),自动按用量计费
🎟️
邀请码
注册邀请码 / 分销返佣(默认10%),拉新裂变
🔑
Key 私有化
每用户独立 key,脱敏显示,数据全部按用户隔离
🛡️
限流防刷
QPS + 日配额,按 Key + 用户隔离,防滥用防盗刷
📊
传输明细
每次调用一条:token / 流量 / 费用,账目清清楚楚
🎫
工单客服
用户提交工单,管理员回复,聊天式沟通体验

8️⃣ 安全与隐私

🔒
用户数据隔离
无论管理员还是用户,只看到自己的数据(统计/用量/测速/模型)
🚨
暴力破解告警
同 IP 连续 5 次登录失败 → 钉钉/邮箱自动通知管理员
⏱️
限流防刷
API QPS + 每日配额,超出返回 429 中文提示
🔐
BCrypt 密码
密码加密存储,7 天免登录 Session 管理
👁️
Key 脱敏
API Key 脱敏显示,只有属主能看到完整 key
📜
操作日志
登录 / 公告 / 工单等关键操作全记录,可审计

9️⃣ 技术架构

🗣️
语言
Kotlin 100% (JVM)
🖥️
服务端
Ktor 3.1.0 (Netty)
📡
HTTP
OkHttp 4.12.0
🗄️
数据库
SQLite (JDBC)
🔐
密码
BCrypt
🐳
部署
Docker + Compose
├── Main.kt # 入口 + 全部路由 ├── WebUi.kt # Web UI(深色科技风) ├── AdminJs1/2/3.kt # 后台前端 ├── auth/ # 注册/登录/改密 ├── db/ # SQLite 数据层 ├── http/ # 网关代理+调度+规则 └── network/ # 上游客户端+SOCKS5

🔟 公益站运营建议

  1. 低倍率自建中转站:倍率从 0.1–0.3 起步,保本 = 上游成本/(1−毛利率),别只盯低价
  2. 合规稳定:至少 2–3 个正规上游源,分组检测备用切换,别依赖逆向
  3. 用户拉新:邀请码 + 分销返佣(默认10%),老带新裂变
  4. 运营通知:钉钉 + 邮箱配置好,新用户/新工单/暴力破解实时告警
  5. 安全防线:开启限流防刷(QPS+日配额),防滥用防盗刷
  6. 服务保障:公告 + 工单 + 操作日志,用户遇到问题有处反馈

立即开始

https://github.com/qtgf520/Docker-qitong-ai-gateway
开源免费 一键部署 多模型管理 公益站首选
綦桐AI网关 · Docker 线上版 v3.18.22