🚀 OmniRoute — 免费的 AI 网关

🛠️ 技术栈

层级	技术
运行时	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
语言	TypeScript 6.0 — `src/` 和 `open-sse/` 中100% TypeScript（v2.0 以来核心代码中无 `any`）
框架	Next.js 16 + React 19 + Tailwind CSS 4
数据库	better-sqlite3 (SQLite, WAL 日志) + LowDB (JSON 遗留) — 122 个领域模块，183 次迁移
内存	SQLite FTS5 全文搜索 + int8 量化向量嵌入，类型衰减
模式	Zod 4 — MCP 工具 I/O 验证 + API 契约
协议	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
流式传输	Server-Sent Events (SSE) + WebSocket 桥接 (`/v1/ws`)
压缩	12 引擎管道 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
认证与安全	OAuth 2.0 (PKCE) + JWT + API 密钥 + MCP 范围授权 · 静态 AES-256-GCM · DOMPurify
隐身	wreq-js — JA3 / JA4 TLS 指纹伪装，3 级代理
弹性	断路器，指数退避，防群集效应，自动组合自愈
日志	pino — 带有请求上下文的结构化 JSON 日志
测试	Node.js 测试运行器 + Vitest — 跨 5,100+ 个跟踪测试文件（单元、集成、E2E、安全、生态系统）的 39,000+ 静态测试声明
平台	桌面 (Electron) · Android (Termux) · PWA (任意浏览器)
CI/CD	GitHub Actions — 发布时自动 npm 发布 + Docker Hub
链接	网站 · npm · Docker Hub

📖 文档

📘 入门指南

文档	说明
用户指南	提供者、组合、CLI 集成、部署
设置指南	完整安装方法、CLI 工具配置、协议设置、超时调优
CLI 工具指南	Claude Code、Codex、Cursor、Cline、OpenClaw、Kilo、Copilot 的逐工具设置
远程模式	通过限定范围的访问令牌，从笔记本电脑上的 CLI 操控远程 OmniRoute（VPS）
Claude Code 配置	使用 `launch` 和各模型配置文件，将 Claude Code 指向 OmniRoute（本地/远程）
快速开始	3 步完成安装 → 连接 → 配置

🔧 运维与部署

文档	说明
Docker 指南	Docker 运行、Compose 配置文件、Caddy HTTPS、隧道、镜像标签
Podman 指南	Quadlet systemd 集成、podman-compose、SELinux
虚拟机部署	完整指南：虚拟机 + nginx + Cloudflare 设置
Fly.io 部署	使用持久化存储部署到 Fly.io
Termux 指南	通过 Termux 在 Android 上运行 OmniRoute
PWA 指南	渐进式 Web 应用安装、缓存、架构
卸载指南	彻底移除所有安装方式所安装的内容
环境配置	完整的 `.env` 变量和参考说明

🧠 功能与架构

文档	说明
架构	系统架构、数据流和内部机制
压缩指南	7 选项管道：关闭 / 轻量 / 标准 / 激进 / 超强 / RTK / 堆叠
RTK 压缩	命令输出压缩、过滤器、信任、验证、原始输出恢复
压缩引擎	Caveman、RTK、堆叠管道、仪表板/API/MCP 接口
压缩规则格式	适用于 Caveman 和 RTK 过滤器的 JSON 规则包模式
压缩语言包	语言检测和 Caveman 规则包编写
弹性指南	熔断器、冷却时间、队列、防惊群、TLS 欺骗
自动组合引擎	16 因素评分、模式包、自愈
代理指南	3 级代理系统、1proxy 市场、注册表 CRUD
免费套餐	汇总目录：35 个有文档记录的周期性资源池 / 489 个已编入目录的免费套餐条目
功能展示	带截图的可视化仪表板导览
代码库文档	适合初学者的代码库导览

🤖 协议与 API

文档	说明
API 参考	所有端点及其示例
OpenAPI 规范	OpenAPI 3.0 规范
MCP 服务器	110 个 MCP 工具、IDE 配置、Python/TS/Go 客户端
MCP 服务器指南	MCP 安装、传输方式和工具参考
A2A 服务器	JSON-RPC 2.0 协议、技能、流式传输、任务管理
A2A 服务器指南	A2A 智能体卡片、任务、技能和流式传输

📋 项目与质量

文档	说明
贡献指南	开发环境设置与准则
分支与发布模型	PR 的目标分支（`release/*`），以及 `main` 和标签的含义
变更日志	完整的逐版本发布历史
安全策略	漏洞报告与安全实践
i18n 指南	42 种语言支持、翻译工作流和 RTL
发布检查清单	发布前验证步骤
覆盖率计划	针对 5,100 多个已跟踪测试文件中 39,000 多项静态测试声明的测试覆盖率策略

⭐ 顶尖贡献者

OmniRoute 由一个充满热情的开源社区共同塑造。以下贡献者做出了卓越贡献，直接影响了项目的质量、稳定性和影响范围。感谢你们。

按已合并拉取请求数量排名的外部贡献者

排名	贡献者	已合并 PR	约变更行数
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{数据冻结于实时 release/v3.8.50 分支的最新提交 dafb4ae808，统计截至 2026-08-24 05:26:03 UTC 的合并记录。分页的 GitHub GraphQL 全量统计包含 5,911 个已合并 PR：其中 2,707 个来自仓库所有者，179 个来自 Dependabot，3,025 个外部 PR 来自 535 位不同的贡献者。“变更行数”是 GitHub 中新增行数与删除行数之和，包含生成的文件、锁文件、目录、翻译和文档；它衡量的是代码变动量，而非作者编写的代码行数。达到截止排名时的并列项均予保留。}

GitHub 归属的提交

backryun _{🥇 220 次归属于 GitHub 用户的提交}	Paijo _{🥈 219 次归属于 GitHub 用户的提交}	Randi _{🥉 108 次归属于 GitHub 用户的提交}	Ravi Tharuma _{🏅 81 次归属于 GitHub 用户的提交}	Chris _{🏅 70 次归属于 GitHub 用户的提交}	Markus Hartung _{🏅 69 次归属于 GitHub 用户的提交 · 并列第 6 名}
Dizzle _{🏅 69 次归属于 GitHub 用户的提交 · 并列第 6 名}	Jan Leon _{🏅 64 次归属于 GitHub 用户的提交}	zenobit _{🏅 62 次归属于 GitHub 用户的提交}	Bob.Hou _{🏅 51 次归属于 GitHub 用户的提交 · 并列第 10 名}	Xiangzhe _{🏅 51 次归属于 GitHub 用户的提交 · 并列第 10 名}

_{于 2026-08-24 06:14:31 UTC 重新核查：由仓库 Contributors API 报告的默认分支 release/v3.8.50 中归属于 GitHub 用户的提交。该 API 返回了 525 个身份（415 名用户、2 个机器人、108 个匿名身份）；此表不包含维护者、机器人和匿名身份，并保留并列排名。此排名不同于上方的已合并 PR 排名，也不同于下方基于 Git 元数据统计的 639 人名录。}

🙏 这些贡献者提供的功能、错误修复和基础设施改进，是 OmniRoute 可靠且功能丰富的核心组成部分。每个拉取请求、每个测试用例以及每个 i18n 翻译文件都至关重要。开源软件正是由他们这样的人共同构建的。

💖 赞助者

衷心感谢那些自掏腰包资助 OmniRoute 的人们——每一份贡献都让项目得以保持免费、独立并持续发展。

Andrew
_{💛 活跃的每月赞助者}

Vlad I
_{💛 活跃的每月赞助者}

Paco Cartones
_{💛 活跃的一次性赞助者}

Prof. Igor Morais
_{💛 过往的一次性支持者}

longtao
_{💛 过往的一次性支持者}

_{……以及其他希望保持匿名的支持者 💛}

_{公开的 GitHub Sponsors 信息已于 2026-08-24 重新验证。GitHub 的 activeOnly 状态决定了上方的活跃标签；此前已公开的一次性支持者仍保留在感谢名单中，而非公开赞助者则保持匿名。}

💖 成为赞助者 →——每一美元都能帮助 OmniRoute 保持免费和独立。

👥 600+ 位贡献者

_{已于 2026-08-24 在冻结基准 ac02c5b42f 上完成审计，并在实时 release/v3.8.50 分支最新提交 dafb4ae808 上重新检查：共有 639 个经过规范化的人类 Git 身份——其中 407 个以提交作者身份出现（包括维护者），另有 232 个仅出现在显式的 Co-authored-by 尾注中。统计过程对 GitHub noreply 用户名进行了规范化，排除了 26 个机器人、代理、服务或占位身份，并且不会仅因显示名称相同而合并普通电子邮件地址。}

如何贡献

Fork 仓库
从活跃的 release/vX.Y.Z 分支最新提交创建分支（而不是 main）——请参阅分支与发布模型
创建功能分支（git checkout -b feat/amazing-feature）
提交更改（git commit -m 'feat: add amazing feature'）
推送到该分支（git push origin feat/amazing-feature）
创建 Pull Request，并将基础分支设置为该 release/vX.Y.Z 分支

详细指南请参阅 CONTRIBUTING.md。

发布新版本

# 创建发布版本——npm publish 会自动执行
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 星标

🌍 StarMapper

🙏 致谢

OmniRoute 站在巨人的肩膀上。它最初是 9router 的一个分支，也是 Go 项目 CLIProxyAPI 的 TypeScript 移植版本——在此基础上，下面的每个子系统都受到了率先实现相关功能的开源项目的启发。它们都塑造了 OmniRoute 的具体组成部分。谨以此向所有这些项目致谢。🙏

⭐ 星标数已于 2026 年 8 月 24 日通过 GitHub 的 REST API 验证——也请为这些项目点亮星标。所列数量是特定日期的精确快照，自然会随时间发生变化。

🧬 项目传承与网关

项目	⭐	它如何启发 OmniRoute
9router	26,161	本分支所基于的原始项目——在此基础上扩展了多模态 API，并使用 TypeScript 进行了完整重写。
CLIProxyAPI	48,497	启发此 JavaScript / TypeScript 移植版本的 Go 实现。
LiteLLM	57,100	该 AI 网关的公开定价数据集为我们的成本跟踪同步提供数据，其提供者标准化模型也为我们的路由设计提供了参考。
codex-chatgpt-web	1,410	其 MIT 源代码被改造并整合到内置的 ChatGPT Web → Codex Responses 桥接器中，包括浏览器会话、响应组帧、用量统计和网页搜索适配器。
free-claude-code	48,112	其模式被移植到流恢复、无思考别名、后备网页搜索、滑动窗口限制、日志脱敏和经过强化的启动器流程中。
composer-api	322	Cursor Composer 的工具选择、输出约束和工具提交模式经改造后用于原生 Cursor 执行器。
codex-multi-auth	457	全新登录和刷新令牌轮换模式被移植到 Codex OAuth 重新认证中。
opencode-anthropic-auth	510	与 Claude Code 兼容的转换默认值和计费请求头行为被泛化到 OmniRoute 的配置驱动桥接器中。
grok2api-merged	2	其 Grok 模型映射、伪 TypeError Statsig 生成器、请求与设备默认值，以及 NDJSON 响应处理器均被实质性改造并用于 OmniRoute 的 Grok Web 执行器。
TQZHR/grok2api	705	grok2api-merged 背后的主要传递性代码来源；其模型、请求头、载荷、Statsig 和处理器实现均保留在 Grok Web 的代码谱系中。
chenyme/grok2api	7,520	这是 Grok 载荷与设备默认值、Statsig 生成器以及经由 TQZHR 和 grok2api-merged 传承的 `result.response` 处理器所基于的底层 MIT 源代码。
grok2api-pro	27	grok2api-merged 将其列为代理池层的传递性来源；OmniRoute 保留了该谱系声明，但并未声称在其范围受限的 Grok Web 执行器中移植了代理池。
GrokProxy	50	其基于 Cookie 认证的 Grok 代理和 `result.response.token` 流式传输模式为 OmniRoute 的 Grok Web 传输层提供了参考。
GrokBridge	5	最初的 Grok Web 实现参考了其 HTTP/浏览器上游设计；由于其直接 HTTP 路径源自 GrokProxy，因此不声称存在独立的代码移植。
grok-web-api	14	其 Rust `ChatOptions` 和响应信封模式为 OmniRoute 的 TypeScript Grok 请求与流式响应类型提供了参考。

🗜️ 上下文与令牌压缩——引擎

项目	⭐	它如何启发 OmniRoute
Caveman	100,538	爆火的“能用少量 token 搞定，何必用很多 token”项目——其穴居人式表达理念为我们的标准压缩模式以及 30 多条填充词移除/内容精简规则提供了基础。
RTK – Rust Token Killer	77,185	高性能命令输出压缩——启发了我们的 RTK 引擎、JSON 过滤器 DSL、原始输出恢复，以及堆叠式 RTK → Caveman 流水线。
headroom	67,310	可逆上下文压缩（SmartCrusher）——启发了我们的 `headroom` 引擎和 `ccr` 检索标记模式。
LLMLingua	6,598	提示词压缩研究（LLMLingua / LLMLingua-2）——启发了我们异步、代码安全、故障开放的 `llmlingua` 引擎。
llmlingua-2-js	31	JS/ONNX 移植版本（MobileBERT / XLM-RoBERTa），被用作我们 LLMLingua 引擎的工作线程后端。
Troglodita	40	巴西葡萄牙语 token 压缩——为我们的 pt-BR 语言包提供支持：针对巴西葡萄牙语语法优化的赘述精简和填充词移除。
ponytail	108,957	爆火的“懒惰资深开发者”YAGNI 编码技能——启发了我们的少写代码输出风格：通过引导采用最小可行改动来减少_生成的_代码（与 Caveman 简练文风相对应的输出维度方案）。
i-have-adhd	23,526	其行动优先、对 ADHD 友好的响应风格被改编为 OmniRoute 支持五种语言的简洁输出风格。

🧩 紧凑格式、token 研究与代码感知工具

项目	⭐	它如何启发 OmniRoute
TOON	25,233	面向 token 的对象表示法——其列式“表头加数据行”模型塑造了我们的表格压缩阶段。
GCF – Graph Compact Format	41	其紧凑图格式和通用配置设计为 OmniRoute 的表格压缩与 Headroom 编解码器格式提供了参考。
gcf-typescript	4	该 MIT TypeScript 实现被直接内嵌并扩展为 Headroom 通用配置编解码器。
token-optimizer-mcp	494	Brotli/SQLite 缓存 + 每会话上下文增量——启发了我们的 `session-dedup` 引擎。
token-savior	1,122	Bash 输出压缩 + MCP 配置——启发了我们的压缩退出准则和 MCP 工具清单精简机制。
token-saver	138	具备失败感知退出机制、针对不同文件类型的内容感知输出压缩——验证了我们按类型分派和未达到最小收益时跳过压缩的方案。
token-optimizer	1,951	“查找幽灵 token”——其卸载 + 可恢复句柄模式为我们的 CCR 卸载思路提供了参考。
TokenMizer	28	会话图 + 跨轮次行去重蓝图，为我们的 session-dedup 设计提供了参考。
OmniCompress	3	Rust 列式 JSON + 内容寻址检索 + 跨消息去重——验证了我们的 `headroom`/`ccr`/`session-dedup` 引擎设计，以及“压缩形式与位置无关”这一缓存稳定性不变量。
mcp-compressor	113	MCP 工具模式/描述压缩——为我们的 MCP 工具清单基数缩减方案提供了参考。
RepoMapper	197	Aider 风格的仓库映射排序——为我们的仓库映射/检索排序探索提供了参考。
quiet-shell-mcp	4	基于 MCP 的声明式 shell 输出精简——验证了我们的声明式 bash 输出压缩方案。
ts-morph	6,162	TypeScript Compiler API 工具包——启发了我们基于解析器的注释移除机制，该机制可保留字符串、模板和正则表达式字面量。

🧠 记忆与 RAG

项目	⭐	它如何启发 OmniRoute
Mem0	63,902	通用记忆层——其以代理作为写入/读取边界的模型塑造了我们的记忆架构。
Letta (MemGPT)	24,382	具有分层记忆的有状态智能体——启发了我们的上下文控制与恢复（CCR）分层模型。
WFGY	1,781	对 16 种反复出现的 RAG/LLM 故障模式进行分类的 ProblemMap 体系——构成了我们故障排除指南中的通用术语。

🛰️ 流量检查、MITM 与透明代理

项目	⭐	它如何启发 OmniRoute
llm-interceptor	66	对编码助手 ↔ LLM 流量进行 MITM 拦截/分析，为早期流量检查器的需求提供了参考。此前衍生的四个模块——SSE 合并、对话规范化、敏感信息遮蔽和请求头净化——已被基于公开协议标准、独立洁净室实现的版本取代。两个主机直通层面（`passthrough.ts` 和 `_internal/bypass.cjs`）仍是独立归类的 OmniRoute 内部实现；它们未作为此次替换的一部分进行重写。
ProxyBridge	5,995	按进程进行透明代理路由——启发了我们的崩溃安全型 MITM 拆除机制、套接字空闲超时、`/proc` 进程归因和 TPROXY 捕获。

📚 模型数据、可观测性与 UI

项目	⭐	它如何启发 OmniRoute
models.dev	6,555	开放的 AI 模型规格、定价和能力数据库——已原生同步到我们的模型目录中。
React Flow / xyflow	38,108	为我们的实时压缩工作室和组合/路由工作室提供支持的节点式图库。
LangGraph	40,314	LangGraph Studio 的实时工作流图可视化启发了我们工作室中的实时级联视图。
Langfuse	33,592	其追踪 → 跨度 → 生成的可观测性模型塑造了我们的压缩工作室瀑布图。
Kiali	3,631	Istio 服务网格可观测性——启发了路由/组合工作室中的断路器徽章和错误边可视化。
lobe-icons	2,428	用于在整个仪表板中呈现提供者图标的 AI/LLM 品牌标志。
flag-icons	12,354	提供 README 语言选择器所使用的 MIT 许可 SVG 旗帜图标。

🛡️ 安全性

项目	⭐	它如何启发 OmniRoute
awesome-secure-defaults	721	精心整理的默认安全库清单，为我们的安全选型提供指导（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）。

🧭 互补工具

项目	⭐	它如何启发 OmniRoute
ClawRouter	6,564	启发了请求去重、紧急零成本回退、可插拔的自动组合策略和多语言意图分类。
Antigravity-Manager	30,652	其账号感知的模型重映射、可执行文件路径验证和套餐标签行为，为 OmniRoute 的 Antigravity 运行时提供了参考。
vscode-antigravity-cockpit	4,817	其紧凑的配额重置倒计时格式启发了 OmniRoute 中相应的提供者限额显示。
AionUi	32,230	其 ACP 集成启发了 OmniRoute 对已安装 CLI 智能体的自动检测。
CodexBar	20,507	识别出了 Grok Build 配额接口；随后 OmniRoute 独立验证并修正了实时线上格式。