CrewRouter 把多家上游模型供应商收成 一个 OpenAI / Anthropic 兼容端点。团队成员只拿网关下发的 Key，用 Claude Code、Codex、Cursor、OpenCode、Cherry Studio 等工具时，只需改 base_url。供应商密钥留在网关里，成员有使用权、没有所有权。
应用 → CrewRouter → OpenAI / Anthropic / DeepSeek / 更多…
- 多供应商聚合 — OpenAI、Anthropic、DeepSeek 等，一个端点全部接入
- 协议自动转换 — OpenAI ↔ Anthropic 双向转换，用 OpenAI SDK 调 Claude，或反过来
- 智能路由 — 按团队分配模型，支持别名、上游映射和自定义规则
- Fusion 模式 — 同一请求并发多个模型，裁判模型评估并综合最优回答
- 实时统计 — 请求量、Token、延迟、成本；按模型 / Key / 时间下钻
- API Key 管理 — 时间调度、模型绑定、自定义签名、独立 Fusion 配置
- 多因素认证 — TOTP、WebAuthn PassKey、飞书 / GitHub OAuth
- 动态密钥刷新 — 供应商 Key 可用脚本定时轮换并缓存
- 代理池 — 每供应商独立代理，支持订阅导入，应对跨境与 429
- 团队与权限 — 个人 / 默认 / 前沿团队分层，配合用户组限额
- 灵活计费 — Token 倍率、兑换码、余额告警、可退款余额
- 密钥隔离 — 上游地址与 Key 对成员和本地工具不可见
- Playground — 控制台内交互调试与会话历史
- 开箱向导 — 首次启动 OOBE 完成数据库与管理员配置
- 深浅色主题 — 跟随系统或手动切换
- 插件系统 — 沙箱插件框架：网关钩子、页面/插槽/路由扩展、主题插件，全能力面覆盖
- 插件商店 — 浏览、评分、一键安装、更新检测（demo 模式 / 自托管可配置源）
- 全站国际化 — 中英双语，译文托管实时拉取
- 注入提示词 — 按 key/全局条目化，Claude Code 风格注入，响应自动净化
- 客户端事件上报 — CrewRouterHelper 上报 + 实时活动看板
- OAuth 2.0 授权服务 — PKCE 授权码、刷新令牌与 AI 客户端授权
- 模型库增强 — 收藏、全局搜索、Key 拖拽排序、队列回退
- 自定义提示词指纹 — 调用记录标记 CLAUDE.md/AGENTS.md 等
- 会话总结 — 会话标签、生成总结
只需更换 base_url，无需改业务代码：
Claude Code · Claude Desktop · Codex · OpenCode · OpenClaw · Hermes Agent · Grok Build · DeepSeek Harness · Kilo Code · Cline · Cherry Studio · Qwen Code · Cursor · 以及一切走 OpenAI / Anthropic 协议的工具，以及安装了对应插件的任意客户端
# 只需更换 base_url
curl https://your-host/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-d '{
"model": "gpt-4.1",
"messages": [{"role": "user", "content": "Hello!"}]
}'from openai import OpenAI
client = OpenAI(
base_url="https://your-host/v1",
api_key="sk-your-key",
)
resp = client.chat.completions.create(
model="gpt-4.1",
messages=[{"role": "user", "content": "Hello!"}],
)从 GitHub Releases 下载 crewrouter-direct-v*.tar.gz（由 CI 自动构建），上传到服务器后：
tar xzf crewrouter-direct-v*.tar.gz
cd crewrouter-direct
./start.shstart.sh 会在首次运行时自动安装依赖、引导配置数据库（支持自动安装 PostgreSQL 或连接已有实例）并生成 config.json，随后自动启动服务。浏览器打开 http://your-server:20003 即可使用。
Tip
一键包支持管理后台一键更新：进入 管理后台 → 系统设置 → 版本与更新，点击检查更新并确认后自动拉取官方更新包、覆盖程序并重启，config.json 与数据库均保留。详见 docs/deployment.md。
cp .env.example .env # 填写 CR_SESSION_SECRET、CR_DB_PASSWORD 等
docker compose up -d浏览器打开 http://localhost:20003，按开箱向导完成初始化。
镜像：detritalw/crewrouter，亦可使用 CI 推送的 ghcr.io 镜像。Docker 部署不支持容器内一键更新，升级请拉取新镜像后 docker compose up -d。
需要 Node.js ≥ 16（建议 20 LTS）和 PostgreSQL ≥ 14。
npm install
cp config.example.json config.json # 填写数据库与 sessionSecret
# 创建数据库用户与库，例如：
# CREATE USER crewrouter WITH PASSWORD '...';
# CREATE DATABASE crewrouter OWNER crewrouter;
npm run init-db
npm start # 开发可用 npm run dev默认监听配置中的端口（示例为 20003）。生产部署、systemd 托管见 docs/deployment.md。
Note
演示站可在管理员开启 demo 后访问公开展示页与只读控制台，无需注册即可浏览界面。自托管默认 demo: false。
config.json（或 Docker 环境变量 CR_*）中最常改的几项：
| 项 | 说明 |
|---|---|
app.port / CR_APP_PORT |
监听端口，默认 20003 |
app.sessionSecret |
会话密钥，生产环境必须更换 |
database.* / CR_DB_* |
PostgreSQL 连接 |
initialProviders / initialModels |
首次初始化写入的供应商与模型 |
feishu / GitHub OAuth |
可选企业登录 |
email |
可选 SMTP（余额告警等） |
statsReport.* / CR_STATS_REPORT_* |
统计上报开关、地址、间隔与粒度（见下） |
完整字段见 config.example.json 与 docs/deployment.md。
自建实例默认不上报任何数据；当首次进入控制台的管理员在授权弹窗中允许（或在管理后台 → 系统设置中开启「统计信息上报」后），实例会按 interval（默认每 1 小时）向官方服务器发送一次匿名聚合的使用统计：请求量、Token 消耗、成本、活跃用户/密钥数、请求类型分布，以及可选的模型/供应商分布（granularity）。
不包含任何隐私信息：无用户名/邮箱/IP、无 API/上游密钥、无请求与回复正文。隐私优先，可在管理后台或 config.json 的 statsReport.enabled: false 随时关闭。演示模式（demo: true）下既不询问也不上报。
| 配置 | 说明 |
|---|---|
statsReport.enabled / CR_STATS_REPORT_ENABLED |
总开关，默认 true（仅为配置级强制，实际仍需管理员授权才上报）；false 时强制关闭 |
statsReport.url / CR_STATS_REPORT_URL |
上报地址，默认 https://crewrouter.bloret.net/api/stats-report |
statsReport.token / CR_STATS_REPORT_TOKEN |
可选共享令牌，配置后接收端才校验 |
statsReport.interval / CR_STATS_REPORT_INTERVAL |
上报间隔（秒），默认 3600 |
statsReport.granularity / CR_STATS_REPORT_GRANULARITY |
detailed（默认，含模型/供应商明细）或 counts（仅聚合计数） |
| 文档 | 内容 |
|---|---|
| docs/deployment.md | 直接运行 / Docker / 更新 |
| docs/ARCHITECTURE.md | 目录结构、路由与适配器 |
| docs/API.md | HTTP API |
| docs/integration-guide.md | 接入现有应用 |
| LOG_SPEC.md | 运行日志约定 |
- 运行时 Node.js · Express
- 数据 PostgreSQL
- 前端 原生 HTML / CSS / JS（控制台、管理后台、Playground、Showcase），含 i18n 与插件运行时
- 服务端 OAuth 授权服务与插件商店
- 安全 Session、TOTP、WebAuthn、OAuth、SSRF 校验
本项目以 GNU General Public License v3.0 发布。
- 你可以自由使用、修改和分发
- 衍生作品须同样以 GPL-3.0 发布
- 详见 LICENSE