基于 QoderGateway 的 Qoder CN 兼容网关。
A Qoder CN compatible fork of QoderGateway with an OpenAI-compatible API.
本项目基于 bzym2/QoderGateway，保留原项目的 MIT 许可证，并补充了 Qoder CN 适配：
- 使用
gateway.qoder.com.cn的 PAT 鉴权接口 - 使用 Qoder CN 的 COSY 签名、请求编码和 Agent Chat SSE 协议
- 将 OpenAI/Pi 的
developer消息角色转换为 Qoder 支持的system - 动态读取 Qoder CN 当前账户的
/v1/models和/models模型列表，并缓存 10 分钟 - 修复 Linux 环境下的 Windows-only 依赖安装问题
This repository is based on bzym2/QoderGateway. The upstream MIT license is retained. The fork adds Qoder CN authentication and Agent Chat compatibility, OpenAI/Pi message-role conversion, model discovery endpoints, and Linux installation fixes.
在 Qoder 的 Account Integrations 创建 PAT，并在管理控制台导入。PAT、管理员密码和 API Key 只应保存在本地或服务器环境变量中，不要提交到 Git 仓库。
The core chat path is tested with Qoder CN PAT accounts. Token refresh behavior may vary as Qoder changes its regional authentication endpoints; re-import the PAT from the console if a stored session expires.
模型列表从 Qoder CN 网关按账号动态读取，缓存有效期为 10 分钟。Qoder 网关暂时不可用时，服务会继续使用上次成功读取的列表；首次读取失败时回退到 lite。聊天请求既支持模型显示名称，也支持目录返回的内部模型 key。
The model catalog is fetched per active Qoder account and cached for 10 minutes. If the catalog endpoint is temporarily unavailable, the last successful catalog is kept; a first-load failure falls back to lite. Chat requests accept both catalog display names and internal model keys.
Never commit .env, PATs, API keys, administrator passwords, SQLite databases, TLS private keys, or server-specific configuration. The repository includes ignore rules for these files; review git diff --cached before pushing.
本项目思路来源于 cubk1/qoder2api，在此基础上用 Python 重写了后端并新增了 WebUI 管理控制台、SQLite 持久化、多账号池轮转和独立文档站。
This project is inspired by cubk1/qoder2api. We rewrote the backend in Python and added a WebUI management console, SQLite persistence, multi-account pool rotation, and a standalone documentation site.
特别感谢 LINUX DO 社区提供的交流与推广平台。
Special thanks to the LINUX DO community for the platform of exchange and promotion.
- OpenAI 兼容接口 — 通过
/v1/chat/completions向客户端提供标准 Chat Completions API - 多账号池 — 导入多个 Qoder 账号，按 UID 自动去重，请求失败时自动轮转
- 两层鉴权 — 管理后台密钥与外部 API Key 分开配置
- SQLite 持久化 — 账号、API Key、全局配置全部存入本地数据库
- WebUI 控制台 — Dashboard、账号管理、API Key 管理、Playground、服务日志
- 独立文档站 —
/documents提供中英文 Wiki，支持本地搜索和目录跳转 - 自动检测语言 — 根据浏览器地区自动切换中文/英文
git clone https://github.com/XuYui/QoderGateway-CN.git
cd QoderGateway-CN
uv synccd frontend
npm install
npm run build
cd ..构建产物会输出到 src/qoder2api/static/，后端启动时直接托管 WebUI 与文档站。
cp .env.example .env编辑 .env，修改管理员密码：
QODER_ADMIN_PASSWORD=your-strong-password默认密码是
admin，强烈建议第一次登录后立即修改。
uv run qoder2api服务默认运行在 http://127.0.0.1:5050/。
| 路径 | 说明 |
|---|---|
/ |
Landing Page |
/console |
管理控制台 |
/documents |
文档站 / Wiki |
/v1/chat/completions |
OpenAI 兼容 API |
/v1/models |
OpenAI 兼容模型列表 |
在控制台导入账号后：
curl http://127.0.0.1:5050/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "lite",
"messages": [{ "role": "user", "content": "Hello" }],
"stream": false
}'| 变量 | 说明 | 默认值 |
|---|---|---|
QODER_HOST |
服务绑定地址 | 127.0.0.1 |
QODER_PORT |
服务端口 | 5050 |
QODER_ADMIN_PASSWORD |
管理员密码（覆盖 SQLite 存储值） | admin |
QODER_PROXY |
出站代理地址 | 空 |
QODER_ENABLE_DOCUMENTS |
是否启用文档页 | 1 |
QODER_ENABLE_LANDING |
是否启用 Landing Page | 1 |
QODER_PAT |
首次启动时自动导入的 PAT | 空 |
├── src/qoder2api/ # Python 后端
│ ├── app.py # FastAPI 路由
│ ├── accounts.py # SQLite 账号管理
│ ├── auth.py # Qoder 鉴权与签名
│ ├── bridge.py # OpenAI 兼容响应转换
│ ├── config.py # 配置读写
│ ├── database.py # SQLite schema
│ ├── env.py # 环境变量加载
│ └── static/ # 前端构建产物
├── frontend/ # React 前端源码
│ ├── src/App.tsx # 管理控制台
│ ├── src/docs-main.tsx # 文档站
│ ├── src/landing-main.tsx# Landing Page
│ └── src/docs/ # 中英文 Markdown 文档
├── .env.example # 环境变量模板
└── pyproject.toml # 项目配置
MIT