ghcr.io/diegosouzapw/omniroute:3.8.17

🚀 OmniRoute — 免费 AI 网关

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

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

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

~19 亿+ 已记录的免费 tokens/月——首次注册可获得额外 credits，首月最高可达 ~25 亿——汇总所有免费层级，上述压缩技术进一步延长每个 token 的使用。(我们如何计算 →)

💬 加入社区

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

💥 承诺 • 🤔 为什么选择 • 🏆 与众不同之处 • 🤖 兼容 CLI • 🖥️ 运行环境 • 🔒 隐私保护 • 🎬 实际应用 • 📚 探索更多 • 📧 支持

🌐 支持 40+ 种语言

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

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

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

🏆 OmniRoute 的独特优势

📊 与 LiteLLM、OpenRouter 和 Portkey 的详细对比 → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md

📦 更多安装方式 — 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)

# Using Nix flakes
nix develop
npm run dev

# Or using devbox
devbox run npm run dev

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

🦭 Podman

# 1. Build the image
podman build --target runner-base -t omniroute:base .

# 2. Fix data directory permissions for rootless Podman
mkdir -p data && podman unshare chown 1000:1000 ./data

# 3. Set runtime in .env, then run (see contrib/podman/ for Quadlet)
echo "CONTAINER_HOST=podman"
>> .env
podman compose --profile base up -d

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

✨ 完整功能列表 — 30+ 项功能（内存、评估、可观测性）

路由： 15种策略 · 任务感知智能路由 · 思考预算控制 · 通配符路由 · 系统提示注入。 兼容性： OpenAI ↔ Claude ↔ Gemini ↔ Responses API · 自动OAuth刷新（PKCE，8个提供商）· 多账户轮询 · Batch + Files API · 实时OpenAPI 3.0。 协议： MCP（87个工具，3种传输方式，30个作用域）· A2A（JSON-RPC 2.0，SSE，6项技能）· ACP · 云代理（Codex、Devin、Jules）。 插件： 自定义插件市场（系统配置的注册表URL，带防SSRF的获取）· 安装/启用/禁用 · Notion + Obsidian知识库集成（WebDAV文件服务器、知识库搜索、笔记CRUD）。 嵌入式服务： 本地边车服务（CLIProxy、NineRouter）的一键安装和生命周期管理。 质量与运维： 内置Evals（黄金集合：精确匹配/包含/正则表达式/自定义）· 安全护栏（PII、注入、视觉）· 健康仪表板 · p50/p95/p99遥测数据 · Webhook · 合规审计。 AI代理技能： 即插即用的Markdown清单 — 将任何代理指向skills/*/SKILL.md清单。现有43项技能。

📖 MCP服务器 · A2A服务器 · 弹性指南 · 功能展示

📖 安装设置、环境变量与常见问题

OmniRoute会向我收费吗？ 不会 — 它是运行在您机器上的免费开源软件。您只需直接向付费提供商付费。OmniRoute没有计费系统。 免费提供商真的是无限使用吗？ 是的 — Kiro、Qoder、Pollinations、LongCat、Cloudflare。没有隐藏条款。 压缩会影响质量吗？ 不会 — 它只压缩输入内容；代码、URL、JSON始终受保护。 在AI被封锁的地区能使用吗？ 是的 — 3级代理 + 1proxy市场可连接所有177个提供商。

📖 用户指南 · API参考 · 环境配置

🤖 协议与API

📋 项目与质量

⭐ 主要贡献者

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

oyi77

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

Chris Staley

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

zenobit

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

R.D. & Randi

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

benzntech

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

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

---

👥 贡献者

如何贡献

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

🙏 致谢

特别感谢**https://github.com/decolua/9router**%EF%BC%88%E4%BD%9C%E8%80%85%EF%BC%9A**https://github.com/decolua**%EF%BC%89%E2%80%94%E2%80%94%E5%90%AF%E5%8F%91%E6%9C%AC%E5%88%86%E6%94%AF%E7%9A%84%E5%8E%9F%E5%A7%8B%E9%A1%B9%E7%9B%AE%E3%80%82OmniRoute%E5%9C%A8%E5%85%B6%E5%87%BA%E8%89%B2%E5%9F%BA%E7%A1%80%E4%B8%8A%E6%89%A9%E5%B1%95%E4%BA%86%E6%9B%B4%E5%A4%9A%E5%8A%9F%E8%83%BD%E3%80%81%E5%A4%9A%E6%A8%A1%E6%80%81API%E5%92%8C%E5%AE%8C%E6%95%B4%E7%9A%84TypeScript%E9%87%8D%E5%86%99%E3%80%82

特别感谢**https://github.com/router-for-me/CLIProxyAPI**%EF%BC%88%E4%BD%9C%E8%80%85%EF%BC%9A**https://github.com/router-for-me**%EF%BC%89%E2%80%94%E2%80%94%E5%90%AF%E5%8F%91%E6%9C%ACJavaScript%E7%A7%BB%E6%A4%8D%E7%89%88%E7%9A%84%E5%8E%9F%E5%A7%8BGo%E5%AE%9E%E7%8E%B0%E3%80%82

特别感谢**https://github.com/JuliusBrussee/caveman**%EF%BC%88%E4%BD%9C%E8%80%85%EF%BC%9A**https://github.com/JuliusBrussee**%EF%BC%8C%E2%AD%90 51K+）——这个热门项目提出的"why use many token when few token do trick"（为何用多token，少token就够用）压缩理念，启发了OmniRoute的标准压缩模式和30+填充词/精简正则规则。

特别感谢**https://github.com/rtk-ai/rtk**%EF%BC%88%E4%BD%9C%E8%80%85%EF%BC%9A**https://github.com/rtk-ai**%EF%BC%89%E2%80%94%E2%80%94%E8%BF%99%E4%B8%AA%E9%AB%98%E6%80%A7%E8%83%BD%E5%91%BD%E4%BB%A4%E8%BE%93%E5%87%BA%E5%8E%8B%E7%BC%A9%E9%A1%B9%E7%9B%AE%E7%9A%84%E7%BB%88%E7%AB%AF%E3%80%81%E6%9E%84%E5%BB%BA%E3%80%81%E6%B5%8B%E8%AF%95%E3%80%81git%E5%92%8C%E5%B7%A5%E5%85%B7%E8%BE%93%E5%87%BA%E8%BF%87%E6%BB%A4%E6%A8%A1%E5%9E%8B%EF%BC%8C%E5%90%AF%E5%8F%91%E4%BA%86OmniRoute%E7%9A%84RTK%E5%BC%95%E6%93%8E%E3%80%81JSON%E8%BF%87%E6%BB%A4%E5%99%A8DSL%E3%80%81%E5%8E%9F%E5%A7%8B%E8%BE%93%E5%87%BA%E6%81%A2%E5%A4%8D%E5%92%8CRTK%E2%86%92Caveman%E5%A0%86%E5%8F%A0%E5%8E%8B%E7%BC%A9%E6%B5%81%E6%B0%B4%E7%BA%BF%E3%80%82

特别感谢**https://github.com/leninejunior/troglodita**%EF%BC%88%E4%BD%9C%E8%80%85%EF%BC%9A**https://github.com/leninejunior**%EF%BC%89%E2%80%94%E2%80%94%E8%BF%99%E4%B8%AA%E8%91%A1%E8%90%84%E7%89%99%E8%AF%ADtoken%E5%8E%8B%E7%BC%A9%E9%A1%B9%E7%9B%AE%EF%BC%88%22por que gastar muitos tokens quando poucos resolve?"，为何用多token，少token就够用）的葡萄牙语原生规则，为OmniRoute的pt-BR语言包提供了支持：冗余减少、针对巴西葡萄牙语语法的填充词移除，以及面向巴西开发者社区的技术缩写。

❤️ 支持

OmniRoute是免费开源项目，在开源社区中构建和维护。如果它为你节省了时间或成本，欢迎支持开发：

• ⭐ 为仓库点赞——这真的有助于提高可见度
• 💖 **https://github.com/***/diegosouzapw**%E2%80%94%E2%80%94%E8%B5%84%E5%8A%A9%E6%8C%81%E7%BB%AD%E7%BB%B4%E6%8A%A4%E5%92%8C%E6%96%B0%E6%8F%90%E4%BE%9B%E5%95%86%E9%9B%86%E6%88%90
• 🐛 在https://github.com/diegosouzapw/OmniRoute/discussions**%E6%8A%A5%E5%91%8A%E9%94%99%E8%AF%AF%E5%B9%B6%E5%88%86%E4%BA%AB%E5%8F%8D%E9%A6%88**

📄 许可证

MIT许可证——详见LICENSE。

---

⬆ 返回顶部 · 为开源AI社区用心打造。

OmniRoute v3.8.24 · Node ≥22.0.0 · MIT License · omniroute.online