SRouter：自托管 AI 网关与模型路由器

30秒速读：编码工具各自接模型，额度、限流和账单散在各处最难管。本篇讲什么：讲清这款自托管网关的版本选择、安装卡点与必改设置，帮你用一个统一端点接多家模型。

本文介绍 SRouter——一个面向编码代理的自托管 AI 网关与模型路由器：它把约 60 家免费 AI 提供商、1200 多个模型收敛到一个统一的 OpenAI 兼容端点，自带提示词压缩、六种智能路由策略、多级自动回退，还能把多个模型”融合”起来协同作答。编码代理重度用户读完这篇，就知道怎么用它蹭免费额度、省 token、不断线。

软件信息表

版本选择：npx、npm、Docker、桌面端、源码

结论先行：先拿 npx 免安装验证十分钟；主力使用选桌面端（最省心，开箱即自动登录）或 Docker（放服务器长期跑）。

安装步骤（只讲关键卡点）

1. npx 方式直接跑 npx @baiibayu/srouter。卡点：Node 版本要 20.18.0 以上，版本不够先升级 Node，别在旧 Node 上硬跑。
2. 桌面端用户从托盘图标点”Open Dashboard”进控制台（本机 127.0.0.1:31415）。卡点：桌面端是自动登录不用设密码，别在登录页干等找密码。
3. Docker 部署：docker run -d --name srouter -p 20268:20268 -v srouter-data:/app/server/data ghcr.io/baiibayu/srouter:latest。卡点：数据卷 srouter-data:/app/server/data 别漏，漏了容器重启配置全丢。
4. 服务端（Docker / 一键脚本 / npm run dev）首次进 Dashboard 要建邮箱加密码账号。卡点：局域网或公网暴露时务必设强密码，只有桌面端才免密。
5. 把编码工具（Claude Code、Cursor、Windsurf、Cline、Codex、Copilot、Aider、OpenCode 等）的 API 地址指到网关的统一端点，开工。

装完先改的 4 个设置

• 路由策略（Dashboard → 路由）。默认 auto 之外还有 auto:fast（走 Groq 等极速上游）、auto:smart（走 Gemini 2.5 Pro、Codestral 等强模型）、auto:cheap（走免费与轻量层省额度），还能在 Dashboard 里自建命名回退链。体感差别：赶 deadline 切 fast，烧钱任务切 cheap，策略本身就是省钱。
• 提示词压缩（Dashboard → 压缩/过滤）。打开结构感知压缩。体感差别：git diff、大文件读取这类工具结果动不动几万 token，压缩后通常省 20–40%，上下文一下宽裕了。
• Fusion 融合（虚拟模型 fusion）。把难题发给 fusion，多个不同模型并行作答再由裁判模型合成最优解。体感差别：关键代码评审多了一层交叉验证，一次提问拿到的是”讨论过”的答案。
• 上游密钥管理（Dashboard → 提供商）。上游 Key 进库走 AES-256-GCM 加密，对外只暴露统一的 srouter- 开头 bearer。体感差别：客户端配置里再也看不到真实上游 Key，换 Key 不用逐个改客户端。

注意事项与常见问题

• “免费”是真的，但有限度。约 60 家免费提供商各有速率限制，auto:cheap 适合省钱、不适合赶工；重要任务记得给付费上游做一条回退链，别把生产流量全押在免费层。
• 桌面端和服务端登录不一样。桌面端本地自动登录无密码；Docker、一键脚本这类服务端安装必须设邮箱密码，挂到局域网或公网前先改强密码。
• 协议覆盖比看起来广。除 OpenAI 全套外，原生支持 Anthropic Messages、Gemini、Ollama 模拟和 Codex 的 /v1/responses，还内置 MCP 服务（/mcp），能直连 ChatGPT、Claude Desktop 和各类 MCP 客户端。
• 数据在本地 SQLite。模型目录会同步到本地库并用签名描述更新内容；换机器前备份好数据目录，迁移就是拷目录。

软件信息补充

版本对比与推荐

推荐结论：先用 npx 验证十分钟，主力选桌面端或 Docker；关键链路务必配一条付费回退，免费层只适合省钱，不适合赶工。

必改设置检查清单

1. 路由策略复核（Dashboard → 路由）：主力任务配一条付费回退链。体感差别：免费层限流时自动换路不断线，而不是整个任务卡住。
2. 数据目录备份（通用建议）：换机器前备份本地数据目录。体感差别：配置与密钥库一次拷走，换机不用从头配。
3. 暴露面检查（通用建议）：服务端挂到局域网或公网前务必设强密码。体感差别：桌面端免密只限本机，服务端不设密码等于把控制台敞开。

常见问题与排错补充

• 免费额度用完怎么办？切到付费回退链或换一条路由策略，别把生产流量全押在免费层；免费层适合省钱，不适合赶工。
• 换机器配置怎么迁？备份本地数据目录后拷到新机（通用建议，具体路径以官网为准），迁移就是拷目录。
• 桌面端与服务端登录为何不同？桌面端本机自动登录不用设密码；Docker、一键脚本这类服务端安装必须设邮箱密码，挂到局域网或公网前先改强密码。

排错先查这三处

• 服务端口是否在听：网关端口与桌面端 Dashboard 端口是否与客户端配置一致。
• 登录方式是否按桌面端、服务端区分：桌面端别在登录页干等找密码，服务端别漏设账号密码。
• 回退链是否配了付费上游：重要任务没有付费回退，免费层一限流就全停。

适合谁、不适合谁

一句话判断：适合编码代理重度用户（Claude Code、Cursor、Cline、Aider 这类天天烧 token 的），想一张网卡吃遍免费额度、用自动回退把”限流”变成”稍等”的个人开发者；不适合不想维护本地服务、需要厂商 SLA 承诺的企业场景——自托管的运维成本省不掉。

附：六种路由策略与端口速查

据 README 整理的独家对照表：

明确取舍：免费层、压缩、回退是 SRouter 的杀手锏；但免费不等于稳定，关键链路务必配一条付费回退，别把鸡蛋全放在免费篮子里。

开源地址

前往 GitHub 仓库

GitHub 国内访问较慢，如打不开可多刷新几次

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库