🎯 智能三层回退机制

创建带有自动回退功能的组合：

组合：“my-coding-stack”
  1. cc/claude-opus-4-6        （您的订阅）
  2. glm/glm-4.7               （廉价备份，0.6美元/100万次调用）
  3. if/kimi-k2-thinking       （免费回退）

→ 当配额用尽或发生错误时自动切换

📊 实时配额跟踪

• 各提供商的令牌消耗量
• 重置倒计时（5小时、每日、每周）
• 付费层级的成本估算
• 每月支出报告

🔄 格式转换

在以下格式之间无缝转换：

• OpenAI ↔ Claude ↔ Gemini ↔ OpenAI 响应
• 您的 CLI 工具发送 OpenAI 格式 → 9Router 转换 → 提供商接收原生格式
• 适用于所有支持自定义 OpenAI 端点的工具

👥 多账户支持

• 可为每个提供商添加多个账户
• 自动轮询或按优先级路由
• 当一个账户达到配额时自动切换到下一个账户

🔄 自动令牌刷新

• OAuth 令牌会在到期前自动刷新
• 不需要手动重新认证
• 在所有提供商之间实现无缝体验

🎨 自定义组合

• 可创建无限种模型组合
• 混合订阅、廉价和免费层级
• 为组合命名以便于访问
• 通过云同步在不同设备间共享组合

📝 请求日志记录

• 启用调试模式以获取完整的请求/响应日志
• 跟踪 API 调用、头信息和负载
• 排查集成问题
• 导出日志进行分析

💾 云同步

• 在不同设备间同步提供者、组合和设置
• 自动后台同步
• 安全加密存储
• 随时随地访问你的配置

云运行时说明

• 生产环境中优先使用服务器端云变量：
  • BASE_URL（同步调度器使用的内部回调 URL）
  • CLOUD_URL（云同步端点基础地址）
• NEXT_PUBLIC_BASE_URL 和 NEXT_PUBLIC_CLOUD_URL 仍为兼容性和 UI 目的而保留，但服务器运行时现在会优先使用 BASE_URL/CLOUD_URL。
• 云同步请求现采用超时 + 快速失败机制，以避免在云端 DNS 或网络不可用时导致 UI 卡死。

📊 使用分析

• 跟踪每个提供者和模型的 Token 使用情况
• 成本估算与支出趋势
• 每月报告与洞察
• 优化你的 AI 支出

💡 重要提示 - 理解仪表板成本：

使用分析中显示的“成本”仅用于跟踪和比较。
9Router 本身从不向你收费。你只需直接向各提供者支付费用（如果使用的是付费服务）。

示例： 如果你的仪表板显示使用 iFlow 模型时“总成本 $290”，这代表如果你直接使用付费 API 所需支付的金额。而你的实际成本 = $0（iFlow 是免费且无限制的）。

可以把它理解为一个“节省追踪器”，展示你通过使用免费模型或经由 9Router 路由所节省的金额！

🌐 部署于任何地方

• 💻 本地主机 - 默认模式，可离线使用
• ☁️ VPS/云服务器 - 多设备共享
• 🐳 Docker - 一键部署
• 🚀 Cloudflare Workers - 全球边缘网络

仪表板会跟踪您的 Token 使用情况，并以估算费用的形式展示，就好像您直接使用了付费 API 一样。这并非实际账单——它只是一个参考，用来显示您通过 9Router 使用免费模型或现有订阅节省了多少费用。

示例：

• 仪表板显示： “总费用 $290”
• 实际情况： 您正在使用 iFlow（免费无限量）
• 您的实际费用： $0.00
• $290 的含义： 如果您没有使用免费模型而改用付费 API，您将节省的金额！

费用显示是一个“节省追踪器”，旨在帮助您了解自己的使用模式和优化机会。

不会。 9Router 是一款免费的开源软件，运行在您自己的电脑上。它绝不会向您收取任何费用。

您只需支付：

• ✅ 订阅服务提供商（Claude Code $20/月，Codex $20–200/月）→ 直接在它们的官网上付款
• ✅ 低价服务提供商（GLM、MiniMax）→ 直接向它们付款，9Router 只是路由您的请求
• ❌ 9Router 本身 → 永远不会收费

9Router 是一个本地代理/路由器，它不保存您的信用卡信息，无法发送账单，也没有任何计费系统。它完全是一款免费软件。

是的！ 标记为 FREE 的服务提供商（iFlow、Kiro、Qwen）确实是真正意义上的无限量，没有任何隐藏费用。

这些是由相应公司提供的免费服务：

• iFlow： 通过 OAuth 提供 8+ 种模型的免费无限访问权限
• Kiro： 通过 AWS Builder ID 提供 Claude 模型的免费无限访问权限
• Qwen： 通过设备认证提供 Qwen 模型的免费无限访问权限

9Router 只是将您的请求路由到这些服务提供商处——不存在任何“陷阱”或未来的收费。它们确实是真正的免费服务，而 9Router 让您能够轻松使用这些服务，并提供后备支持。

注意： 一些订阅服务提供商（Antigravity、GitHub Copilot）可能会有免费试用期，之后转为付费，但这种情况会由这些服务提供商明确告知，而不是由 9Router 宣布。

“免费优先”策略：

1. 从 100% 免费组合开始：

   1. gc/gemini-3-flash（Google 提供每月 18 万次免费调用）
   2. if/kimi-k2-thinking（iFlow 提供的免费无限模型）
   3. qw/qwen3-coder-plus（Qwen 提供的免费无限模型）
   

   成本：$0/月

2. 仅在需要时添加低价备份：

   4. glm/glm-4.7（每 100 万 Token 仅需 $0.6）
   

   额外成本：仅按实际用量付费

3. 最后才使用订阅服务提供商：

   • 仅在您已经拥有这些服务的情况下使用
   • 9Router 通过配额跟踪帮助您最大化其价值

结果： 大多数用户仅使用免费层级即可实现零成本运行！

9Router 的智能回退机制可以防止意外产生高额费用：

场景： 您正在进行编码冲刺，迅速耗尽了所有配额。

如果没有 9Router：

• ❌ 达到速率限制 → 工作停止 → 极度沮丧
• ❌ 或者：不小心产生巨额 API 费用

有了 9Router：

• ✅ 订阅服务达到限制 → 自动回退到低价层级
• ✅ 低价层级费用过高 → 自动回退到免费层级
• ✅ 编码工作从未中断 → 成本可控

您可以完全掌控： 在仪表板中为每个服务提供商设置支出上限，9Router 会严格遵守这些限制。

Claude Code (Pro/Max)

仪表板 → 服务提供商 → 连接 Claude Code
→ OAuth 登录 → 自动刷新 Token
→ 5 小时 + 每周配额跟踪

模型：
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

实用技巧： 对于复杂任务使用 Opus，对于速度要求高的任务使用 Sonnet。9Router 会分别跟踪每个模型的配额！

OpenAI Codex (Plus/Pro)

仪表板 → 服务提供商 → 连接 Codex
→ OAuth 登录（端口 1455）
→ 5 小时 + 每周重置

模型：
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Gemini CLI（每月免费 18 万次调用！）

仪表板 → 服务提供商 → 连接 Gemini CLI
→ Google OAuth
→ 每月 18 万次完成 + 每日 1 千次

模型：
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

最佳选择： 海量的免费额度！请务必先使用这一层级，再考虑付费层级。

GitHub Copilot

仪表板 → 服务提供商 → 连接 GitHub
→ 通过 GitHub 进行 OAuth 登录
→ 每月 1 日重置

模型：
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3-pro

GLM-4.7（每日重置，每 100 万 Token $0.6）

1. 注册：Zhipu AI
2. 从 Coding Plan 获取 API 密钥
3. 仪表板 → 添加 API 密钥：
   • 服务提供商：glm
   • API 密钥：your-key

使用： glm/glm-4.7

实用技巧： Coding Plan 提供 3 倍配额，但价格仅为原价的七分之一！每天上午 10 点重置。

MiniMax M2.1（5 小时重置，每 100 万 Token $0.20）

1. 注册：MiniMax
2. 获取 API 密钥
3. 仪表板 → 添加 API 密钥

使用： minimax/MiniMax-M2.1

实用技巧： 长上下文（100 万 Token）的最佳廉价选择！

Kimi K2（每月固定 $9）

1. 订阅：Moonshot AI
2. 获取 API 密钥
3. 仪表板 → 添加 API 密钥

使用： kimi/kimi-latest

实用技巧： 每月固定 $9 即可获得 1000 万 Token，相当于每 100 万 Token 仅需 $0.90！

iFlow（8 种免费模型）

仪表板 → 连接 iFlow
→ iFlow OAuth 登录
→ 无限量使用

模型：
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen（3 种免费模型）

仪表板 → 连接 Qwen
→ 设备代码授权
→ 无限量使用

模型：
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro（Claude 免费版）

仪表板 → 连接 Kiro
→ AWS Builder ID 或 Google/GitHub
→ 无限量使用

模型：
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

示例 1：最大化订阅服务 → 低价备份

仪表板 → 组合 → 新建

名称：premium-coding
模型：
  1. cc/claude-opus-4-6（订阅服务主模型）
  2. glm/glm-4.7（低价备份，每 100 万 Token $0.6）
  3. minimax/MiniMax-M2.1（最便宜的回退选项，每 100 万 Token $0.20）

在 CLI 中使用：premium-coding

每月费用示例（100 万 Token）：
  80 万次通过 Claude（订阅服务）：无需额外费用
  15 万次通过 GLM：$9
  5 万次通过 MiniMax：$1
  总计：$10 加上您的订阅费用

示例 2：纯免费组合（零成本）

名称：free-combo
模型：
  1. gc/gemini-3-flash-preview（每月 18 万次免费调用）
  2. if/kimi-k2-thinking（无限量）
  3. qw/qwen3-coder-plus（无限量）

成本：永远 $0！

Cursor IDE

设置 → 模型 → 高级：
  OpenAI API 基础 URL：http://localhost:20128/v1
  OpenAI API 密钥：[来自 9router 仪表板]
  模型：cc/claude-opus-4-6

或者使用组合：premium-coding

Claude Code

编辑 ~/.claude/config.json：

{
  "anthropic_api_base": "http://localhost:20128/v1",
  "anthropic_api_key": "your-9router-api-key"
}

Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-9router-api-key"

codex "your prompt"

OpenClaw

选项 1 — 控制面板（推荐）：

控制面板 → CLI 工具 → OpenClaw → 选择模型 → 应用

选项 2 — 手动： 编辑 ~/.openclaw/openclaw.json：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "9router/if/glm-4.7"
      }
    }
  },
  "models": {
    "providers": {
      "9router": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_9router",
        "api": "openai-completions",
        "models": [
          {
            "id": "if/glm-4.7",
            "name": "glm-4.7"
          }
        ]
      }
    }
  }
}

注意： OpenClaw 只适用于本地的 9Router。为避免 IPv6 解析问题，请使用 127.0.0.1 而不是 localhost。

Cline / Continue / RooCode

提供商：兼容 OpenAI
基础 URL：http://localhost:20128/v1
API 密钥：[来自控制面板]
模型：cc/claude-opus-4-6

VPS 部署

# 克隆并安装
git clone https://github.com/decolua/9router.git
cd 9router
npm install
npm run build

# 配置
export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/9router"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export NEXT_PUBLIC_CLOUD_URL="https://9router.com"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"
export MACHINE_ID_SALT="endpoint-proxy-salt"

# 启动
npm run start

# 或者使用 PM2
npm install -g pm2
pm2 start npm --name 9router -- start
pm2 save
pm2 startup

Docker

# 构建镜像（从仓库根目录）
docker build -t 9router .

# 运行容器（当前设置中使用的命令）
docker run -d \
  --name 9router \
  -p 20128:20128 \
  --env-file /root/dev/9router/.env \
  -v 9router-data:/app/data \
  -v 9router-usage:/root/.9router \
  9router

便携式命令（如果您已经在仓库根目录下）：

docker run -d \
  --name 9router \
  -p 20128:20128 \
  --env-file ./.env \
  -v 9router-data:/app/data \
  -v 9router-usage:/root/.9router \
  9router

容器默认值：

• PORT=20128
• HOSTNAME=0.0.0.0

常用命令：

docker logs -f 9router
docker restart 9router
docker stop 9router && docker rm 9router

环境变量

注：

• 小写代理变量同样支持：http_proxy, https_proxy, all_proxy, no_proxy。
• .env 文件不会被烘焙到 Docker 镜像中（.dockerignore）；请使用 --env-file 或 -e 注入运行时配置。
• 在 Windows 上，可以使用 APPDATA 来解析本地存储路径。
• INSTANCE_NAME 出现在旧版文档/环境模板中，但目前在运行时并未使用。

运行时文件和存储

• 主应用程序状态：${DATA_DIR}/db.json（提供商、组合、别名、密钥、设置），由 src/lib/localDb.js 管理。
• 使用历史和日志：~/.9router/usage.json 和 ~/.9router/log.txt，由 src/lib/usageDb.js 管理。
• 可选的请求/翻译日志：当 ENABLE_REQUEST_LOGS=true 时，位于 <repo>/logs/...。
• 使用存储目前遵循 ~/.9router 路径逻辑，与 DATA_DIR 独立。

Claude Code (cc/) - Pro/Max：

• cc/claude-opus-4-6
• cc/claude-sonnet-4-5-20250929
• cc/claude-haiku-4-5-20251001

Codex (cx/) - Plus/Pro：

• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

Gemini CLI (gc/) - 免费：

• gc/gemini-3-flash-preview
• gc/gemini-2.5-pro

GitHub Copilot (gh/)：

• gh/gpt-5
• gh/claude-4.5-sonnet

GLM (glm/) - $0.6/1M：

• glm/glm-4.7

MiniMax (minimax/) - $0.2/1M：

• minimax/MiniMax-M2.1

iFlow (if/) - 免费：

• if/kimi-k2-thinking
• if/qwen3-coder-plus
• if/deepseek-r1

Qwen (qw/) - 免费：

• qw/qwen3-coder-plus
• qw/qwen3-coder-flash

Kiro (kr/) - 免费：

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5