9Router for fnOS

9Router 免费 AI 路由器的飞牛 NAS (fnOS) 应用包。连接 Claude Code / Codex / Cursor 等工具到 40+ 免费 AI 提供商，RTK 节省 20-40% token，自动 fallback 不中断。

9Router for fnOS 将 decolua/9router 打包为 fnOS 桌面应用，开箱即用。

• English README

✨ 功能亮点

• 一个端点连所有 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 页控制是否显示在「使用情况画布」
• MiMo Code Free 默认显示：mimo-free 默认在「使用情况画布」显示（不再只一个大 OpenCode 图标），仍可通过 Provider 页开关隐藏/显示
• 无连接时不暴露全部内置模型：数据库健康但未配置任何 provider 连接时，/v1/models 只返回你显式添加的自定义模型（如 oc/*-free），不会把 ~680 个内置模型全部抛给 OpenCode/Cursor 等客户端（上游 PR #3267）

🚀 快速安装

1. 从 Releases 下载 9router-x.x.x.fpk
2. 飞牛 App Center → 手动安装 → 选择 fpk
3. 桌面出现 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 免费模型）后即可使用。

端口与数据

🌐 浏览器直接访问

iframe 版（桌面内嵌）除了在桌面打开，也可以用浏览器直接访问，效果与桌面窗口一致：

💡 完整体验推荐用电脑/手机浏览器直接访问上述地址。

登录说明

本应用默认开启登录（requireLogin=true，源码构建默认），首次登录使用初始密码 123456（v0.5.52 起已统一，与登录页默认一致）。API 调用仍受 API Key 保护。

⚠️ 飞牛移动 App 限制

飞牛移动 App（iOS/Android）用 WebView iframe 打开所有应用，存在限制：

• 无法登录：登录 cookie（SameSite=lax）无法在容器内保存，会反复跳回登录页。如确需在移动 App 容器内使用，可在 Profile → Settings 关闭「Require Login」规避（登录页可关闭）
• UI 持久化有限：localStorage / 主题切换在容器内可能不生效（货币功能已合入源码，随构建生效，非运行时补丁）

💡 完整体验请用电脑浏览器或手机浏览器直接访问，见上方「🌐 浏览器直接访问」（内网 http://<NAS-IP>:20128 / 外网 http://9route.<fnid>.fnos.net/）。

🔧 本项目增强

相比上游 decolua/9router，本包基于源码额外提供（均已提上游 PR）：

这些增强从源码编译进包（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 节省算法优化

📚 相关项目

• decolua/9router — 上游开源项目
• Hermes WebUI · MetaCubeXD · Strava Panel — 更多 fnOS 应用
• fnOS 开发者文档

License

MIT — 与 decolua/9router 一致