ghcr.io/diegosouzapw/omniroute:3.8.20

🚀 OmniRoute — 免费AI网关

永不停歇地编码。通过一个端点，将所有AI工具连接到231个提供商——其中50+个免费。

将Claude Code、Codex、Cursor、Cline、Copilot和Antigravity接入免费的Claude / GPT / Gemini。自动回退。

RTK + Caveman压缩节省15–95%的tokens。永不触达限制。

约16亿文档化免费tokens/月——首次注册可获得额外credits，首月最高可达约21亿——汇总所有免费层级，加上大量永久免费、无上限的提供商，再加上上述压缩技术，让每个token都更耐用。(我们如何计算 →)

💬 加入社区

🚀 快速开始 • 🎯 Combos • 🌐 提供商 • 🔌 CLI & MCP • 🗜️ 压缩 • 🌍 网站

💥 承诺 • 🤔 为什么选择OmniRoute • 🏆 优势所在 • 🤖 兼容CLI • 🖥️ 运行环境 • 🔒 隐私保护 • 🎬 实际应用 • 📚 探索更多 • 📧 支持

🌐 支持40+种语言

🇺🇸 🇧🇷 🇪🇸 🇫🇷 🇮🇹 🇷🇺 🇨🇳 🇩🇪 🇯🇵 🇰🇷 🇮🇳

🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭 🇸🇦 🇮🇱 🇦🇿 🇺🇦 🇵🇱 🇨🇿

🇳🇱 🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇭🇺 🇷🇴 🇸🇰 🇵🇹

💰 约16亿免费Tokens/月

手动叠加免费层级非常痛苦——数十个SDK、数十个速率限制，而且不知道实际拥有多少额度。OmniRoute将40+提供商池/500+模型的文档化免费层级汇总为一个真实数字，并在仪表板（/dashboard/free-tiers）上实时显示。

• 约16亿免费tokens/月（稳定）——首次注册可获得额外credits，首月最高可达约21亿。
• 池去重，真实可信——每个共享免费池我们只计算一次，因此标题不会像竞争对手那样通过速率限制上限来夸大数十亿的数字。（如果24/7计算每个速率限制，会显示约100亿；我们不发布这个数字。）
• 加上不可计数的部分——永久免费、无token上限的提供商（SiliconFlow、Z.AI GLM-Flash、Kilo、OpenCode Zen……）以及10*OpenRouter充值可解锁+2400万/月**，这两部分单独显示，因此不会夸大标题数字。
• 按模型细分、当月实时已使用/剩余额度，以及每个提供商的透明条款标记。

预览模拟图——/dashboard/free-tiers页面验证后将提供真实截图。完整方法（池去重、信用层级、提供商条款）：docs/reference/FREE_TIERS.md。

💥 承诺

一个端点。231个提供商。 永不停歇地构建——让OmniRoute选择最便宜且有效的那个。

• 🚫 永不触达限制 毫秒级在231个提供商之间自动回退。配额用完？下一个提供商接管——零停机时间。

• 💸 节省高达95%的tokens RTK + Caveman叠加压缩减少15–95%的合格tokens（在工具密集型会话中平均约89%）。

• 🆓 零成本开始 50+个提供商提供免费层级，11个永久免费（Kiro、Qoder、Pollinations、LongCat……）。无需***。

• 🔌 所有工具兼容 16+个编码代理——Claude Code、Codex、Cursor、Cline、Copilot、Antigravity——通过一个配置即可使用。

• 🧩 一个端点 OpenAI ↔ Claude ↔ Gemini ↔ Responses API转换。将任何工具指向/v1即可正常工作。

• 🛡️ 生产级 断路器、TLS隐身、MCP（87个工具）、A2A、内存、护栏、评估。14,965项测试。

🤔 为什么选择OmniRoute？

停止在10个仪表板、失效的API密钥和意外账单之间周旋。

┌──────────────────────────────────────────────────────────┐
│ 你的IDE / CLI（Claude Code、Cursor、Cline…） │
└─────────────────────────┬──────────────────────────────────┘
│ http://localhost:20128/v1
▼
┌──────────────────────────────────────────────────────────┐
│ OmniRoute — 智能路由器 │
│ RTK + Caveman压缩 · 15种路由策略 │
│ 断路器 · TLS隐身 · MCP · A2A · 护栏 │
└─────────────────────────┬──────────────────────────────────┘
┌─────────────┬────┴────────┬─────────────┐
▼ 层级1 ▼ 层级2 ▼ 层级3 ▼ 层级4
订阅版 API密钥 低成本 免费版
Claude Code、DeepSeek、GLM $0.5、Kiro、Qoder、
Codex、Copilot Groq、xAI MiniMax $0.2 Pollinations
配额用尽？ ───▶ 预算超支？ ─▶ 预算超支？ ─▶ 始终可用

🎯 Combos — 旗舰功能

combo是OmniRoute自动路由的一系列模型链。当配额用尽、提供商故障或成本飙升时，combo会静默切换到下一个模型。这就是OmniRoute不可中断的原因。 🛡️

⚡ 零配置——只需使用auto

无需创建combo。将模型设置为auto（或其变体），OmniRoute会从已连接的提供商中构建虚拟combo，并实时评分：

🔀 或构建自己的——15种路由策略

🧱 内置弹性（3个独立层）

Combo: "always-on" Strategy: priority
1. cc/claude-opus-4-7 ← subscription (use it fully)
2. cx/gpt-5.5 ← second subscription
3. glm/glm-5.1 ← cheap backup ($0.5/1M)
4. kr/claude-sonnet-4.5 ← FREE, unlimited (never fails)
Result: 4 layers of fallback = zero downtime

📖 Auto-Combo 引擎 · 弹性指南

🔌 完整 CLI + A2A 与 MCP

OmniRoute 不只是一个服务器——它是一个完整的命令行控制台，拥有60+ 命令，并支持开放代理协议，使 AI 代理能够自主操作 OmniRoute。

⌨️ 真正的 CLI（不只是 start）

omniroute # 启动网关 + 仪表盘（端口 20128）
omniroute chat # 交互式 TUI 聊天客户端（命令：/model /combo /skill /memory）
omniroute setup # 引导式首次运行向导
omniroute doctor # 诊断提供程序、端口、原生依赖

🛰️ 远程模式——在此处运行 CLI，OmniRoute 在 VPS 上

在服务器上运行 OmniRoute？使用相同的 CLI 从笔记本电脑控制它。使用范围访问令牌登录一次；之后每个命令都指向远程服务器。

omniroute connect 192.168.0.15 # 密码 → 范围令牌，保存为上下文
omniroute models list # ← 针对远程服务器运行
omniroute configure codex # ← 选择远程模型，编写本地 Codex 配置文件
omniroute tokens create --name ci --scope read # 为其他机器生成更窄范围的令牌
omniroute contexts use default # ← 切换回本地服务器

令牌的范围包括 read / write / admin；进程生成路由仅保留环回。
📖 远程模式

providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

🤝 连接代理——让它自主控制 OmniRoute

通过MCP 或 A2A 公开 OmniRoute，任何有能力的代理都能获得整个网关的控制权——路由、提供程序、组合、缓存、压缩、内存——实现自主操作。

# 通过 MCP 向 Claude Code 提供完整的 OmniRoute 工具集：
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

📖 MCP 服务器 · A2A 服务器 · 代理协议

📦 更多安装方式 — Docker、源码、pnpm、Arch

🐳 Docker

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

🛠️ 从源码安装

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm install -g omniroute && pnpm approve-builds -g && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# 使用 Nix flakes
nix develop
npm run dev

# 或使用 devbox
devbox run npm run dev

📖 Docker 指南 — Compose 配置文件、Caddy HTTPS、Cloudflare 隧道。

🦭 Podman

# 1. 构建镜像
podman build --target runner-base -t omniroute:base .

# 2. 为无 root 权限的 Podman 修复数据目录权限
mkdir -p data && podman unshare chown 1000:1000 ./data

# 3. 在 .env 中设置运行时，然后运行（Quadlet 配置见 contrib/podman/）
echo "CONTAINER_HOST=podman"
>> .env
podman compose --profile base up -d

📖 Podman 指南 — Quadlet 配置、podman-compose、Quadlet。

嵌入式服务： 本地边车服务（CLIProxy、NineRouter）的一键安装与生命周期管理。

质量与运维： 内置 Evals（黄金数据集：精确匹配/包含/正则表达式/自定义）· 安全护栏（PII、注入***、视觉内容）· 健康仪表盘 · p50/p95/p99 遥测数据 · Webhook · 合规审计。

🤖 协议与API

📋 项目与质量

⭐ 主要贡献者

OmniRoute由充满热情的开源社区共同塑造。这些贡献者的杰出工作直接影响了项目的质量、稳定性和影响力。感谢你们。

oyi77

🥇 190次提交 • +72K行代码
分析引擎、SQL聚合、代理市场、测试覆盖率

Chris Staley

🥈 72次提交 • +5.7K行代码
SSE流强化、响应API、Gemini分页、测试回归修复

zenobit

🥉 62次提交 • +24K行代码
CI/CD流水线、33种语言的i18n支持、Void Linux包、平台修复

R.D. & Randi

🏅 107次提交 • +28K行代码
端点页面、隧道集成、Docker工作流、A2A状态、压缩UI

benzntech

🏅 20次提交 • +7.5K行代码
Electron桌面应用、自动更新器、发布构建工作流、跨平台CI

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

---

👥 贡献者

如何贡献

1. Fork本仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

详细指南参见CONTRIBUTING.md。

发布新版本

# 创建发布 — npm publish会自动执行
gh release create v3.8.2 --title "v3.8.2" --generate-notes

📊 Stars

🌍 StarMapper

🙏 致谢

OmniRoute站在巨人的肩膀上。它最初是https://github.com/decolua/9router 的分支，以及Go项目https://github.com/router-for-me/CLIProxyAPI 的TypeScript移植版——从那时起，以下每个子系统都受到了先行开源项目的启发。每个项目都塑造了OmniRoute的具体部分。这是我们对所有这些项目的感谢。🙏

⭐ 星标数量截至2026年6月 — 请给这些项目点个星吧。

🧬 起源与网关

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