ghcr.io/decolua/9router:0.5.12

9Router - 免费 AI 路由与 Token 节省工具

永不中断编码。通过 RTK 节省 20-40% 的 Token，并自动回退至免费及低成本 AI 模型。

连接所有 AI 编码工具（Claude Code、Cursor、Antigravity、Copilot、Codex、Gemini、OpenCode、Cline、OpenClaw...）至 40+ AI 提供商及 100+ 模型。

🚀 快速开始 • 💡 核心功能 • 📖 设置指南 • 🌐 官网

🇻🇳 越南语 • 🇨🇳 中文 • 🇯🇵 日本語 • 🇷🇺 俄语

---

🧠 Headroom 令牌节省器

Headroom 是可选组件，独立运行。9Router 会调用 Headroom 的本地 /v1/compress 端点，同时保留正常的路由、回退、身份验证和使用跟踪功能：

Client → 9Router → Headroom /v1/compress → 9Router → provider

本地设置：

pip install "headroom-ai[proxy]"
headroom proxy --port 8787

在 Dashboard → Endpoint → Token Saver → Headroom 中启用。默认 URL：http://localhost:8787。

Docker 示例：

# Headroom 服务在同一 Docker 网络中

# Headroom 在主机上运行

如果 Headroom 宕机或返回错误，9Router 会故障开放（fail open）并发送原始请求。

❓ 常见问题解答

📊 为什么我的仪表盘显示高额费用？

仪表盘会跟踪您的令牌使用量，并显示估算费用，模拟直接使用付费 API 的情况。这并非实际账单——它是一个参考指标，用于展示通过 9Router 使用免费模型或现有订阅所节省的金额。

示例：

• 仪表盘显示： “总费用 $290”
• 实际情况： 您正在使用 iFlow（免费无限量）
• 您的实际成本： $0.00
• $290 的含义： 通过使用免费模型而非付费 API，您节省的金额！

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

💳 9Router会向我收费吗？

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

您只需支付：

• ✅ 订阅提供商（Claude Code 每月 $20，Codex 每月 $20-200）→ 直接在其网站上支付
• ✅ 低成本提供商（GLM、MiniMax）→ 直接向他们支付，9Router 仅负责路由请求
• ❌ 9Router 本身 → 永远不会收取任何费用

9Router 是本地代理/路由器。它没有您的***信息，无法发送账单，也没有计费系统。它是完全免费的软件。

🆓 免费提供商真的是无限量的吗？

是的！ 当前的免费提供商（Kiro、OpenCode Free、Vertex）是真正免费的，无任何隐藏费用。

这些是各公司提供的免费服务：

• Kiro AI：通过 AWS Builder ID / Google / GitHub OAuth 提供免费无限量的 Claude 4.5 + GLM-5 + MiniMax
• OpenCode Free：无需认证的直通代理，模型自动从 opencode.ai/zen/v1/models 获取
• Vertex AI：新 Google Cloud 账户可获得 $300 免费额度（90 天）

9Router 仅负责将您的请求路由到这些服务——没有“陷阱”或未来计费。它们是真正的免费服务，而 9Router 让它们易于使用并支持 fallback。

已停用的免费套餐（不再推荐）：

• ❌ iFlow：曾为免费无限量，现已改为付费（2026 年）
• ❌ Qwen Code：阿里巴巴于 2026-04-15 停用免费 OAuth 套餐
• ❌ Gemini CLI：仍可使用，但将其与非 CLI 工具（Claude、Codex、Cursor...）配合使用可能导致账户封禁——仅在坚持使用 Gemini CLI 本身时使用

💰 如何最大程度降低实际AI成本？

免费优先策略：

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（$0.6/100 万令牌）

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

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

• 仅在您已订阅的情况下使用
• 9Router 通过配额跟踪帮助最大化其价值

结果： 大多数用户仅使用免费套餐即可实现每月 $0 成本！

📈 如果我的使用量突然激增怎么办？

9Router 的智能 fallback 可防止意外费用：

场景： 您正在进行编码冲刺，用完了所有配额

没有 9Router 时：

• ❌ 达到速率限制 → 工作中断 → frustration
• ❌ 或：意外产生巨额 API 账单

有 9Router 时：

• ✅ 订阅配额用尽 → 自动 fallback 到低成本套餐
• ✅ 低成本套餐费用过高 → 自动 fallback 到免费套餐
• ✅ 编码从不中断 → 成本可预测

一切尽在您的掌控： 在仪表盘中设置每个提供商的支出限额，9Router 会严格遵守。

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

已发布镜像（多平台 linux/amd64 + linux/arm64）：

• Docker Hub：https://hub.docker.com/r/decolua/9router
• GHCR：https://github.com/decolua/9router/pkgs/container/9router

快速启动（使用已发布镜像）：

docker run -d \
--name 9router \
-p 20128:20128 \
-v "$HOME/.9router:/app/data" \
-e DATA_DIR=/app/data \
decolua/9router:latest

→ 打开 http://localhost:20128

从源码构建（开发环境）：

git clone https://github.com/decolua/9router.git
cd 9router/app
docker build -t 9router .
docker run -d --name 9router -p 20128:20128 \
-v "$HOME/.9router:/app/data" -e DATA_DIR=/app/data 9router

容器默认值：

• PORT=20128
• HOSTNAME=0.0.0.0

常用命令：

docker logs -f 9router
docker restart 9router
docker stop 9router && docker rm 9router
docker pull decolua/9router:latest # 更新至最新版本

数据持久化： 主机上的 $HOME/.9router/db/data.sqlite ↔ 容器内的 /app/data/db/data.sqlite。

环境变量

[!NOTE]

• 也支持小写代理变量：http_proxy、https_proxy、all_proxy、no_proxy。
• .env 文件不会打包到Docker镜像中（通过 .dockerignore 排除）；使用 --env-file 或 -e 注入运行时配置。
• 在Windows系统上，APPDATA 可用于本地存储路径解析。
• INSTANCE_NAME 出现在旧文档/环境模板中，但当前运行时未使用。

运行时文件和存储

• 应用主状态：${DATA_DIR}/db/data.sqlite（SQLite数据库 — 存储提供商、组合、别名、密钥、设置、使用历史）
• 自动备份：${DATA_DIR}/db/backups/
• 可选请求/翻译器日志：当 ENABLE_REQUEST_LOGS=true 时存储于 /logs/...
• 在Docker容器中，${DATA_DIR} 和 ~/.9router 解析为同一位置 — 构建时会创建符号链接 /root/.9router -> /app/data。

---

📊 可用模型

查看所有可用模型

Claude Code（cc/） - 专业版/高级版：

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

Codex（cx/） - Plus/专业版：

• cx/gpt-5.5
• cx/gpt-5.4
• cx/gpt-5.3-codex
• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

GitHub Copilot（gh/）：

• gh/gpt-5.4
• gh/claude-opus-4.7
• gh/claude-sonnet-4.6
• gh/gemini-3.1-pro-preview
• gh/grok-code-fast-1

Cursor（cu/） - 订阅制：

• cu/claude-4.6-opus-max
• cu/claude-4.5-sonnet-thinking
• cu/gpt-5.3-codex
• cu/kimi-k2.5

GLM（glm/） - 0.6***/百万 tokens：

• glm/glm-5.1
• glm/glm-5
• glm/glm-4.7

MiniMax（minimax/） - 0.2***/百万 tokens：

• minimax/MiniMax-M2.7
• minimax/MiniMax-M2.5

Kimi（kimi/） - 9***/月 flat 费率：

• kimi/kimi-k2.5
• kimi/kimi-k2.5-thinking

Kiro（kr/） - 免费无限量：

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5
• kr/glm-5
• kr/MiniMax-M2.5
• kr/qwen3-coder-next
• kr/deepseek-3.2

OpenCode Free（oc/） - 免费无需认证：

• 自动从 opencode.ai/zen/v1/models 获取

Vertex AI（vertex/） - 300***免费额度：

• vertex/gemini-3.1-pro-preview
• vertex/gemini-3-flash-preview
• vertex/gemini-2.5-flash
• vertex-partner/glm-5-maas
• vertex-partner/deepseek-v3.2-maas

---

🐛 故障排除

"Language model did not provide messages"（语言模型未返回消息）

• 提供商配额耗尽 → 检查控制台配额跟踪器
• 解决方法：使用组合 fallback 或切换到更低成本的层级

速率限制

• 订阅配额用尽 → 回退到 GLM/MiniMax
• 添加组合：cc/claude-opus-4-7 → glm/glm-5.1 → kr/claude-sonnet-4.5

OAuth令牌过期

• 9Router会自动刷新
• 若问题持续：控制台 → 提供商 → 重新连接

成本过高

• 在控制台启用RTK → 端点设置（默认开启，节省20-40% tokens）
• 检查控制台中的使用统计
• 将主模型切换为GLM/MiniMax
• 非关键任务使用免费层级（Kiro、OpenCode Free、Vertex）

控制台在错误端口打开

• 设置 PORT=20128 和 NEXT_PUBLIC_BASE_URL=http://localhost:20128

首次登录失败

• 检查 .env 中的 INITIAL_PASSWORD
• 若未设置，回退密码为 123456

logs/ 目录下无请求日志

• 设置 ENABLE_REQUEST_LOGS=true

---

🛠️ 技术栈

• 运行时：Node.js 20+
• 框架：Next.js 16
• UI：React 19 + Tailwind CSS 4
• 数据库：SQLite（better-sqlite3 / node:sqlite / sql.js 回退）
• 流式传输：Server-Sent Events（SSE）
• 认证：OAuth 2.0（PKCE）+ JWT + API Keys

---

📝 API参考

聊天补全

POST http://localhost:20128/v1/chat/completions
Authorization: Bearer your-api-key
Content-Type: application/json

{
"model": "cc/claude-opus-4-6",
"messages": [
{"role": "user", "content": "Write a function to..."}
],
"stream": true
}

列表模型

GET http://localhost:20128/v1/models
Authorization: Bearer your-api-key

→ 返回所有模型和组合（OpenAI格式）

📧 支持

• 网站：9router.com
• GitHub：https://github.com/decolua/9router
• 问题反馈：https://github.com/decolua/9router/issues

---

👥 贡献者

感谢所有帮助改进9Router的贡献者！

---

📊 星级图表

🔀 分支项目

https://github.com/diegosouzapw/OmniRoute — 9Router的全功能TypeScript分支。新增36+提供商、4层自动回退、多模态API（图像、嵌入、音频、TTS）、熔断机制、语义缓存、LLM评估和完善的控制台。包含368+单元测试。可通过npm和Docker获取。

---

🙏 致谢

站在巨人的肩膀上构建：

• https://github.com/router-for-me/CLIProxyAPI — 启发此JavaScript移植版的原始Go实现。

特别感谢这些作者 — 没有他们的工作，9Router的token节省功能将无法实现。在GitHub上给他们点个⭐吧！

---

📄 许可证

MIT许可证 - 详见LICENSE。

---

用❤️为全天候编码的开发者打造