如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
将 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 | 其他路由工具 |
|---|---|---|
| 🌐 提供商数量 | 177 家 | 20–100 家 |
| 🆓 免费提供商 | 50+ 家(11 家永久免费) | 1–5 家 |
| 🔀 路由策略 | 15 种(优先级、加权、成本优化、上下文中继……) | 1–3 种 |
| 🗜️ 令牌压缩 | RTK + Caveman 叠加(15–95% 压缩率) | 无 / 20–40% |
| 🧰 内置 MCP 服务器 | 87 种工具、3 种传输方式、30 种作用域 | 罕见 |
| 🤝 A2A 代理协议 | 6 种技能、JSON-RPC 2.0 | 无 |
| 🧠 记忆功能(FTS5 + 向量) | 支持 | 罕见 |
| 🛡️ 安全护栏(PII、注入***、视觉内容) | 支持 | 罕见 |
| ☁️ 云代理 | Codex、Devin、Jules | 无 |
| 🥷 TLS 指纹隐藏 | 通过 wreq-js 实现 JA3/JA4 | 无 |
| 🖥️ 多平台支持 | 网页 · 桌面 · Termux · PWA | 仅网页 |
| 🌍 国际化 | 40+ 种语言 | 0–4 种 |
📊 与 LiteLLM、OpenRouter 和 Portkey 的详细对比 → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md
🐳 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服务器 · 弹性指南 · 功能展示
📖 安装设置、环境变量与常见问题
| 环境变量 | 默认值 | 用途 |
|---|---|---|
PORT | 20128 | API + 仪表板端口 |
REQUIRE_API_KEY | false | 所有请求是否需要API密钥 |
DATA_DIR | ~/.omniroute | 数据库和配置存储目录 |
OmniRoute会向我收费吗? 不会 — 它是运行在您机器上的免费开源软件。您只需直接向付费提供商付费。OmniRoute没有计费系统。 免费提供商真的是无限使用吗? 是的 — Kiro、Qoder、Pollinations、LongCat、Cloudflare。没有隐藏条款。 压缩会影响质量吗? 不会 — 它只压缩输入内容;代码、URL、JSON始终受保护。 在AI被封锁的地区能使用吗? 是的 — 3级代理 + 1proxy市场可连接所有177个提供商。
📖 用户指南 · API参考 · 环境配置
| 文档 | 描述 |
|---|---|
| 架构 | 系统架构、数据流和内部原理 |
| 压缩指南 | 7选项流水线:off / lite / standard / aggressive / ultra / RTK / stacked |
| RTK压缩 | 命令输出压缩、过滤器、信任机制、验证和原始输出恢复 |
| 压缩引擎 | Caveman、RTK、堆叠流水线、控制台/API/MCP界面 |
| 压缩规则格式 | Caveman和RTK过滤器的JSON规则包架构 |
| 压缩语言包 | 语言检测和Caveman规则包编写 |
| 弹性指南 | 熔断器、冷却机制、队列、防惊群效应、TLS伪装 |
| 自动组合引擎 | 9因素评分、模式包、自修复功能 |
| 代理指南 | 3级代理系统、1proxy市场、注册表CRUD操作 |
| 免费套餐 | 25+个免费API提供商的整合目录 |
| 功能展示 | 带截图的可视化控制台导览 |
| 代码库文档 | 适合初学者的代码库漫游指南 |
| 文档 | 描述 |
|---|---|
| API参考 | 所有端点及示例 |
| OpenAPI规范 | OpenAPI 3.0规范 |
| MCP服务器 | 87个MCP工具、IDE配置、Python/TS/Go客户端 |
| MCP服务器指南 | MCP安装、传输方式和工具参考 |
| A2A服务器 | JSON-RPC 2.0协议、技能、流处理、任务管理 |
| A2A服务器指南 | A2A代理卡、任务、技能和流处理 |
| 文档 | 描述 |
|---|---|
| 贡献指南 | 开发环境设置和规范 |
| 更新日志 | 完整的版本发布历史 |
| 安全策略 | 漏洞报告和安全实践 |
| 国际化指南 | 40+种语言支持、翻译工作流、RTL(从右到左)布局 |
| 发布检查清单 | 发布前验证步骤 |
| 测试覆盖计划 | 测试覆盖策略和4,690+测试套件 |
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可靠且功能丰富的核心要素。每一个拉取请求、每一个测试用例、每一个国际化翻译文件都至关重要。开源正是由像他们这样的人共同构建的。
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)详细指南参见CONTRIBUTING.md。
# 创建发布 — npm publish将自动执行
gh release create v3.8.2 --title "v3.8.2" --generate-notes
特别感谢**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是免费开源项目,在开源社区中构建和维护。如果它为你节省了时间或成本,欢迎支持开发:
MIT许可证——详见LICENSE。
⬆ 返回顶部 · 为开源AI社区用心打造。
OmniRoute v3.8.24 · Node ≥22.0.0 · MIT License · omniroute.online
来自真实用户的反馈,见证轩辕镜像的优质服务