9Router 常见问题权威指南三层 Fallback 路由、Quota 追踪与零成本 AI 编码实战【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router导读9Router 是一个面向 AI 开发者的模型路由网关它把你已经付费的 Claude Code、Codex、Copilot 等订阅额度、超便宜的备用 API 与完全免费的 Provider 串联成一条永不中断的调用链通过三层 fallback 与实时 quota 追踪让 AI 编码工具Cursor、Cline、Claude Desktop、Codex CLI 等在额度耗尽时自动切换模型、继续工作而成本几乎为零。本文以仓库官方 FAQgitbook/content/vi/faq.md为骨架结合 combo.js、accountFallback.js、errorConfig.js 等核心源码系统回答它是什么、怎么定价、怎么连接、怎么部署、是否安全、如何更新与贡献等高频问题读完后你将能独立搭建一条低成本、高可用的 AI 编码链路。9Router 是什么把订阅额度用满的 AI 模型路由器官方 FAQ 给出的定义非常直接9Router 是一个 AI 模型路由器用于最大化订阅subscription价值并降低调用成本。它不是另一个模型而是一个运行在你本机或云端的网关层负责把来自各类 AI 编码工具Claude Code、Codex、Cursor、Cline、Copilot、Antigravity 等的请求智能地转发给最适合的底层 Provider。其核心机制是三层 fallback 系统订阅层Tier 1 - Subscription优先消耗你已经在付费的 Claude Code、Codex、Gemini 等订阅额度——因为这些钱不花就浪费了超便宜层Tier 2 - Cheap当订阅额度耗尽回落到每百万 token 仅 0.20–0.60 美元的廉价 API免费层Tier 3 - Free当所有付费额度都被限制时用不限量的免费模型兜底保证永远不会停下来。FAQ 总结的核心收益包括不浪费任何订阅额度、额度耗尽时自动 fallback、实时 quota 追踪、相比直连 API 可节省约 90% 成本该比例为文档口径实际节省取决于用量分布。从源码看这个自动 fallback正是 combo.js 中handleComboChat的核心逻辑它按顺序遍历 combo 中的模型列表逐个调用handleSingleModel一旦某个模型返回result.ok就直接返回否则解析错误文本与retryAfter调用checkFallbackError来自 accountFallback.js判断是否应切换到下一个模型直到全部失败才返回 503。也就是说三层 fallback在实现层面就是一条有序的模型链 逐级重试。Pricing 如何运作三层计费策略详解FAQ 用一整节解释了定价策略核心思想是**先用完已付的钱再花最少的钱最后用免费的钱**。Tier 1订阅层优先使用Provider价格区间Quota 规则Claude CodePro/Max$20–100/月5 小时 每周配额OpenAI CodexPlus/Pro$20–200/月5 小时 每周配额Gemini CLI免费180K completions/月 1K/天GitHub Copilot$10–19/月每月重置Antigravity免费与 Gemini 类似目标在配额重置前用光所有额度。Tier 2廉价层后备Provider单价Quota 规则GLM-4.7$0.60/$2.20 per 1M tokens每天 10:00 AM 重置MiniMax M2.1$0.20/$1.00 per 1M tokens5 小时滚动窗口Kimi K2$9/月固定10M tokens月度目标比 ChatGPT API$20/1M便宜 90% 以上。Tier 3免费层紧急兜底Provider内容Quota 规则iFlow8 个免费模型Kimi K2、Qwen3、GLM、MiniMax 等无限制Qwen3 个免费模型Qwen3 Coder Plus/Flash、Vision无限制Kiro2 个免费模型Claude Sonnet 4.5、Haiku 4.5无限制目标其他所有层都被限制时以零成本兜底。关于上述价格与模型名称均以官方文档口径为准实际以 Provider 侧最新计费与额度规则为准仓库源码中的 errorConfig.js 还定义了quota exceeded、rate limit等错误的判定规则见后文Quota 追踪一节。9Router 是否免费开源 免费 ProviderFAQ 明确回答是的9Router 完全免费且 100% 开源仓库根目录与 cli 目录均包含 MIT LICENSE。可用的免费 Provider 包括Gemini CLI每月 180K completionsGoogle 免费账号即可iFlow8 个不限量模型免费 OAuthQwen3 个不限量模型免费 OAuthKiroClaude Sonnet/Haiku免费 AWS Builder ID。FAQ 甚至给出结论只使用免费 Provider你可以永远免费编码。而可选付费部分Claude Code、Codex、Copilot 订阅、$0.20–0.60/1M 的廉价 API纯粹是可选项——你完全可以一分钱不花把免费的 Gemini CLI iFlow Qwen Kiro 组合成一条 100% 免费的调用链参见 gitbook/content/vi/providers/free.md 中的 free-combo 与 zero-cost 示例。支持哪些 ProviderFAQ 给出了三类 Provider 的全景总计 15 Provider、50 模型模型清单以文档为准订阅类 ProviderClaude CodePro/MaxClaude 4.5 Opus/Sonnet/HaikuOpenAI CodexPlus/ProGPT 5.2 Codex、GPT 5.1 Codex MaxGemini CLI免费Gemini 3 Flash/Pro、2.5 Pro/FlashGitHub CopilotGPT-5、Claude 4.5、Gemini 3AntigravityGoogleGemini 3 Pro、Claude Sonnet 4.5。廉价类 ProviderGLM智谱 AIGLM 4.7、GLM 4.6V VisionMiniMaxMiniMax M2.1Kimi月之暗面Kimi LatestOpenRouter透传到 OpenRouter 上的任意模型。免费类 ProvideriFlow8 个模型Kimi K2、Qwen3、GLM、MiniMax、DeepSeek 等Qwen3 个模型Qwen3 Coder Plus/Flash、VisionKiro2 个模型Claude Sonnet 4.5、Haiku 4.5。各 Provider 的接入方式OAuth 登录、Device Code、API Key与模型 ID 详见 gitbook/content/vi/providers/subscription.md、gitbook/content/vi/providers/cheap.md 与 gitbook/content/vi/providers/free.md。从源码看Provider 的使用量获取由 usage.js 中的USAGE_HANDLERS映射表统一分发github、gemini-cli、antigravity、claude、codex、kiro、qwen、iflow、glm、minimax、kimi、deepseek 等均有对应处理器说明这些 Provider 的 quota 数据是真实从上游拉取的而不是静态硬编码。能否同时使用多个 ProviderCombo 机制FAQ 明确回答可以这正是 9Router 的核心功能。通过Combo组合你可以把多个 Provider 按优先级串成一条带自动 fallback 的模型链。一个典型 Combo 示例来自 FAQExample combo: premium-coding 1. cc/claude-opus-4-5 (订阅层主用) 2. glm/glm-4.7 (廉价后备) 3. if/kimi-k2 (免费应急) → 额度耗尽时自动切换 → 编码永不中断 → 额外成本极低创建 Combo 的步骤Dashboard → Combos → Create New → 按优先级顺序添加模型 → 在 CLI 中使用 combo 名称premium-coding收益额度耗尽时零停机成本自动优化对所有工具暴露同一个模型名。源码级原理Combo 的实现集中在 combo.js顺序 fallbackhandleComboChat逐个尝试模型成功即返回失败则按规则降级combo.jsround-robin 轮转getRotatedModels支持按stickyLimit参数控制每个模型连续承接的请求数实现负载分摊combo.js能力感知的自动切换auto-switchdetectRequiredCapabilities会扫描当前用户轮次中的图片/PDF 等模态reorderByCapabilities把能满足硬性能力vision、pdf、audioInput、videoInput的模型浮到链首避免多模态请求打到纯文本模型combo.jsFusion 融合模式handleFusionChat把请求并行扇出给多个面板模型再由一个 judge 模型综合共识/矛盾/盲点后输出单一答案默认minPanel: 2、stragglerGraceMs: 8000、panelHardTimeoutMs: 90000combo.js。更多可落地的 Combo 模板premium-coding、budget-combo、free-combo、quality-first、multi-sub、reset-optimized 及完整的三层/四层兜底链见 gitbook/content/vi/features/combos.md。Quota 追踪如何工作FAQ 描述了实时 quota 追踪的完整能力仓库侧的 usage.js 证实这些数据来自真实的上游接口。追踪功能Token 消耗每次请求的输入/输出 token重置倒计时距离 quota 刷新的剩余时间用量统计日/周/月报告成本预估付费层的预计支出Quota 告警额度偏低时通知。Quota 类型重置规则类型适用 Provider5 小时滚动Claude Code、Codex、MiniMax每日重置Gemini CLI1K/天、GLM10:00 AM每周重置Claude Code、Codex追加额度每月重置Gemini CLI180K、GitHub Copilot每月 1 日查看 QuotaDashboard → Providers → Quota Tracking → 实时用量 重置倒计时详细的可视化面板示例、按模型/按时间/按 Combo 的用量分析、成本预估与 API 接口GET /api/quota、GET /api/usage?periodtoday见 gitbook/content/vi/features/quota-tracking.md。底层实现错误分类与退避Quota 追踪之外fallback 是否触发由 accountFallback.js 与 errorConfig.js 决定错误规则自上而下匹配文本规则优先如 rate limit、quota exceeded、capacity、overloaded、too many requests 触发指数退避再匹配状态码401/402/403/404/429 等errorConfig.js指数退避配置为base: 2000ms、max: 5min、maxLevel: 15errorConfig.js请求成功后resetAccountState会清除冷却并归零退避等级accountFallback.js对 503/502/504 这类瞬时错误combo 会先等待cooldownMs不超过 5 秒再切换避免把短暂过载的 Provider 直接跳过combo.js。9Router 支持 Cursor 吗FAQ 回答支持但 Cursor 需要云端端点。问题Cursor IDE 不支持 localhost 端点方案一使用 9Router 云端部署Cursor Settings → Models → Advanced: OpenAI API Base URL: https://9router.com/v1 OpenAI API Key: [来自 dashboard] Model: cc/claude-opus-4-5-20251101方案二自托管在有公网域名的 VPS 上通过 Nginx 反代把 Cursor 指向https://your-domain.com/v1。而其他 CLI 工具直接支持 localhostCline ✅、Claude Desktop ✅、Codex CLI ✅、Continue ✅、RooCode ✅。详细集成步骤见 gitbook/content/vi/integration/cursor.md。本仓库不包含云端端点请自行部署见下文Self-host集成方式同样适用于本仓库的本地安装。能否 Self-host 9RouterFAQ 列出多种部署方式。以本仓库package.json 为 Web 应用、cli/package.json 为 CLI 封装为准安装与部署要点如下Localhost默认npm install -g 9router 9router → Dashboard: http://localhost:3000 → API: http://localhost:20128/v1首次运行会创建数据目录~/.9router、自动生成 API key并在浏览器打开 Dashboard默认登录密码为123456建议立即修改。VPS/Cloud从源码构建本仓库根目录即应用目录git clone https://gitcode.com/GitHub_Trending/9r/9router cd 9router npm install npm run build export JWT_SECRETyour-secure-secret export INITIAL_PASSWORDyour-password export NODE_ENVproduction npm start也可参考仓库自带的 Dockerfile、docker-compose.yml 与 start.sh。Dockerdocker build -t 9router . docker run -d \ -p 3000:3000 \ -e JWT_SECRETyour-secret \ -v 9router-data:/app/data \ 9router环境变量一览变量说明JWT_SECRET生产环境必须修改DATA_DIR数据库存储路径默认~/.9routerINITIAL_PASSWORDDashboard 登录密码默认123456NODE_ENV部署时设为productionPORT服务端口默认 20128可用9router --port 3000覆盖完整的环境变量说明、Nginx 反代配置含 SSE 流式支持所需的proxy_buffering off与长超时与常见安装问题端口占用、权限、Node 版本等见 gitbook/content/vi/getting-started/installation.md 与 gitbook/content/vi/deployment/cloud.md。数据安全吗FAQ 从三个方面给出了隐私立场且这些都可以在仓库结构中得到印证数据默认落在本机~/.9router见 src/lib/dataDir.js。本地存储所有数据保存在本地~/.9router或自定义DATA_DIR不向 9Router 服务器发送数据OAuth token 用 JWT 加密保存。无遥测不追踪使用行为无 analytics无 phone-home。开源可审计全部源码开放可自行安全审计、社区评审。实践建议生产环境务必更换JWT_SECRET使用强INITIAL_PASSWORD云部署启用 HTTPS定期轮换 API key。9Router 保存什么 / 不保存什么保存不保存Provider 的 OAuth token加密你的 prompts 与 responsesAPI keys加密你生成的代码使用统计仅本地个人信息Combo 配置—如何更新 9RouterFAQ 按安装方式给出了对应的升级路径全局 NPM 安装npm update -g 9router本地源码安装cd 9router git pull origin main npm install npm run build npm startDockerdocker pull 9router:latest docker stop 9router docker rm 9router docker run -d \ -p 3000:3000 \ -v 9router-data:/app/data \ 9router:latest版本检查与破坏性变更9router --version大版本升级前先查看 CHANGELOG.md升级前备份~/.9router数据目录注意 major 版本的 migration 指引。如何参与贡献FAQ 列出了多种贡献方式报告 bug附上错误日志与复现步骤请求新功能描述使用场景与收益提交代码Fork 后建分支、本地npm install/npm run dev、写测试、提交 PR改进文档修正拼写、补充示例、翻译、写教程新增 Provider参考仓库中的 Provider 实现示例本仓库对应目录为 open-sse/providers/registry 与 open-sse/executors。基本约定包括遵循现有代码风格、为新功能补测试、同步更新文档、保持 commit 小而清晰。故障排查与求助渠道FAQ 提供的排障起点包括 troubleshooting.md详细问题与解法、installation.md部署类排障以及各功能文档自带的 Troubleshooting 小节Quota 相关查看 Dashboard 的 Quota 追踪等待重置窗口或在 combo 中加入廉价/免费层兜底OAuth token 过期9Router 会自动刷新仍失败则在 Dashboard → Providers 重新连接Rate limiting订阅额度耗尽的表现之一补充glm/glm-4.7等廉价 fallback或用if/kimi-k2-thinking免费层应急Combo 相关刷新 dashboard、确认 combo 已保存、重启 CLI 工具刷新模型列表若总是落到最后一层先检查主模型 quota 与 API key详见 gitbook/content/vi/features/combos.md。从代码层面看当 combo 全部模型失败时handleComboChat 会返回 503而非 406并携带最早可重试时间retryAfter客户端可据此等待后自动重试——这解释了 FAQ 中等待 quota reset建议的实现依据。总结从 FAQ 出发9Router 的完整使用心智可以归纳为一句话把订阅额度放在链首、把便宜 API 放在中段、把免费模型放在尾部让网关替你自动切换。本文覆盖了 FAQ 的全部问题——产品定位、三层定价、免费开源、Provider 全景、Combo 机制、Quota 追踪、Cursor 集成、自托管部署、数据安全、更新与贡献——并补充了 combo.js、accountFallback.js、errorConfig.js、usage.js 等源码级证据。如需进一步深入推荐按顺序阅读 gitbook/content/vi/features/combos.md、gitbook/content/vi/features/smart-routing.md 与 gitbook/content/vi/features/quota-tracking.md。【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
9Router 常见问题权威指南三层 Fallback 路由、Quota 追踪与零成本 AI 编码实战【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router导读9Router 是一个面向 AI 开发者的模型路由网关它把你已经付费的 Claude Code、Codex、Copilot 等订阅额度、超便宜的备用 API 与完全免费的 Provider 串联成一条永不中断的调用链通过三层 fallback 与实时 quota 追踪让 AI 编码工具Cursor、Cline、Claude Desktop、Codex CLI 等在额度耗尽时自动切换模型、继续工作而成本几乎为零。本文以仓库官方 FAQgitbook/content/vi/faq.md为骨架结合 combo.js、accountFallback.js、errorConfig.js 等核心源码系统回答它是什么、怎么定价、怎么连接、怎么部署、是否安全、如何更新与贡献等高频问题读完后你将能独立搭建一条低成本、高可用的 AI 编码链路。9Router 是什么把订阅额度用满的 AI 模型路由器官方 FAQ 给出的定义非常直接9Router 是一个 AI 模型路由器用于最大化订阅subscription价值并降低调用成本。它不是另一个模型而是一个运行在你本机或云端的网关层负责把来自各类 AI 编码工具Claude Code、Codex、Cursor、Cline、Copilot、Antigravity 等的请求智能地转发给最适合的底层 Provider。其核心机制是三层 fallback 系统订阅层Tier 1 - Subscription优先消耗你已经在付费的 Claude Code、Codex、Gemini 等订阅额度——因为这些钱不花就浪费了超便宜层Tier 2 - Cheap当订阅额度耗尽回落到每百万 token 仅 0.20–0.60 美元的廉价 API免费层Tier 3 - Free当所有付费额度都被限制时用不限量的免费模型兜底保证永远不会停下来。FAQ 总结的核心收益包括不浪费任何订阅额度、额度耗尽时自动 fallback、实时 quota 追踪、相比直连 API 可节省约 90% 成本该比例为文档口径实际节省取决于用量分布。从源码看这个自动 fallback正是 combo.js 中handleComboChat的核心逻辑它按顺序遍历 combo 中的模型列表逐个调用handleSingleModel一旦某个模型返回result.ok就直接返回否则解析错误文本与retryAfter调用checkFallbackError来自 accountFallback.js判断是否应切换到下一个模型直到全部失败才返回 503。也就是说三层 fallback在实现层面就是一条有序的模型链 逐级重试。Pricing 如何运作三层计费策略详解FAQ 用一整节解释了定价策略核心思想是**先用完已付的钱再花最少的钱最后用免费的钱**。Tier 1订阅层优先使用Provider价格区间Quota 规则Claude CodePro/Max$20–100/月5 小时 每周配额OpenAI CodexPlus/Pro$20–200/月5 小时 每周配额Gemini CLI免费180K completions/月 1K/天GitHub Copilot$10–19/月每月重置Antigravity免费与 Gemini 类似目标在配额重置前用光所有额度。Tier 2廉价层后备Provider单价Quota 规则GLM-4.7$0.60/$2.20 per 1M tokens每天 10:00 AM 重置MiniMax M2.1$0.20/$1.00 per 1M tokens5 小时滚动窗口Kimi K2$9/月固定10M tokens月度目标比 ChatGPT API$20/1M便宜 90% 以上。Tier 3免费层紧急兜底Provider内容Quota 规则iFlow8 个免费模型Kimi K2、Qwen3、GLM、MiniMax 等无限制Qwen3 个免费模型Qwen3 Coder Plus/Flash、Vision无限制Kiro2 个免费模型Claude Sonnet 4.5、Haiku 4.5无限制目标其他所有层都被限制时以零成本兜底。关于上述价格与模型名称均以官方文档口径为准实际以 Provider 侧最新计费与额度规则为准仓库源码中的 errorConfig.js 还定义了quota exceeded、rate limit等错误的判定规则见后文Quota 追踪一节。9Router 是否免费开源 免费 ProviderFAQ 明确回答是的9Router 完全免费且 100% 开源仓库根目录与 cli 目录均包含 MIT LICENSE。可用的免费 Provider 包括Gemini CLI每月 180K completionsGoogle 免费账号即可iFlow8 个不限量模型免费 OAuthQwen3 个不限量模型免费 OAuthKiroClaude Sonnet/Haiku免费 AWS Builder ID。FAQ 甚至给出结论只使用免费 Provider你可以永远免费编码。而可选付费部分Claude Code、Codex、Copilot 订阅、$0.20–0.60/1M 的廉价 API纯粹是可选项——你完全可以一分钱不花把免费的 Gemini CLI iFlow Qwen Kiro 组合成一条 100% 免费的调用链参见 gitbook/content/vi/providers/free.md 中的 free-combo 与 zero-cost 示例。支持哪些 ProviderFAQ 给出了三类 Provider 的全景总计 15 Provider、50 模型模型清单以文档为准订阅类 ProviderClaude CodePro/MaxClaude 4.5 Opus/Sonnet/HaikuOpenAI CodexPlus/ProGPT 5.2 Codex、GPT 5.1 Codex MaxGemini CLI免费Gemini 3 Flash/Pro、2.5 Pro/FlashGitHub CopilotGPT-5、Claude 4.5、Gemini 3AntigravityGoogleGemini 3 Pro、Claude Sonnet 4.5。廉价类 ProviderGLM智谱 AIGLM 4.7、GLM 4.6V VisionMiniMaxMiniMax M2.1Kimi月之暗面Kimi LatestOpenRouter透传到 OpenRouter 上的任意模型。免费类 ProvideriFlow8 个模型Kimi K2、Qwen3、GLM、MiniMax、DeepSeek 等Qwen3 个模型Qwen3 Coder Plus/Flash、VisionKiro2 个模型Claude Sonnet 4.5、Haiku 4.5。各 Provider 的接入方式OAuth 登录、Device Code、API Key与模型 ID 详见 gitbook/content/vi/providers/subscription.md、gitbook/content/vi/providers/cheap.md 与 gitbook/content/vi/providers/free.md。从源码看Provider 的使用量获取由 usage.js 中的USAGE_HANDLERS映射表统一分发github、gemini-cli、antigravity、claude、codex、kiro、qwen、iflow、glm、minimax、kimi、deepseek 等均有对应处理器说明这些 Provider 的 quota 数据是真实从上游拉取的而不是静态硬编码。能否同时使用多个 ProviderCombo 机制FAQ 明确回答可以这正是 9Router 的核心功能。通过Combo组合你可以把多个 Provider 按优先级串成一条带自动 fallback 的模型链。一个典型 Combo 示例来自 FAQExample combo: premium-coding 1. cc/claude-opus-4-5 (订阅层主用) 2. glm/glm-4.7 (廉价后备) 3. if/kimi-k2 (免费应急) → 额度耗尽时自动切换 → 编码永不中断 → 额外成本极低创建 Combo 的步骤Dashboard → Combos → Create New → 按优先级顺序添加模型 → 在 CLI 中使用 combo 名称premium-coding收益额度耗尽时零停机成本自动优化对所有工具暴露同一个模型名。源码级原理Combo 的实现集中在 combo.js顺序 fallbackhandleComboChat逐个尝试模型成功即返回失败则按规则降级combo.jsround-robin 轮转getRotatedModels支持按stickyLimit参数控制每个模型连续承接的请求数实现负载分摊combo.js能力感知的自动切换auto-switchdetectRequiredCapabilities会扫描当前用户轮次中的图片/PDF 等模态reorderByCapabilities把能满足硬性能力vision、pdf、audioInput、videoInput的模型浮到链首避免多模态请求打到纯文本模型combo.jsFusion 融合模式handleFusionChat把请求并行扇出给多个面板模型再由一个 judge 模型综合共识/矛盾/盲点后输出单一答案默认minPanel: 2、stragglerGraceMs: 8000、panelHardTimeoutMs: 90000combo.js。更多可落地的 Combo 模板premium-coding、budget-combo、free-combo、quality-first、multi-sub、reset-optimized 及完整的三层/四层兜底链见 gitbook/content/vi/features/combos.md。Quota 追踪如何工作FAQ 描述了实时 quota 追踪的完整能力仓库侧的 usage.js 证实这些数据来自真实的上游接口。追踪功能Token 消耗每次请求的输入/输出 token重置倒计时距离 quota 刷新的剩余时间用量统计日/周/月报告成本预估付费层的预计支出Quota 告警额度偏低时通知。Quota 类型重置规则类型适用 Provider5 小时滚动Claude Code、Codex、MiniMax每日重置Gemini CLI1K/天、GLM10:00 AM每周重置Claude Code、Codex追加额度每月重置Gemini CLI180K、GitHub Copilot每月 1 日查看 QuotaDashboard → Providers → Quota Tracking → 实时用量 重置倒计时详细的可视化面板示例、按模型/按时间/按 Combo 的用量分析、成本预估与 API 接口GET /api/quota、GET /api/usage?periodtoday见 gitbook/content/vi/features/quota-tracking.md。底层实现错误分类与退避Quota 追踪之外fallback 是否触发由 accountFallback.js 与 errorConfig.js 决定错误规则自上而下匹配文本规则优先如 rate limit、quota exceeded、capacity、overloaded、too many requests 触发指数退避再匹配状态码401/402/403/404/429 等errorConfig.js指数退避配置为base: 2000ms、max: 5min、maxLevel: 15errorConfig.js请求成功后resetAccountState会清除冷却并归零退避等级accountFallback.js对 503/502/504 这类瞬时错误combo 会先等待cooldownMs不超过 5 秒再切换避免把短暂过载的 Provider 直接跳过combo.js。9Router 支持 Cursor 吗FAQ 回答支持但 Cursor 需要云端端点。问题Cursor IDE 不支持 localhost 端点方案一使用 9Router 云端部署Cursor Settings → Models → Advanced: OpenAI API Base URL: https://9router.com/v1 OpenAI API Key: [来自 dashboard] Model: cc/claude-opus-4-5-20251101方案二自托管在有公网域名的 VPS 上通过 Nginx 反代把 Cursor 指向https://your-domain.com/v1。而其他 CLI 工具直接支持 localhostCline ✅、Claude Desktop ✅、Codex CLI ✅、Continue ✅、RooCode ✅。详细集成步骤见 gitbook/content/vi/integration/cursor.md。本仓库不包含云端端点请自行部署见下文Self-host集成方式同样适用于本仓库的本地安装。能否 Self-host 9RouterFAQ 列出多种部署方式。以本仓库package.json 为 Web 应用、cli/package.json 为 CLI 封装为准安装与部署要点如下Localhost默认npm install -g 9router 9router → Dashboard: http://localhost:3000 → API: http://localhost:20128/v1首次运行会创建数据目录~/.9router、自动生成 API key并在浏览器打开 Dashboard默认登录密码为123456建议立即修改。VPS/Cloud从源码构建本仓库根目录即应用目录git clone https://gitcode.com/GitHub_Trending/9r/9router cd 9router npm install npm run build export JWT_SECRETyour-secure-secret export INITIAL_PASSWORDyour-password export NODE_ENVproduction npm start也可参考仓库自带的 Dockerfile、docker-compose.yml 与 start.sh。Dockerdocker build -t 9router . docker run -d \ -p 3000:3000 \ -e JWT_SECRETyour-secret \ -v 9router-data:/app/data \ 9router环境变量一览变量说明JWT_SECRET生产环境必须修改DATA_DIR数据库存储路径默认~/.9routerINITIAL_PASSWORDDashboard 登录密码默认123456NODE_ENV部署时设为productionPORT服务端口默认 20128可用9router --port 3000覆盖完整的环境变量说明、Nginx 反代配置含 SSE 流式支持所需的proxy_buffering off与长超时与常见安装问题端口占用、权限、Node 版本等见 gitbook/content/vi/getting-started/installation.md 与 gitbook/content/vi/deployment/cloud.md。数据安全吗FAQ 从三个方面给出了隐私立场且这些都可以在仓库结构中得到印证数据默认落在本机~/.9router见 src/lib/dataDir.js。本地存储所有数据保存在本地~/.9router或自定义DATA_DIR不向 9Router 服务器发送数据OAuth token 用 JWT 加密保存。无遥测不追踪使用行为无 analytics无 phone-home。开源可审计全部源码开放可自行安全审计、社区评审。实践建议生产环境务必更换JWT_SECRET使用强INITIAL_PASSWORD云部署启用 HTTPS定期轮换 API key。9Router 保存什么 / 不保存什么保存不保存Provider 的 OAuth token加密你的 prompts 与 responsesAPI keys加密你生成的代码使用统计仅本地个人信息Combo 配置—如何更新 9RouterFAQ 按安装方式给出了对应的升级路径全局 NPM 安装npm update -g 9router本地源码安装cd 9router git pull origin main npm install npm run build npm startDockerdocker pull 9router:latest docker stop 9router docker rm 9router docker run -d \ -p 3000:3000 \ -v 9router-data:/app/data \ 9router:latest版本检查与破坏性变更9router --version大版本升级前先查看 CHANGELOG.md升级前备份~/.9router数据目录注意 major 版本的 migration 指引。如何参与贡献FAQ 列出了多种贡献方式报告 bug附上错误日志与复现步骤请求新功能描述使用场景与收益提交代码Fork 后建分支、本地npm install/npm run dev、写测试、提交 PR改进文档修正拼写、补充示例、翻译、写教程新增 Provider参考仓库中的 Provider 实现示例本仓库对应目录为 open-sse/providers/registry 与 open-sse/executors。基本约定包括遵循现有代码风格、为新功能补测试、同步更新文档、保持 commit 小而清晰。故障排查与求助渠道FAQ 提供的排障起点包括 troubleshooting.md详细问题与解法、installation.md部署类排障以及各功能文档自带的 Troubleshooting 小节Quota 相关查看 Dashboard 的 Quota 追踪等待重置窗口或在 combo 中加入廉价/免费层兜底OAuth token 过期9Router 会自动刷新仍失败则在 Dashboard → Providers 重新连接Rate limiting订阅额度耗尽的表现之一补充glm/glm-4.7等廉价 fallback或用if/kimi-k2-thinking免费层应急Combo 相关刷新 dashboard、确认 combo 已保存、重启 CLI 工具刷新模型列表若总是落到最后一层先检查主模型 quota 与 API key详见 gitbook/content/vi/features/combos.md。从代码层面看当 combo 全部模型失败时handleComboChat 会返回 503而非 406并携带最早可重试时间retryAfter客户端可据此等待后自动重试——这解释了 FAQ 中等待 quota reset建议的实现依据。总结从 FAQ 出发9Router 的完整使用心智可以归纳为一句话把订阅额度放在链首、把便宜 API 放在中段、把免费模型放在尾部让网关替你自动切换。本文覆盖了 FAQ 的全部问题——产品定位、三层定价、免费开源、Provider 全景、Combo 机制、Quota 追踪、Cursor 集成、自托管部署、数据安全、更新与贡献——并补充了 combo.js、accountFallback.js、errorConfig.js、usage.js 等源码级证据。如需进一步深入推荐按顺序阅读 gitbook/content/vi/features/combos.md、gitbook/content/vi/features/smart-routing.md 与 gitbook/content/vi/features/quota-tracking.md。【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
