大家好,我是苍一,一个干了13年的后端开发,正在探索AI编程,从产品到开发的全生命周期最佳实践,如果您感兴趣,欢迎关注👇,看我如何自我革命。
项目定位
9Router 是一个开源的本地模型路由管理平台,作用类似于 OpenRouter 的私有化版本,但功能覆盖面更广。它把主流大模型供应商和编码代理工具集成到同一个 Web 界面里,省去在各个客户端反复配置 API Key 的麻烦。
项目地址:https://github.com/decolua/9router
快速部署
1️⃣ 前置条件
你需要一台能正常运行的开发机,以及一个已经配置好 API 的编码代理(比如 Kimi Code、Cursor 或 OpenCode)。整个部署过程不需要手动克隆仓库或执行构建命令,交给代理完成即可。
2️⃣ 安装步骤
先在本地创建一个空的目录,命名为 9Router。然后用你现有的编码代理打开这个空目录,把 GitHub 仓库地址喂给它。代理会自动拉取代码、安装依赖、启动服务。整个过程大约十来分钟。
启动成功后,终端会返回一个本地地址,格式类似 http://localhost:20128/login。用浏览器打开,登录密码在项目根目录的 .env 文件里,可以自行修改。
服务持久化有两种方式:直接用代理生成 systemd 服务配置,或者走 Docker 容器。按个人习惯选择。
免费模型接入
3️⃣ 启用 OpenCode Free
登录后台后,左侧导航栏第二项是 Providers(供应商管理)页面。列表中能看到 OpenCode Free 供应商,如果状态显示绿色 "Ready",说明免费额度可用。
点击进入 OpenCode Free 的详情,找到 oc/deepseek-v4-flash-free 模型,点击右侧的加号将其激活。这个模型不消耗任何费用,适合日常轻量使用。
4️⃣ 绑定到编码代理
切换到左侧的 CLI Tools 页面,选择你常用的代理工具。以 Hermes Agent 为例,点击它展开配置面板,在 Default Model 一栏点击 Select 按钮,从列表中选择刚才激活的 deepseek-v4-flash-free,然后点击 Apply。如果配置页面顶部出现绿色提示条,说明绑定成功。
回到代理工具里,随便发一条消息验证一下模型是否生效即可。
接入第三方模型供应商
除了免费额度,你也可以接入自己有 API Key 的供应商。9Router 目前支持 Kimi、OpenAI、Anthropic、DeepSeek 等主流平台,后续还在持续增加。
5️⃣ 添加 Kimi 模型为例
进入 Providers 页面,找到 Kimi 供应商,点击 Add Connection。把你的 API Key 粘贴进去,Name 栏随意填写一个标识名,点击 Save。回到列表页,Connections 列显示绿色 Active 状态即表示连接正常。
然后在 CLI Tools 里选择对应的代理工具(比如 OpenCode),点击 Add Model,从下拉列表中选 Kimi K2.6。Subagent Model 同样选 Kimi K2.6,点击 Apply 完成配置。打开 OpenCode 验证,确认模型名称显示为 9Router 提供的 kimi/kimi-k2.6 就没问题了。
Combo 模型降级策略
9Router 提供了一个 Combo 功能,本质上就是模型降级链。你可以把多个模型编成一组,排在最前面的作为首选,如果调用失败,系统会自动 fallback 到后面的模型。
使用方式很简单,在 CLI Tools 的代理配置里添加 Combo 模型即可,调用方式跟普通模型没有区别。这个功能在免费额度有限或某家供应商偶尔不稳定时比较实用。
其他供应商类型
除了文本大模型,9Router 还列出了图片生成、语音合成、文本嵌入(Embedding)、Web 搜索等类型的供应商。覆盖面已经比较全面,目前只差视频生成这一块没有纳入。
MITM 路由劫持
对于 GitHub Copilot、Antigravity、Kiro 这类不开放自定义 API 端点的代理工具,9Router 支持通过 MITM(中间人代理)方式拦截请求,强制流量走 9Router 路由。这个功能配置相对复杂,需要根据具体工具调整,建议直接让帮你部署 9Router 的代理来处理。
用量监控
左侧导航的 Usage 页面可以查看各模型的调用量统计,方便掌握免费额度的消耗情况和付费模型的花费。
小结
9Router 解决的核心问题是模型管理的碎片化。不管你用几个代理工具、对接几家模型供应商,都可以在一个面板里完成所有配置和切换。免费模型的接入门槛极低,几分钟就能跑起来。对于同时使用多款编码代理的开发者来说,值得一试。
项目地址:https://github.com/decolua/9router
如果嫌文章太长、怕后面走丢,可以关注下面的ima知识号,让这篇文章成为你的知识顾问,随时随地等候你的提问。
知识号中内容会以笔记形式分享,可以根据大家反馈和实测情况,实时更新,保证最新方案的稳定、可用。
【ima 知识库】

夜雨聆风