9Router for fnOS
9Router 免费 AI 路由器的飞牛 NAS (fnOS) 应用包。连接 Claude Code / Codex / Cursor 等工具到 40+ 免费 AI 提供商，RTK 节省 20-40% token，自动 fallback 不中断。
9Router for fnOS 将 decolua/9router 打包为 fnOS 桌面应用，开箱即用。
✨ 功能亮点
- 一个端点连所有 AI：Claude Code、Codex、Cursor、Cline 等工具指向
http://<NAS-IP>:20128/v1 即接入 40+ 免费提供商
- 自动 fallback：某个提供商限流/故障时自动切换，不中断编码
- RTK Token 节省：减少 20-40% token 消耗
- 多币种成本显示：成本/定价按界面语言显示本地货币（¥/NT$/¥/₩/₫），可在 Profile 开关切换
- 配额包按连接独立：同一提供商配多个连接时，各连接的配额包（如 Bonus Pack）独立显示与隐藏
- 免费供应商可开关：noAuth 免费供应商（opencode、MiMo）可在 Provider 页控制是否显示在「使用情况画布」
🚀 快速安装
- 从 Releases 下载
9router-x.x.x.fpk （论坛附件📎限制大小）
- 飞牛 App Center → 手动安装 → 选择 fpk
- 桌面出现 9Router 图标，点击打开 Dashboard
📖 使用说明
接入 AI 工具
# CLI 工具（Claude Code / Codex / Cursor / Cline 等）指向 9Router 端点
# Base URL: http://<NAS-IP>:20128/v1
# API Key: 在 9Router Dashboard → Endpoint & Key 获取
Dashboard 里配置 AI 提供商（如 Kiro AI 免费模型）后即可使用。
端口与数据
| 项 |
值 |
| 端口 |
20128 |
| 数据目录 |
/vol4/@appdata/9router/ |
| Node 运行时 |
fnOS App Center nodejs_v24 |
登录说明
本应用默认关闭登录（requireLogin=false），适配飞牛移动 App 容器。API 调用仍受 API Key 保护。
⚠️ 飞牛移动 App 限制
飞牛移动 App（iOS/Android）用 WebView iframe 打开所有应用，存在限制：
- 无法登录：登录 cookie（
SameSite=lax）无法在容器内保存，会反复跳回登录页（本应用已关闭登录规避）
- UI 持久化有限：
localStorage / 主题切换 / 货币补丁（¥）在容器内可能不生效
💡 完整体验请用电脑浏览器或手机浏览器直接访问 http://<NAS-IP>:20128。
🔧 本项目增强
相比上游 decolua/9router，本包基于源码额外提供（均已提上游 PR）：
| 增强 |
说明 |
上游 PR |
| 多币种成本显示 |
成本/定价按界面语言显示本地货币：中文 ¥、** NT$、日本 ¥、韩国 ₩、越南 ₫，Profile 开关切换 |
#3118 |
| 配额包按连接独立 |
同一提供商（如 CodeBuddy CN）配多个连接时，各连接的配额包独立显示/隐藏 |
#3122 |
| 免费供应商拓扑开关 |
noAuth 免费供应商（opencode、MiMo）可在 Provider 页开关是否显示在「使用情况画布」 |
#3123 |
| Cloudflare 修复 |
修复 Cloudflare 卡片误显示"无连接"（已随上游 v0.5.50 包含） |
#2993 |
这些增强从源码编译进包（NEXT_DIST_DIR=.next-cli-build npm run build），构建流程见下方「从源码构建」。
📸 效果图
各增强的实际效果图（来自上游 PR 评论），见 docs/SCREENSHOTS.md。
🛠️ 从源码构建
面向开发者。普通用户直接用 Release 即可。本包基于源码构建（含货币/配额/拓扑增强），而非从 npm 包提取。
git clone https://github.com/techysy/9router-fnos.git
# 需要 9Router 源码（含增强补丁分支）：
git clone https://github.com/techysy/9router.git 9router-src
cd 9router-src
npm install
NEXT_DIST_DIR=.next-cli-build npm run build # 生成 standalone
# 组装 app/server（把 .next-cli-build/standalone 内容 + custom-server.js 放入 9router-fnos/app/server）
# 构建 fpk（需在飞牛 NAS 上执行）
fnpack build
🐛 问题排查
构建/安装/运行的常见问题与修复，见 TROUBLESHOOTING.md
🔮 迭代计划
等待上游 decolua/9router 发布新版本后重新打包：
- 跟进上游版本更新
- 上游新增模型自动同步到 Dashboard
- RTK token 节省算法优化
📚 相关项目
License
MIT — 与 decolua/9router 一致
