Skip to content
Projects

BloretCrew/CrewRouter has 35 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 20:15 UTC. Last push 2026-11-14.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Your Team with AI, AI with provider.

Developer Tools

README.md

Original
CrewRouter

CrewRouter

一个 API 端点,接入所有 AI 模型。
智能路由、精细管控、实时洞察,为团队而生。


Build & Release 仓库大小 星标数 许可证 最新正式版 Docker

团队级 AI 模型统一网关 · OpenAI / Anthropic / Gemini 多协议 · 自托管

演示控制台 · 部署指南 · 架构说明 · API 文档


Personal / Team Edition

安装首次打开 /setup 时必须选择 personal 或 team,选择会写入实例数据库并永久固定,界面和 CR_EDITION 不能修改已初始化的版本。无人值守安装可在首次启动前设置 CR_EDITION=personal 或 CR_EDITION=team;已有实例若没有 edition 记录,需明确完成一次选择,含团队数据的旧库不会被自动标记为 Personal。Personal 版保留核心网关、个人 Key、用量和 Playground,团队管理接口返回 team_edition_required;Team 版保留现有团队管理能力。Edition 不是许可或安全边界,后端授权检查始终有效。正式页面品牌区的 LOCAL / PERSONAL / TEAM badge 仅展示实例状态:Desktop 本地运行时显示 LOCAL,服务端依据实例 edition 显示 PERSONAL 或 TEAM;它不是运行时切换控件。本地 runtime 与服务端 edition 是两个不同维度,runtime=desktop-local 优先于 edition。Desktop Local 使用 Bloret PassPort 登录,首次授权绑定本地账户;模型配置、API Key 和用量数据仍保存在本机。退出后需要重新登录,Desktop Token 仅标识应用请求来源。

使用 PassPort 登录的 Server 或 Desktop Local 需要配置独立应用的 ID 和 Secret。程序不再提供共享应用凭据,旧版公开的共享 Secret 也不再接受。Server 使用 passport.appId/appSecret 或 CR_PASSPORT_APP_ID/CR_PASSPORT_APP_SECRET;Desktop 的配置方式见 Desktop 说明。缺少配置时登录保持关闭,请先完成配置并重新启动。

隔离开发测试

请使用仓库外临时 config.json、临时端口(例如 20103)和独立 PostgreSQL 数据库运行测试,禁止使用生产端口 20003、Show 端口 20004 或生产 config.json/数据库。

npm run test:usage-write 验证 Token 归一化及写入保护,数据库回归自动创建仅监听临时 Unix socket 的独立 PostgreSQL 集群,需要本机提供 initdb、pg_ctl,以 root 运行时还需 postgres 用户和 runuser。新版本启动时为用量、消息分析和请求尝试安装写入保护:拒绝负数、异常时间及必填关联缺失,修正新用量记录的时间默认值;不回填历史记录,也不阻止历史坏字段未发生改变的其他更新。Token 数字字符串先转整数再求和,非法值及超出数据库整数范围的值直接拒绝,不静默清零。

写入保护与非空约束修补在同一连接、同一事务中安装:仅对当前没有空值的必填列恢复 NOT NULL,保留历史缺失字段,不自动补零、补关联或猜测时间。消息分析的必填字段、非负计数、分析时间以及请求的流式标志、用量质量均校验;analyzed_at 的默认值固定为上海墙钟,避免其他时区连接产生偏移。安装失败整体回滚,已有坏字段未改变的其他更新仍可执行。

历史用量时间恢复:先备份全库,再运行 node server/scripts/repair-usage-timestamps.js 只读预览;确认后使用 --apply --backup-dir /绝对路径/尚不存在的私有目录 实际修复。只恢复消息分析表中唯一 usage_id、相同用户且时间有效的原始时间副本,保留已有同毫秒时间的微秒精度,不推算 Token、金额或缺失关联。全部更新在同一事务中分批执行并核对行数,提交前将原值、来源及 SHA-256 同步写入权限受限的目录;失败整体回滚,提交结果不明时保留证据并需重新核查。npm run test:usage-repair 在独立 PostgreSQL 中验证恢复、回滚和幂等性。备份含业务数据,不应提交到 Git;原值可能包含坏时间,回退时须先处理写入保护,不能直接覆盖在线数据库。

它是什么

CrewRouter 把多家上游模型供应商收成 一个 OpenAI / Anthropic / Gemini 兼容端点。团队成员只拿网关下发的 Key,用 Claude Code、Codex、Cursor、OpenCode、Cherry Studio、Gemini CLI 等工具时,只需改 base_url。供应商密钥留在网关里,成员有使用权、没有所有权。

应用 → CrewRouter → OpenAI / Anthropic / Gemini / DeepSeek / 更多…

核心功能

  • 多供应商聚合 — OpenAI、Anthropic、Gemini、DeepSeek 等,一个端点全部接入
  • 协议自动转换 — OpenAI / Anthropic / Gemini generateContent / Interactions 双向转换,Gemini 客户端可调其它上游,OpenAI/Anthropic 客户端也可调 Gemini 上游
  • 智能路由 — 按团队分配模型,支持别名、上游映射和自定义规则
  • Fusion 模式 — 同一请求并发多个模型,裁判模型评估并综合最优回答
  • 实时统计 — 请求量、Token、延迟、成本;按模型 / Key / 时间下钻
  • API Key 管理 — 时间调度、模型绑定、自定义签名、独立 Fusion 配置
  • 多因素认证 — TOTP、WebAuthn PassKey、飞书 / PassPort 登录(按实例认证模式提供)
  • 动态密钥刷新 — 供应商 Key 可用脚本定时轮换并缓存
  • 代理池 — 每供应商独立代理,支持订阅导入,应对跨境与 429
  • 团队与权限 — 个人 / 默认 / 前沿团队分层,配合用户组限额
  • 灵活计费 — Token 倍率、兑换码、余额告警、可退款余额
  • 密钥隔离 — 上游地址与 Key 对成员和本地工具不可见
  • Playground — 控制台内交互调试与会话历史
  • 开箱向导 — 首次启动 OOBE 完成数据库与管理员配置
  • 深浅色主题 — 跟随系统或手动切换
  • 插件系统 — 沙箱插件框架:网关钩子、页面/插槽/路由扩展、主题插件,全能力面覆盖
  • 插件商店 — 浏览、评分、一键安装、更新检测(demo 模式 / 自托管可配置源)
  • 全站国际化 — 中英双语,译文托管实时拉取
  • 注入提示词 — 按 key/全局条目化,Claude Code 风格注入,响应自动净化
  • 客户端事件上报 — CrewRouterHelper 上报 + 实时活动看板
  • OAuth 2.0 授权服务 — PKCE 授权码、刷新令牌,支持 Desktop / Helper / CLI 与第三方公共/机密客户端
  • 模型库增强 — 收藏、全局搜索、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 · Gemini CLI / google-genai(Native Gemini + Interactions) · Antigravity CLI (agy) · Pi · Kimi Code · Qoder CLI · ZCode · 以及一切走 OpenAI Chat Completions / OpenAI Responses / Anthropic Messages / Gemini generateContent 协议的工具,以及安装了对应插件的任意客户端

# 只需更换 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!"}],
)

SDK

除了直接改 base_url,也可以使用 CrewRouter SDK 获得流式解析、统一错误、重试与管理接口封装。

形态 包 状态
Node/TypeScript 客户端 npm crewrouter-sdk 0.1.0 可用
Python 客户端 PyPI crewrouter-sdk 0.1.0 可用
Go 客户端 github.com/BloretCrew/CrewRouter/sdk/go 0.1.0 可用
可嵌入服务端 SDK crewrouter/embedded 预览可用(Node)
npm install crewrouter-sdk
import { CrewRouter } from 'crewrouter-sdk';

const client = new CrewRouter({
  baseUrl: process.env.CREWROUTER_BASE_URL,
  apiKey: process.env.CREWROUTER_API_KEY,
});

const response = await client.gateway.chat.completions.create({
  messages: [{ role: 'user', content: 'Hello!' }],
});

所有 SDK 均与主项目一样使用 GPL-3.0。完整文档见 docs/sdk/README.md。

命令行与 TUI(cr)

仓库内置零依赖的 CrewRouter CLI,既支持非交互式子命令,也支持可直接鼠标点击的全屏 TUI;可以连接远程实例,也可以从本机启动 CrewRouter 服务。

npm link          # 激活 cr 命令
cr                # 打开 TUI
cr connect https://router.example.com
cr login
cr status

常用命令:cr overview、cr providers、cr models、cr keys、cr usage、cr sessions、cr start/stop/logs、cr doctor。完整说明见 docs/cli.md。

快速开始

方式一:一键包(推荐)

从 GitHub Releases 下载 crewrouter-direct-v*.tar.gz(由 CI 自动构建),上传到服务器后:

tar xzf crewrouter-direct-v*.tar.gz
cd crewrouter-direct
./start.sh

start.sh 会在首次运行时自动安装依赖、引导配置数据库(支持自动安装 PostgreSQL 或连接已有实例)并生成 config.json,随后自动启动服务。浏览器打开 http://your-server:20003 即可使用。

[!TIP] 一键包支持管理后台一键更新:进入 管理后台 → 系统设置 → 版本与更新,点击检查更新并确认后自动拉取官方更新包、覆盖程序并重启,config.json 与数据库均保留。详见 docs/deployment.md。

方式二:Docker

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 会话密钥,生产环境必须更换
CR_ENABLE_KEY_SCRIPTS 供应商密钥刷新脚本默认禁用;审阅数据库中的脚本与外发目标后设为 1 才执行
CR_ENABLE_CUSTOM_QUOTA_SCRIPTS 自定义额度查询配置默认禁用;审阅其中的请求地址与密钥发送方式后设为 1 才执行
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 索引与 OpenAPI
docs/api/reference.md 由路由生成的全量接口表
docs/integration-guide.md 接入现有应用
docs/sdk/README.md SDK 总览(English)
docs/cli.md 命令行与鼠标交互 TUI(cr)
docs/sdk/quickstart-node.md Node SDK 快速开始
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

星标历史

相关链接

CrewRouter - Github CrewRouter QQ Discuss LinuxDo

模型归因引擎

模型归因已接入 Ikaleio/lm-detector,在本地执行数字指纹检测,支持 60 个候选模型。接入方式、结果限制及资源更新见 模型归因说明。