ghcr.io/diegosouzapw/omniroute:3.8.34
ghcr.iolinux/amd643.8.34大小: 352.34 MB更新于 2026年7月5日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
🚀 OmniRoute — 免费AI网关
永不停止编码。通过一个端点，将所有AI工具连接到 237个提供商 — 90+个免费。
**将Claude Code、Codex、Cursor、Cline、Copilot和Antigravity接入免费的Claude / GPT / *。自动回退。
RTK + Caveman压缩节省15–95%的 tokens。永不触发限制。
约16亿记录在案的免费 tokens/月 — 首次注册可获得积分，首月最高约21亿 — 跨免费层级聚合，外加大量永久免费、无上限的提供商，上述压缩技术进一步延长每个 token 的使用。(我们如何计算 →)
💬 加入社区
🧩 可用资源
🚀 快速开始 • 🎯 组合策略 • 🌐 提供商 • 🔌 CLI & MCP • 🗜️ 压缩 • 🌍 网站
💥 承诺 • 🤔 为何选择 • 🏆 独特之处 • 🤖 兼容CLI • 🖥️ 运行环境 • 🔒 隐私保护 • 🎬 实际应用 • 📚 探索更多 • 📧 支持
🌐 支持42+种语言
🇺🇸 🇧🇷 🇵🇹 🇪🇸 🇫🇷 🇮🇹 🇩🇪 🇳🇱 🇷🇺 🇺🇦 🇵🇱 🇨🇿 🇸🇰 🇷🇴 🇭🇺
🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭
🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇧🇩 🇵🇰 🇮🇷 🇸🇦 🇮🇱 🇹🇷 🇦🇿 🇹🇿
💰 约16亿免费Tokens/月
手动叠加免费层级非常繁琐——数十个SDK、数十个速率限制，且不清楚实际可用额度。OmniRoute将40+个提供商池/500+个模型的记录在案的免费层级聚合为一个真实数值，并在仪表板（
/dashboard/free-tiers）上实时显示。
- 约16亿免费tokens/月（稳定）——首次注册可获得积分，首月最高约21亿。
- 池去重，真实可信——每个共享免费池我们只计算一次，因此标题不会像竞争对手的数十亿宣称那样被速率限制上限夸大。（若24/7计算每个速率限制，数值约为100亿；我们不发布此数据。）
- 外加不可计数部分——永久免费、无token上限的提供商（SiliconFlow、Z.AI GLM-Flash、Kilo、OpenCode Zen……）以及10*OpenRouter充值可解锁每月+2400万**，两者均单独显示，因此不会夸大标题数值。
- 按模型细分、当月实时已用/剩余额度，以及每个提供商的透明条款标记。
预览模拟图——
/dashboard/free-tiers页面验证后将提供真实截图。完整方法（池去重、信用层级、提供商条款）：docs/reference/FREE_TIERS.md。
💥 承诺
一个端点。237个提供商。永不停止构建——让OmniRoute选择最便宜且有效的那个。
-
🚫 永不触发限制 毫秒级跨237个提供商自动回退。配额用尽？下一个提供商接管——零停机。
-
💸 节省高达95%的tokens RTK + Caveman叠加压缩减少15–95%的合格tokens（工具密集型会话平均约89%）。
-
🆓 零成本启动 90+个提供商提供免费层级，11个永久免费（Kiro、Qoder、Pollinations、LongCat……）。无需***。
-
🔌 所有工具兼容 24+个编码代理——Claude Code、Codex、Cursor、Cline、Copilot、Antigravity——通过一个配置即可使用。
-
🧩 一个端点 OpenAI ↔ Claude ↔ *** ↔ Responses API 转换。将任何工具指向 /v1 即可正常工作。
-
🛡️ 生产级品质 断路器、TLS隐身、MCP（95个工具）、A2A、内存、护栏、评估。21,000+项测试。
🤔 为何选择OmniRoute？
告别在10个仪表板、失效API密钥和意外账单之间周旋。
| ❌ 日常痛点 | ✅ OmniRoute如何解决 |
|---|---|
| 📉 订阅配额每月未使用即过期 | 最大化订阅价值——跟踪配额，在重置前用完每个token |
| 🛑 速率限制在编码过程中中断工作 | 4层自动回退——订阅 → API → 低价 → 免费，毫秒级切换 |
🔥 工具输出（git diff、grep、日志）消耗大量tokens | RTK + Caveman压缩——每个请求节省15–95%的合格tokens |
| 💸 API成本高昂（每个提供商每月20–50***） | 成本优化路由——自动路由至最便宜的可用模型 |
| 🧰 每个AI工具都需要单独配置 | 一个端点、所有工具、一个仪表板 |
| 🌍 所在国家/地区屏蔽AI | 3级代理 + TLS指纹隐身——从任何地方使用AI |
┌──────────────────────────────────────────────────────────┐
│ Your IDE / CLI (Claude Code, Cursor, Cline…) │
└─────────────────────────┬──────────────────────────────────┘
│ http://localhost:20128/v1
▼
┌──────────────────────────────────────────────────────────┐
│ OmniRoute — Smart Router │
│ RTK + Caveman compression · 17 routing strategies │
│ Circuit breakers · TLS stealth · MCP · A2A · Guardrails │
└─────────────────────────┬──────────────────────────────────┘
┌─────────────┬────┴────────┬─────────────┐
▼ Tier 1 ▼ Tier 2 ▼ Tier 3 ▼ Tier 4
SUBSCRIPTION API KEY CHEAP FREE
Claude Code, DeepSeek, GLM $0.5, Kiro, Qoder,
Codex, Copilot Groq, xAI MiniMax $0.2 Pollinations
quota out? ───▶ budget hit? ─▶ budget hit? ─▶ always on
🎯 组合策略 — 核心功能
组合策略（combo） 是OmniRoute自动路由的一系列模型链。当配额用尽、提供商故障或成本飙升时，组合策略会静默切换到下一个模型。这正是OmniRoute不可中断的原因。 🛡️
⚡ 零配置 — 只需使用 auto
无需创建组合策略。将模型设置为 auto（或其变体），OmniRoute会从已连接的提供商中构建虚拟组合策略，并实时评分：
| 模型ID | 优化目标 |
|---|---|
auto | 🎯 平衡默认值（LKGP — 坚持使用上次正常的提供商） |
auto/coding | 🧑💻 代码生成优先考虑质量权重 |
auto/fast | ⚡ 优先最低延迟 |
auto/cheap | 💰 优先每token最低成本 |
auto/offline | 🔋 优先最高配额/速率限制余量 |
auto/smart | 🔭 质量优先 + 10%探索以发现更好的模型 |
🔀 或自定义 — 17种路由策略
全部17种策略 — 可按组合步骤混合搭配：
| # | 策略 | 功能描述 |
|---|---|---|
| 1 | priority | 首个目标有序列表 — 排空当前目标后再处理下一个 🥇 |
| 2 | fill-first | 完全填满当前目标的配额后再移至下一个 |
| 3 | weighted | 按目标权重进行加权随机选择 |
| 4 | round-robin | 按顺序循环遍历目标 |
| 5 | p2c | 二选一随机负载均衡（Power-of-two-choices） |
| 6 | least-used | 选择当前负载最低的目标 |
| 7 | random | 均匀随机选择（去重） |
| 8 | strict-random | 随机选择（不去重）🎲 |
| 9 | cost-optimized | 根据实时目录定价最小化每请求成本 💸 |
| 10 | headroom | 选择剩余配额最多的目标 |
| 11 | reset-window | 优先选择配额窗口即将重置的目标 |
| 12 | reset-aware | 按配额重置时间排序 — 优先选择窗口较短的目标 📊 |
| 13 | context-relay | 在目标间传递上下文以支持长对话 🧠 |
| 14 | context-optimized | 为当前上下文大小选择最佳匹配目标 |
| 15 | lkgp | 最近已知良好路径（Last-Known-Good Path）— 粘性保持最近成功的目标 |
| 16 | auto | 基于9个因素对每个连接进行实时评分 🤖 |
| 17 | fusion | 向模型组并行请求 + 由判断模型合成一个答案 🧬 |
Auto-Combo 引擎基于 9个因素（健康状态、配额、成本、延迟、成功率、新鲜度……）对每个候选目标进行评分 — 详见 docs/routing/AUTO-COMBO.md。
⚖️ Quota-Share — 团队共享单个订阅 ✨ 新增功能
在同一上游账户中使用多个密钥（一个Codex Pro计划、一个Kimi密钥、一个GLM Coding席位）？某个密钥的突发流量可能会耗尽整个5小时/每小时配额，导致其他用户被锁定。Quota-Share 可将提供商的基于时间的配额公平分配给池中的所有密钥 — 并且具有“工作保持”特性，闲置成员的配额份额会被借出而非浪费。
| 配置项 | 控制内容 |
|---|---|
| ⚖️ 分配权重 | 池中每个密钥的配额比例 — 例如 50 / 30 / 20 |
| 📐 计量维度 | 按 % · 请求数 · 令牌数 · `# 🚀 OmniRoute — 免费AI网关 |
永不停止编码。通过一个端点，将所有AI工具连接到 237个提供商 — 90+个免费。
**将Claude Code、Codex、Cursor、Cline、Copilot和Antigravity接入免费的Claude / GPT / *。自动回退。
RTK + Caveman压缩节省15–95%的 tokens。永不触发限制。
约16亿记录在案的免费 tokens/月 — 首次注册可获得积分，首月最高约21亿 — 跨免费层级聚合，外加大量永久免费、无上限的提供商，上述压缩技术进一步延长每个 token 的使用。(我们如何计算 →)
💬 加入社区
🧩 可用资源
🚀 快速开始 • 🎯 组合策略 • 🌐 提供商 • 🔌 CLI & MCP • 🗜️ 压缩 • 🌍 网站
💥 承诺 • 🤔 为何选择 • 🏆 独特之处 • 🤖 兼容CLI • 🖥️ 运行环境 • 🔒 隐私保护 • 🎬 实际应用 • 📚 探索更多 • 📧 支持
🌐 支持42+种语言
🇺🇸 🇧🇷 🇵🇹 🇪🇸 🇫🇷 🇮🇹 🇩🇪 🇳🇱 🇷🇺 🇺🇦 🇵🇱 🇨🇿 🇸🇰 🇷🇴 🇭🇺
🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭
🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇧🇩 🇵🇰 🇮🇷 🇸🇦 🇮🇱 🇹🇷 🇦🇿 🇹🇿
💰 约16亿免费Tokens/月
手动叠加免费层级非常繁琐——数十个SDK、数十个速率限制，且不清楚实际可用额度。OmniRoute将40+个提供商池/500+个模型的记录在案的免费层级聚合为一个真实数值，并在仪表板（
/dashboard/free-tiers）上实时显示。
- 约16亿免费tokens/月（稳定）——首次注册可获得积分，首月最高约21亿。
- 池去重，真实可信——每个共享免费池我们只计算一次，因此标题不会像竞争对手的数十亿宣称那样被速率限制上限夸大。（若24/7计算每个速率限制，数值约为100亿；我们不发布此数据。）
- 外加不可计数部分——永久免费、无token上限的提供商（SiliconFlow、Z.AI GLM-Flash、Kilo、OpenCode Zen……）以及10*OpenRouter充值可解锁每月+2400万**，两者均单独显示，因此不会夸大标题数值。
- 按模型细分、当月实时已用/剩余额度，以及每个提供商的透明条款标记。
预览模拟图——
/dashboard/free-tiers页面验证后将提供真实截图。完整方法（池去重、信用层级、提供商条款）：docs/reference/FREE_TIERS.md。
💥 承诺
一个端点。237个提供商。永不停止构建——让OmniRoute选择最便宜且有效的那个。
-
🚫 永不触发限制 毫秒级跨237个提供商自动回退。配额用尽？下一个提供商接管——零停机。
-
💸 节省高达95%的tokens RTK + Caveman叠加压缩减少15–95%的合格tokens（工具密集型会话平均约89%）。
-
🆓 零成本启动 90+个提供商提供免费层级，11个永久免费（Kiro、Qoder、Pollinations、LongCat……）。无需***。
-
🔌 所有工具兼容 24+个编码代理——Claude Code、Codex、Cursor、Cline、Copilot、Antigravity——通过一个配置即可使用。
-
🧩 一个端点 OpenAI ↔ Claude ↔ *** ↔ Responses API 转换。将任何工具指向 /v1 即可正常工作。
-
🛡️ 生产级品质 断路器、TLS隐身、MCP（95个工具）、A2A、内存、护栏、评估。21,000+项测试。
🤔 为何选择OmniRoute？
告别在10个仪表板、失效API密钥和意外账单之间周旋。
| ❌ 日常痛点 | ✅ OmniRoute如何解决 |
|---|---|
| 📉 订阅配额每月未使用即过期 | 最大化订阅价值——跟踪配额，在重置前用完每个token |
| 🛑 速率限制在编码过程中中断工作 | 4层自动回退——订阅 → API → 低价 → 免费，毫秒级切换 |
🔥 工具输出（git diff、grep、日志）消耗大量tokens | RTK + Caveman压缩——每个请求节省15–95%的合格tokens |
| 💸 API成本高昂（每个提供商每月20–50***） | 成本优化路由——自动路由至最便宜的可用模型 |
| 🧰 每个AI工具都需要单独配置 | 一个端点、所有工具、一个仪表板 |
| 🌍 所在国家/地区屏蔽AI | 3级代理 + TLS指纹隐身——从任何地方使用AI |
CODE_TOKEN_1
🎯 组合策略 — 核心功能
组合策略（combo） 是OmniRoute自动路由的一系列模型链。当配额用尽、提供商故障或成本飙升时，组合策略会静默切换到下一个模型。这正是OmniRoute不可中断的原因。 🛡️
⚡ 零配置 — 只需使用 auto
无需创建组合策略。将模型设置为 auto（或其变体），OmniRoute会从已连接的提供商中构建虚拟组合策略，并实时评分：
| 模型ID | 优化目标 |
|---|---|
auto | 🎯 平衡默认值（LKGP — 坚持使用上次正常的提供商） |
auto/coding | 🧑💻 代码生成优先考虑质量权重 |
auto/fast | ⚡ 优先最低延迟 |
auto/cheap | 💰 优先每token最低成本 |
auto/offline | 🔋 优先最高配额/速率限制余量 |
auto/smart | 🔭 质量优先 + 10%探索以发现更好的模型 |
🔀 或自定义 — 17种路由策略
全部17种策略 — 可按组合步骤混合搭配：
| # | 策略 | 功能描述 |
|---|---|---|
| 1 | priority | 首个目标有序列表 — 排空当前目标后再处理下一个 🥇 |
| 2 | fill-first | 完全填满当前目标的配额后再移至下一个 |
| 3 | weighted | 按目标权重进行加权随机选择 |
| 4 | round-ro*** | 按顺序循环遍历目标 |
| 5 | p2c | 二选一随机负载均衡（Power-of-two-choices） |
| 6 | least-used | 选择当前负载最低的目标 |
| 7 | random | 均匀随机选择（去重） |
| 8 | strict-random | 随机选择（不去重）🎲 |
| 9 | cost-optimized | 根据实时目录定价最小化每请求成本 💸 |
| 10 | headroom | 选择剩余配额最多的目标 |
| 11 | reset-window | 优先选择配额窗口即将重置的目标 |
| 12 | reset-aware | 按配额重置时间排序 — 优先选择窗口较短的目标 📊 |
| 13 | context-relay | 在目标间传递上下文以支持长对话 🧠 |
| 14 | context-optimized | 为当前上下文大小选择最佳匹配目标 |
| 15 | lkgp | 最近已知良好路径（Last-Known-Good Path）— 粘性保持最近成功的目标 |
| 16 | auto | 基于9个因素对每个连接进行实时评分 🤖 |
| 17 | fusion | 向模型组并行请求 + 由判断模型合成一个答案 🧬 |
Auto-Combo 引擎基于 9个因素（健康状态、配额、成本、延迟、成功率、新鲜度……）对每个候选目标进行评分 — 详见 docs/routing/AUTO-COMBO.md。
⚖️ Quota-Share — 团队共享单个订阅 ✨ 新增功能
在同一上游账户中使用多个密钥（一个Codex Pro计划、一个Kimi密钥、一个GLM Coding席位）？某个密钥的突发流量可能会耗尽整个5小时/每小时配额，导致其他用户被锁定。Quota-Share 可将提供商的基于时间的配额公平分配给池中的所有密钥 — 并且具有“工作保持”特性，闲置成员的配额份额会被借出而非浪费。
| 配置项 | 控制内容 |
|---|---|
| ⚖️ 分配权重 | 池中每个密钥的配额比例 — 例如 50 / 30 / 20 |
| 📐 计量维度 | 按 % · 请求数 · 令牌数 · 计量，支持 5小时 / 7天 / 按模型 窗口 |
| 🚦 策略模式 | hard（超出份额时阻止）· soft（降低优先级）· burst（使用闲置配额） |
| 🧱 绝对上限 | 每个密钥的独立上限，与模式无关 |
CODE_TOKEN_2 组合示例："always-on" 策略：priority
- cc/claude-***-4-7 ← 订阅（优先用尽）
- cx/gpt-5.5 ← 第二个订阅
- glm/glm-5.1 ← 低成本备份（$0.5/1M令牌）
- kr/claude--4.5 ← 免费、无限制（永不失效） 结果：4层 fallback = 零停机时间 CODE_TOKEN_3 客户端 (10,000 令牌) ──▶ OmniRoute 压缩 (10 个引擎) ──▶ 服务提供商 (~1,080 令牌，最高节省 95%) __CODE_TOKEN_4__txt comed = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% __CODE_TOKEN_5__bash
1. 构建镜像
podman build --target runner-base -t omniroute:base .
2. 修复无root权限Podman的数据目录权限
mkdir -p data && podman unshare chown 1000:1000 ./data
3. 在.env中设置运行时，然后运行（参见contrib/podman/获取Quadlet配置）
echo "CONTAINER_HOST=podman"
.env podman compose --profile base up -d __CODE_TOKEN_6__bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1也会跳过 CODE_TOKEN_7
- kr/claude-***-4.5 (Kiro — 每个账户约50 credits/月)
- if/kimi-k2-thinking (Qoder — 无限)
- pol/gpt-5 (Pollinations — 无需密钥)
- lc/LongCat-2.0 (1000万次一次性备份，需KYC) 压缩：激进（约50%）→ 免费配额翻倍 · 成本：0***/月
**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 ↔ *** ↔ 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防护的获取）· 安装/启用/禁用 · Notion + Obsidian知识库集成（WebDAV文件服务器、库搜索、笔记CRUD）。
- **嵌入式服务：** 本地边车服务（CLIProxy、NineRouter）的一键安装和生命周期管理。
- **质量与运维：** 内置**评估**（黄金集：精确匹配/包含/正则/自定义）· 安全护栏（PII、注入、视觉）· 健康仪表盘 · p50/p95/p99遥测 · Webhooks · 合规审计。
- **AI代理技能：** 即插即用的Markdown清单 — 将任何代理指向`skills/*/SKILL.md`清单。提供43种技能。
📖 MCP 服务器 · A2A 服务器 · 弹性指南 · 功能展示
📖 设置、环境变量与常见问题
| 环境变量 | 默认值 | 用途 |
| ----------------- | -------------- | -------------------------------- |
| `PORT` | `20128` | API + 仪表盘端口 |
| `REQUIRE_API_KEY` | `false` | 所有请求需API密钥 |
| `DATA_DIR` | `~/.omniroute` | 数据库和配置存储 |
**OmniRoute会向我收费吗？** 不会 — 它是您机器上的免费开源软件。您只需直接向付费提供商付费。OmniRoute没有计费系统。
**免费提供商真的无限吗？** 大部分是 — Qoder、Pollinations、LongCat和Cloudflare是免费的，没有每账户信用额度限制。Kiro也是免费的，但每个账户每月上限约为50 credits。组合多个免费提供商并启用自动回退，即可实现0***持续使用。
**压缩会影响质量吗？** 不会 — 它只压缩**输入**；代码、URL、JSON始终受到保护。
**在AI被封锁的地方能用吗？** 能 — 3级代理 + 1proxy市场可连接所有237个提供商。
📖 用户指南 · API参考 · 环境配置
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"