ghcr.io/diegosouzapw/omniroute:3.8.39

🚀 OmniRoute — 免费AI网关

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

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

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

约16亿记录在案的免费 tokens/月 —— 首次注册使用赠额可高达约21亿/月 —— 跨免费层级聚合，外加大量永久免费、无上限的提供商，上述压缩技术进一步延长每个 token 的使用。(我们如何统计 →)

💬 加入社区

🧩 可用资源

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

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

🌐 支持42+种语言

🇺🇸 🇧🇷 🇵🇹 🇪🇸 🇫🇷 🇮🇹 🇩🇪 🇳🇱 🇷🇺 🇺🇦 🇵🇱 🇨🇿 🇸🇰 🇷🇴 🇭🇺

🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭

🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇧🇩 🇵🇰 🇮🇷 🇸🇦 🇮🇱 🇹🇷 🇦🇿 🇹🇿

Auto-Combo 引擎基于 9个因素（健康状态、配额、成本、延迟、成功率、新鲜度……）对每个候选目标进行评分 — 详见 docs/routing/AUTO-COMBO.md。

⚖️ 配额共享 — 团队共享单个订阅 ✨ 新功能

多个密钥对应同一上游账户（如一个 Codex Pro 计划、一个 Kimi 密钥、一个 GLM Coding 席位）？某个密钥的突发流量可能会耗尽整个 5 小时/每小时配额，导致其他用户被锁定。配额共享可在池中的密钥间公平分配提供商的基于时间的配额 — 且具备“工作保持”特性，闲置成员的配额份额会被借出而非浪费。

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

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

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

约16亿记录在案的免费 tokens/月 —— 首次注册使用赠额可高达约21亿/月 —— 跨免费层级聚合，外加大量永久免费、无上限的提供商，上述压缩技术进一步延长每个 token 的使用。(我们如何统计 →)

💬 加入社区

🧩 可用资源

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

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

🌐 支持42+种语言

🇺🇸 🇧🇷 🇵🇹 🇪🇸 🇫🇷 🇮🇹 🇩🇪 🇳🇱 🇷🇺 🇺🇦 🇵🇱 🇨🇿 🇸🇰 🇷🇴 🇭🇺

🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭

🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇧🇩 🇵🇰 🇮🇷 🇸🇦 🇮🇱 🇹🇷 🇦🇿 🇹🇿

Auto-Combo 引擎基于 9个因素（健康状态、配额、成本、延迟、成功率、新鲜度……）对每个候选目标进行评分 — 详见 docs/routing/AUTO-COMBO.md。

⚖️ 配额共享 — 团队共享单个订阅 ✨ 新功能

多个密钥对应同一上游账户（如一个 Codex Pro 计划、一个 Kimi 密钥、一个 GLM Coding 席位）？某个密钥的突发流量可能会耗尽整个 5 小时/每小时配额，导致其他用户被锁定。配额共享可在池中的密钥间公平分配提供商的基于时间的配额 — 且具备“工作保持”特性，闲置成员的配额份额会被借出而非浪费。

CODE_TOKEN_0 宽松模式（在请求离开 OmniRoute 之前 的热路径中强制执行，包含按（密钥、模型）的上限 + 会话粘性以确保提示缓存完整性（现已支持按组合/全局禁用切换）。📖 配额共享引擎

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

CODE_TOKEN_1

📖 Auto-Combo 引擎 · 弹性指南

🏆 OmniRoute 的优势

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

✨ 新特性

v3.8.20 → v3.8.45 版本的近期亮点。完整历史见 CHANGELOG.md。

• ⚖️ Quota-Share 配额共享路由 — 一种专用组合策略，通过可用配额在账户间分配负载：赤字轮询（Deficit-Round-Robin）调度、带冷却等待队列的每连接 max_concurrent、多窗口使用桶（5小时/7天/每模型）、每（密钥、模型）上限、确保提示缓存完整性的会话粘性（现已支持每组合/全局禁用开关），以及来自上游令牌使用头的主动饱和度检测。→ 弹性指南

🔒 隐私优先与本地优先

您的密钥、您的设备、您的数据。OmniRoute 是一个本地代理——它从不与外部服务器通信。

• 🏠 100% 运行于您的硬件 — npm、Docker、桌面端或手机。请求路径中不存在 OmniRoute 云服务。
• 🔐 静态凭证加密 — API 密钥和 OAuth 令牌采用AES-256-GCM 加密。
• 🚫 默认零遥测 — 您的提示仅发送至您选择的提供商，不会发送至其他任何地方。
• 🛡️ 强化网关 — API 密钥作用域、IP 过滤、速率限制、提示注入防护、仅本地回环进程路由。
• 📜 MIT 许可且完全开源 — 可审计每一行代码，永久自托管。

📖 授权 · 安全护栏 · 合规性

📖 工作原理 — 流水线、架构与节省计算

CODE_TOKEN_2

默认的堆叠组合运行 RTK → Caveman。当两者作用于相同的工具/上下文负载时，节省效果会叠加：

CODE_TOKEN_3

代码块、URL、JSON和结构化数据始终受到保留引擎的完全保护。

🎚️ 引擎之外 — 输出样式、自适应调节与每请求控制

上述10个引擎用于缩减输入内容。另外三层用于塑造方式、时机和输出内容：

• 🪄 输出样式 (输出轴控制) — 注入确定性、缓存安全的响应塑造指令；可组合，每种样式的强度为 lite / full / ultra。添加样式只需一行注册表项：
  • 简洁 prose — 去除填充词/冠词/模糊表述；保持技术实质准确。
  • 精简代码 — “懒惰资深开发者”的YAGNI原则：最小可行变更，无多余脚手架。
  • 简洁CJK（文言）— 文言文风格超简洁表达（仅对 zh 语言环境启用）。
• 🎯 自适应上下文预算 (调节旋钮) — 不再使用单一的开关式令牌阈值，仅在需要时逐步启用成本最低、损失最小的引擎，以适配模型的上下文窗口。策略：reserve-output（默认，模型感知）· percentage · absolute。模式：floor（保证适配）· replace-autotrigger（显式选择优先）· off（传统阈值）。
• 🎛️ 压缩决策位置 (优先级从高到低) — 每请求 x-omniroute-compression 头 › 路由组合覆盖 › 活动命名配置文件 › 自适应/自动触发 › 面板默认值 › 关闭。应用的方案会在 X-OmniRoute-Compression: ; source= 响应头中回传。

可通过令牌阈值自动触发、启用自适应调节、固定命名配置文件、为单次请求设置一次性配置，或为每个路由组合分配流水线 — 选择最适合工作负载的方式。一个可选的离线评估工具（npm run eval:compression）在您推广变更前，会基于固定语料库对保真度与节省效果进行评分。

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

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

🦭 Podman

CODE_TOKEN_4

📖 Podman Guide — Quadlet 配置、podman-compose、Quadlet。

⚡ 更快/更精简的安装（跳过原生构建）

原生 SQLite 引擎（better-sqlite3）是可选依赖，因此全局安装从不因源码编译而受阻：当平台/Node 版本匹配时使用预构建二进制文件，否则透明回退到纯 JS 引擎（Node 22+ 使用 node:sqlite，其他版本使用内置 sql.js WASM）——无需构建工具。

如需完全跳过安装后的原生预热（CI、无头环境或低性能机器）：

CODE_TOKEN_5

若要获得最快的安装速度，建议使用 pnpm（内容寻址存储 + 硬链接 — 见上文）。如需无仪表盘的无头运行时，可使用 Docker base 配置文件（见上文）或 Termux 指南。CLI 和 Web 仪表盘由同一进程在同一端口提供服务，因此目前没有单独的仅 CLI 包。

🎬 OmniRoute 实际应用

🇧🇷 葡萄牙语完整指南

🇺🇸 英语完整教程

🇷🇺 俄语完整指南

🎬 制作了关于 OmniRoute 的视频？ 打开 https://github.com/diegosouzapw/OmniRoute/issues/new 或 https://github.com/diegosouzapw/OmniRoute/discussions 并附上链接 — 我们将在此展示。

📚 探索更多

💰 价格概览及 0 ***免费组合（11 个提供商）

**0 *免费组合 — 组合成一个可靠的套餐：

💡 仪表盘上的“成本”是一个节省跟踪器，而非账单 — OmniRoute 从不向您收费。使用免费模型显示“总成本 290 *”意味着节省了 290 *****。

📖 完整免费目录 → docs/reference/FREE_TIERS.md — 25+ 提供商、配额、基础 URL。

🎯 用例 — 现成的组合方案

永久免费：

CODE_TOKEN_6

7×24 小时无中断： 串联 2 个订阅 → 廉价 → 5 层回退免费。地区封锁： 免费提供商 + 全局/按提供商代理 → 从任何国家访问 AI。最大节省： 订阅 + 廉价备份 + ultra 压缩（约 75%）→ 重度用户每月节省约 150–300 ***。

🌍 绕过地区封锁 — 3 级代理 + 隐身模式

🇷🇺 🇨🇳 🇮🇷 🇨🇺 🇹🇷 在封锁地区？OmniRoute 的3 级代理（全局/按提供商/按连接）可代理 API 请求、OAuth 流程、连接测试、令牌刷新和模型同步。

• 协议： HTTP/HTTPS、SOCKS5、带认证的代理
• 🆓 1proxy 市场 — 数百个免费验证代理、质量评分、自动轮换
• 反检测 — TLS 指纹伪造（wreq-js）、CLI 指纹匹配、代理 IP 保留

📖 docs/ops/PROXY_GUIDE.md

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

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

📖 MCP Server · A2A Server · Resilience Guide · Features Gallery

📖 设置、环境变量及常见问题

OmniRoute 会向我收费吗？ 不会 — 它是您机器上的免费开源软件。您只需直接向付费提供商付费。OmniRoute 没有计费系统。
免费提供商真的无限吗？ 大部分是 — Qoder、Pollinations、LongCat 和 Cloudflare 是免费的，无每账户信用额度限制。Kiro 也是免费的，但每个账户每月上限约 50 积分。组合多个免费提供商并启用自动回退，即可实现 0 持续使用。
压缩会影响质量吗？ 不会 — 它只压缩输入*；代码、URL、JSON 始终受到保护。
在 AI 被封锁的地方能用吗？ 能 — 3 级代理 + 1proxy 市场可连接所有 237 个提供商。

📖 User Guide · API Reference · Environment Config