9Router：免费 AI 编程路由器 — 安装指南与免费模型资源推荐

引言

“API 配额用完了，等明天再写吧……”

用过 Claude Code、Codex、Cursor 等 AI 编程工具的朋友，应该都遇到过这种尴尬。自己的订阅额度有限，小项目还好，高强度使用时经常被打断。那有没有一种方式，能让订阅耗尽后自动切换到收费更低的模型，甚至免费模型，保证编码不中断？

9Router 就是为解决这个问题而生的。

它是一个开源的 AI 路由器，作为代理层连接你的 AI 编程工具到 60+ 个 AI 提供商和 100+ 个模型。无论是 Claude Code、OpenAI Codex、OpenClaw、Cursor 还是 Cline，只需修改 API 端点指向 9Router，就能享受智能路由和三级自动回退带来的无缝编码体验。

本文将详细介绍 9Router 的安装步骤，重点讨论”装在哪最合适”这个实际问题，最后推荐一些值得收藏的免费模型资源。

什么是 9Router？

简单说，9Router 是你和所有 AI 模型之间的一个智能网关。它提供统一的 OpenAI-compatible 接口，让你不需要为每个工具分别配置不同的 Provider。

核心特性

RTK Token Saver — 自动压缩 git diff、grep、ls 等工具输出，节省 20-65% 的输入 Tokens
Caveman 模式 — 让回复更简洁，大幅减少回复 Tokens，配合 RTK 效果翻倍
三级自动回退 — 订阅 → 低价 → 免费，额度用尽时自动降级，零停机
60+ AI Providers — 覆盖 9 大类服务：Chat、Embeddings、TTS、STT、图像、视频、搜索等
多账户轮询 — 同一提供商多账户自动负载均衡
配额追踪 — 仪表盘实时显示各提供商剩余额度和使用量

支持的工具

Claude Code、OpenAI Codex、OpenClaw、Cursor IDE、Cline、Kilo Code、GitHub Copilot ……任何支持 OpenAI-compatible 的工具都可以直接接入。

安装步骤

9Router 提供了三种安装方式，覆盖不同场景。

方式一：npm 全局安装（推荐）

这是最简单的方式，适合大多数个人开发者。

# 全局安装
npm install -g 9router

# 启动
9router

启动后，终端会显示仪表盘地址 http://localhost:20128，浏览器打开即可看到管理界面。首页会引导你连接第一个 Provider。

方式二：Docker 部署

适合服务端持续运行或团队共享的场景。

docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 20128:20128 \
  -v /path/to/9router-data:/app/data \
  ghcr.io/decolua/9router:latest

-v 参数将数据目录持久化到宿主机，升级容器后配置和配额记录不丢失。

方式三：从源码运行

适合需要二次开发或调试的场景。

git clone https://github.com/decolua/9router.git
cd 9router
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

生产模式：

1 2	npm run build PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run start

验证安装是否成功

启动后，打开 http://localhost:20128，如果看到 9Router 的仪表盘界面，说明安装成功。你也可以直接调用 API 测试：

1	curl http://localhost:20128/v1/models

返回包含所有可用模型的 JSON 列表即为正常。

重点：9Router 安装到哪儿最合适？

这是新手最常问的问题。9Router 只是一个 Node.js 应用，理论上能跑 Node.js 的地方都能装。但安装位置的选择直接影响使用体验和团队协作效率，我们分几个场景来分析。

场景一：个人开发机

推荐方案：npm 全局安装（方式一）

维度	评价
安装难度	⭐ 最简单，一条命令
延迟	⭐ 最低，localhost
持续运行	关机关服，但随用随启
数据安全	数据在本地，不外传
适合人群	个人开发者、新手

这是最推荐的入门方式。9Router 启动后常驻后台，你的 AI 工具通过 localhost:20128 接入。关机后下次启动仍然保留配置和数据。

小技巧：如果希望 9Router 开机自启，可以配置 pm2 或 systemd 服务。

场景二：局域网团队共享

推荐方案：Docker 部署到 NAS 或家用服务器（方式二）

# 监听所有网络接口
docker run -d \
  --name 9router \
  --restart always \
  -p 20128:20128 \
  -v /opt/9router/data:/app/data \
  ghcr.io/decolua/9router:latest

维度	评价
安装难度	⭐⭐ 需 Docker 基础
延迟	⭐⭐ 局域网延迟 < 1ms
持续运行	✅ 24/7 运行
团队协作	✅ 共享配置和配额
适合人群	小团队、极客玩家

局域网内的所有开发者只需将工具的 API 端点指向 http://192.168.x.x:20128 即可共享一个智能网关。配置和 Provider 由团队统一管理，降低每个人单独配置的维护成本。

场景三：云服务器 / VPS

推荐方案：Docker + Nginx 反向代理 + 域名

server {
    listen 443 ssl;
    server_name 9router.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:20128;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

维度	评价
安装难度	⭐⭐⭐ 需云服务基础
延迟	⭐⭐⭐ 取决于服务器位置
持续运行	✅ 24/7
远程访问	✅ 随时随地
适合人群	远程办公、跨设备开发者

云服务器部署最大的优势是”随时可用”——无论你在家、在公司还是在咖啡厅，只要配置一次工具端点，就能获得一致的 AI 编程体验。

推荐选择低价轻量云服务器（如阿里云轻量应用服务器 ¥24/月，或腾讯云轻量 ¥28/月），运行 9Router 绰绰有余。

场景四：容器编排环境（K8s / Docker Swarm）

适合技术成熟的团队或容器化重度用户。9Router 无状态部署（数据挂载在持久卷），可以水平扩展，但单实例已能满足绝大多数场景。

关于数据目录的特别提醒

无论选择哪种部署方式，9Router 的数据目录都非常重要——它存储了你的 Provider 配置、API Key、配额记录和日志。

默认位置：

Linux / macOS：~/.9router/
Windows：%APPDATA%/9router/

如需自定义：

1 2	export DATA_DIR=/mnt/ssd/9router-data 9router

建议：

将数据目录放在 SSD 上，因为 9Router 频繁读写配额和日志
如果使用 Docker，务必 -v 映射到宿主机持久目录
云服务器部署时，考虑将数据目录挂载到云盘做自动备份

一句话总结

场景	推荐方案	核心原因
个人开发者	npm 全局安装	简单，延迟最低
小团队	局域网 Docker	配置共享，持续运行
远程办公 / 跨设备	云服务器 + Nginx	随时随地访问
技术团队	Docker / K8s	弹性扩展，高可用

配置你的第一个 Provider

启动 9Router 后打开 http://localhost:20128，可以看到清晰的仪表盘。按以下步骤快速上手：

第一步：连接免费 Provider

在 Providers 页面，推荐优先连接以下免费或零门槛提供商：

Kiro AI — 无需注册，内置 Claude 4.5 / GLM-5 / MiniMax，无限免费
OpenCode Free — 无需认证，自动获取模型列表，无限免费
Vertex AI — 需 Google Cloud 账号，获赠 $300 免费额度
iFlow — 社区维护的免费模型集合
NVIDIA NIM — NVIDIA 提供的免费推理 API

第二步：配置三级回退

在 Combo 页面创建组合路由策略，这是 9Router 最强大的功能之一：

Combo: "unbreakable-coding"
  Tier 1 → claude/claude-sonnet-4     (你的订阅，效果最好)
  Tier 2 → glm/glm-4.7                (低价备选，$0.6/1M tokens)
  Tier 3 → kr/kiro-claude-sonnet      (免费兜底，无限免费用)

配置完成后，你的编码流程变成：

正常时使用订阅的 Claude（效果最好）
订阅额度用完后自动切换到低价模型（成本很低）
低价模型也用完？免费模型无缝接上（永不中断）

第三步：配置你的 AI 编程工具

Claude Code / Codex / OpenClaw 等工具只需修改两个参数：

1
2
3

# 设置 API 端点
export OPENAI_BASE_URL=http://localhost:20128/v1
export OPENAI_API_KEY=<从仪表盘复制>

值得推荐的免费模型资源

除了 9Router 内置的免费 Provider，以下资源也值得关注：

提供商	免费额度	可用模型	获取方式
Kiro AI	无限免费	Claude 4.5 / GLM-5 / MiniMax	9Router 内置，零配置
OpenCode Free	无限免费	各种开源模型	9Router 内置，零配置
iFlow	免费	社区模型合集	9Router 内置
NVIDIA NIM	免费	Llama / Mistral 等	注册 NVIDIA 账号
Vertex AI	$300 赠金	Gemini 3 Pro / DeepSeek	Google Cloud 账号
Groq	免费	Llama 3 / Mixtral	API Key 注册
DeepSeek	100 万 Tokens	DeepSeek-V3 / R1	新用户注册赠送
Cloudflare AI	免费	多种模型	Cloudflare 账号
Google Gemini	免费层	Gemini Flash / Pro	Google AI Studio

提示：9Router 自动支持多账户轮询，如果你有多个免费账户，可以全部添加进去，进一步增加可用额度。

推荐组合：免费用户的最佳实践

如果你的预算为 0，可以这样配置：

Combo: "zero-cost-coding"
  Tier 1 → kr/kiro-claude-sonnet     (主用，无限免费)
  Tier 2 → nvidia/nemotron            (备用，NVIDIA 免费)
  Tier 3 → opencode/auto              (兜底，自动选择可用模型)