OmniRoute 仪表盘功能全景指南从 Providers 到 SSRF 防护的完整控制台解析【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute本文以 OmniRoute 官方功能画廊文档docs/guides/FEATURES.md 及其多语言译本如 docs/i18n/bn/docs/guides/FEATURES.md为骨架结合仓库源码逐模块讲解 OmniRoute 仪表盘的每一个功能分区——提供商管理、组合路由、分析与健康监控、CLI 工具与 Agent 管理、上下文中继、提示压缩、代理加固、媒体生成、WebSocket 桥接与配置同步等。读完本文你将掌握 OmniRoute 控制台的完整能力地图、关键配置参数的语义与默认值以及若干核心功能的源码级实现原理能够据此高效配置与运维自己的 AI 网关实例。OmniRoute 是一个开源的统一 AI 网关MIT 协议以一个端点接入数百家提供商、上千个模型为核心主张控制台Dashboard是它的操作中枢。官方功能画廊文档用分区截图 能力清单的方式枚举了仪表盘的每一个模块本文在此基础上逐一展开并为每项能力补充源码证据方便开发者按图索骥、深入源码继续探索。一、能力总览仪表盘到底能做什么按官方文档的结构OmniRoute 仪表盘的能力可以划分为以下几大类能力域对应模块一句话说明连接管理Providers、OAuth Env Repair管理 OAuth / API Key / 免费提供商连接路由编排Combos、Context Relay、Prompt Compression多模型组合、自动回退、跨账号上下文延续、Token 压缩观测分析Analytics、System Health、Request Logs、Audit LogToken 消耗、成本、延迟、熔断状态、请求日志、审计事件调试工具Translator Playground、Model PlaygroundAPI 翻译调试与任意模型在线试玩工具集成CLI Tools、CLI Agents一键配置 Claude Code、Codex、Cursor 等编码工具治理安全API Keys、Settings、Compliance Audit、SSRF Guard密钥治理、细粒度设置、合规审计、出站请求防护发布形态Desktop、API Endpoint、V1 WebSocket Bridge、Sync Tokens桌面应用、统一端点、WebSocket 流式桥、跨设备配置同步附加能力Media、Themes、Email Privacy Masking、Model Visibility媒体生成、主题定制、隐私掩码、模型显隐其中 v3.8.x 周期的亮点见英文版文档✨ v3.8.0 Highlights一节包括零配置自动路由auto/coding、auto/fast、auto/cheap、auto/offline、auto/smart、auto/lkgp、auto/chaos等前缀背后是 16 因子评分引擎与 6 套 curated mode packs、新增多家免费提供商、Manifest 驱动的分级路由W1–W4、每会话粘性路由、重置感知路由策略prefer 配额窗口最早重置的账号、fallbackDelayMs回退延迟调优、Reasoning Replay Cache 等。这些能力大多在下面的分区介绍中会再次出现。二、Providers三类提供商连接的管理中心Providers 页面是仪表盘的入口模块官方文档将其管理的连接分为三类OAuth 提供商如 Claude Code、Codex通过浏览器授权登录账号带完整 OAuth 凭据生命周期管理API Key 提供商如 Groq、DeepSeek、OpenRouter只需填入 API Key 即可接入免费提供商如 Qoder、Kiro无需付费凭据即可使用。Kiro 账号还包含余额跟踪——剩余积分、总配额与续期日期都会显示在Dashboard → Usage中。文档还特别提到 OpenRouter 连接可以在高级设置中保存每连接的preset。设置后OmniRoute 会将其作为 OpenRouter 请求的顶层字段发送例如preset: email-copywriter除非客户端请求本身已经带了preset。Providers 页面是连接健康的核心观测点。配合后文介绍的Email Privacy MaskingOAuth 账号邮箱默认掩码为di*****g****.com格式悬停 tooltip 显示完整地址与OAuth Env Repair一键Repair env自动修复缺失的 OAuth client 凭据、损坏的 env 条目与备份路径消毒Providers 页面同时兼顾了接入、运维与隐私三件事。三、Combos多模型组合路由策略详解Combos 是 OmniRoute 路由能力的核心。官方英文文档v3.8.x列出19 种公开路由策略中文版文档更早版本为 13 种合并去重后的完整清单如下策略说明priority按优先级顺序回退weighted按权重分配流量round-robin轮询调度random随机选择strict-random严格随机不掺入权重least-used最少使用优先cost-optimized成本优化headroom基于容量余量的选择reset-aware优先选择配额窗口最早重置的账号reset-window基于配额重置窗口调度p2cpower-of-two choices两随机选择中取优经典负载均衡策略lkgplast-known-good-provider最后一个已知可用提供商优先context-optimized上下文感知优化cache-optimized缓存命中优先fill-first先填满低优先级目标auto自动评分选择context-relay上下文中继详见后文fusion并行扇出到一组模型再由 judge 模型综合成一个答案pipeline流水线式串联执行每个 Combo 都可以链式串联多个模型并自动回退官方文档记录的近期改进包括结构化 Combo 构建器每一步都精确选择 provider、model 与具体 account/connection重复提供商支持只要(provider, model, connection)三元组唯一同一提供商可在同一个 Combo 中多次复用Combo 目标健康度分析与健康面板现在区分单个 combo 目标/步骤而不是把一切都折叠成模型字符串复合层排序defaultTier - fallbackTier会影响顶层 combo 步骤的运行时执行/回退顺序系统提示词模板v3.8combo 的system_message支持服务端展开{{MODEL_ID}}、{{PROVIDER_ID}}、{{ACCOUNT}}、{{FINGERPRINT}}占位符在真正路由到目标的前一刻展开。这些占位符采用白名单制、非递归未知占位符保持字面量空值展开为空字符串且绝不重写客户端提供的 system prompt。{{FINGERPRINT}}仅对基于指纹的免费提供商且固定/自动轮换指纹时才解析其他场景展开为空。从仓库结构看Combo 的路由执行、回退与配额逻辑集中在src/sse/SSE 流式转发与src/lib/数据库、策略与运行时工具两大目录中配合tests/unit下的大量单测可深入验证每种策略的行为。四、Analytics 与 System Health用量与健康观测4.1 Analytics用量分析Analytics 面板提供全面的用量分析Token 消耗、成本估算、活跃度热力图heatmap、每周分布图以及按提供商拆分的明细。Kiro 类免费账号的积分余额、总配额与续期日期也在此类用量页面呈现Dashboard → Usage。配合 v3.8 新增的Service tier breakdown / Codex fast tier analytics可以按服务层级查看消费明细DeepSeek quota and limit monitoring则把日/月用量直接暴露在仪表盘上。4.2 System Health系统健康System Health 面板提供实时监控运行指标uptime、内存占用、版本号延迟分位p50 / p95 / p99缓存统计缓存命中率与容量状态熔断器状态各提供商的 circuit breaker 当前是关闭、打开还是半开活跃配额监控会话数Combo 目标健康度按步骤/目标维度的健康信息。健康数据还延伸到Resilience 面板见 Settings 一节模型级冷却状态、限流头学习结果x-ratelimit-reset-requests、x-ratelimit-reset-tokens、Retry-After等都会在此可视化。五、调试与试玩Translator Playground 与 Model Playground5.1 Translator Playground翻译器调试场由于 OmniRoute 需要在 OpenAI、Claude、Gemini 等不同 API 方言之间做请求/响应翻译官方提供了四种调试模式Playground格式转换器纯离线转换请求/响应格式不发网络请求Chat Tester实时构造并发送请求观察真实上游响应Test Bench批量测试batch tests一次性验证多种翻译场景Live Monitor实时监控流式翻译过程。5.2 Model Playground模型试玩v2.0.9Model Playground 让你在仪表盘里直接试玩任意模型选择 provider、model 与 endpoint用Monaco EditorVS Code 同款编辑器编写 prompt实时流式接收响应支持中途中断abort并查看时序指标TTFT、总耗时等。六、Themes 与 Settings外观定制与全局配置6.1 Themes主题定制v2.0.5整个仪表盘支持自定义配色主题内置 7 种预设色Coral 珊瑚红、Blue 蓝、Red 红、Green 绿、Violet 紫、Orange 橙、Cyan 青也支持任选 hex 颜色创建自定义主题亮色、暗色与跟随系统三种模式均可切换。6.2 Settings设置面板7 个标签页官方英文文档v3.8.x记录了设置面板的7 个标签页标签核心内容General系统存储、备份管理数据库导出/导入Appearance主题选择dark/light/system、主题预设与自定义颜色、健康日志可见性、侧边栏条目与分组分隔符可见性、Endpoint 隧道可见性控制AIAI 助手特性、默认路由预设Auto Comboauto/coding、auto/fast、auto/cheap、auto/smart、reasoning replay cache、skill/memory 开关SecurityAPI 端点保护、自定义提供商屏蔽、IP 过滤、会话信息Routing模型别名、后台任务降级、Manifest 感知分级路由W1–W4、fallbackDelayMs、每会话粘性路由Resilience限流持久化、熔断器调参、自动禁用被封账号、提供商过期监控、Context Relay交接阈值与摘要模型配置、每提供商 429 分类与useUpstream429BreakerHints开关、模型冷却管理Advanced配置覆盖overrides、配置审计轨迹、回退降级模式、Responses API 后台模式降级中文版文档中 Settings 各标签的描述与上述一致并强调Resilience标签下包含Context Relay的交接阈值与摘要模型配置——这是跨账号会话延续能力的关键开关所在。七、CLI Tools 与 CLI Agents编码工具链一键配置7.1 CLI Toolsv2.0CLI Tools 页面提供对主流 AI 编码工具的一键配置官方列表为Claude Code、Codex CLI、OpenClaw、Kilo Code、Antigravity、Cline、Continue、Cursor、Factory Droid。能力包括自动化配置应用/重置apply/reset写入各工具自己的配置文件连接配置文件connection profiles为不同工具或场景维护多套配置模型映射model mapping把 OmniRoute 的模型路由映射到各工具。7.2 CLI Agentsv2.0.11CLI Agents 面板用于发现与管理 CLI 智能体官方文档列出内置的16 个 AgentCodex、Claude、Goose、OpenClaw、Aider、OpenCode、Cline、ForgeCode、Amazon Q、Open Interpreter、Cursor CLI、Warp、Windsurf、Devin CLI、Kimi Coding、Command Code中文版文档记载为 17 个含 Qwen Code以最新英文版 16 个为准。面板能力包括安装状态检测Installed / Not Found并检测版本号协议徽章标识 stdio、HTTP 等通信协议自定义 Agent 注册通过表单登记任意 CLI 工具名称、二进制路径、版本命令、spawn 参数CLI 指纹匹配按提供商开关匹配原生 CLI 请求签名以降低封号风险同时保留代理 IP本地 Devin 认证Devin CLI 使用本地devin auth login凭据无需浏览器 OAuth 流程。八、Context Relay跨账号轮换时的会话延续v3.5.5Context Relay 是一种组合策略解决的是对话中途账号轮换导致上下文断裂的问题。其机制是在活跃账号配额耗尽之前OmniRoute 在后台生成一份结构化交接摘要handoff summary当下一个请求解析到不同账号时这份摘要以system message的形式注入新账号得以携带完整上下文继续会话。配置项可在 combo 级或全局设置配置项含义默认值Handoff Threshold触发摘要生成的配额使用百分比85%Max Messages For Summary压缩多少最近的历史消息可调Summary Model生成交接摘要的可选覆盖模型可选缺省用默认模型官方文档说明Context Relay 目前支持Codex 账号轮换。更多细节见 Context Relay 相关架构说明英文版文档指向该文件中文版文档所引用的features/context-relay.md在当前仓库中位于docs/frameworks/之外的变更片段体系请以架构文档为准。九、Prompt CompressionRTK 与 Caveman 的压缩组合拳v3.7.9Context Cache 模块现在为三种压缩能力提供专门页面Caveman语言感知的规则包language-aware rule packs提供预览、输出模式控制与分析核心算法见 压缩引擎文档 与 压缩指南RTK命令感知压缩专门针对 shell、git、test、build、package、Docker、infra、JSON、stack-trace 输出详见 RTK 压缩文档Compression Combos命名管道如rtk - caveman可绑定到路由 combo 上。官方文档描述当两级引擎同时生效时默认叠加数学平均约89%、合格上下文节省区间78–95%此为项目文档口径具体收益取决于请求上下文构成Raw-output recovery可选的脱敏 RTK 原始输出指针用于压缩失败时的调试。十、安全与加固代理、隐私、出站防护与审计10.1 Proxy Hardening代理加固v3.5.5整个请求管道上的代理配置强制执行Token Health Check后台 OAuth 刷新现在按连接解析代理配置避免在必须走代理的环境中刷新失败API Key 校验提供商密钥校验POST /api/providers/validate经由runWithProxyContext执行同时遵守提供商级与全局代理设置undici Dispatcher 修复代理 dispatcher 使用 undici 自身的 fetch 实现而非 Node 内置 fetch解决了 Node.js 22 上的invalid onRequestStart method错误Node.js 版本检测登录页主动检测不兼容的 Node.js 版本24并显示警告横幅提示使用 Node 22 LTS。10.2 Email Privacy Masking邮箱隐私掩码v3.5.6OAuth 账号邮箱在提供商仪表盘中默认掩码例如di*****g****.com防止分享截图或录屏演示时意外泄露。完整邮箱仍可通过悬停 tooltiptitle属性查看新版还提供全局开关Settings → Appearance → Account email visibility可统一在 providers、combos、logs、quota、playground 各界面显示或掩码完整邮箱。10.3 Model Visibility Toggle模型可见性开关v3.5.6提供商页面的模型列表现在包含实时搜索/过滤栏快速定位特定模型逐模型可见性开关 图标隐藏的模型置灰并从/v1/models目录中排除活跃计数徽章N/M active一眼看清已启用/总数。10.4 OAuth Env RepairOAuth 环境修复v3.6.1Dashboard → Providers → [OAuth Provider] → Repair env一键修复缺失的 OAuth client 凭据、损坏的 env 文件条目、备份路径消毒。10.5 Safe Outbound Fetch 与 SSRF 防护v3.6.6所有提供商校验与模型发现出站调用都经过两层防护。第一层 URL 守卫实现在 src/shared/network/outboundUrlGuard.ts在 socket 建立之前拦截私网 / loopback / link-local 地址。源码细节值得注意支持public-only与block-metadata两种守卫模式block-metadata允许私网/局域网主机便于本地 OpenAI 兼容提供商校验但永远拒绝云元数据端点如169.254.169.254、metadata.google.internal、阿里云100.100.100.200等见 outboundUrlGuard.ts因为这是经典的 SSRF→IAM 凭据跳板对 IPv4-mapped IPv6 地址如::ffff:a9fe:a9fe做了嵌入式 IPv4 还原再判定避免绕过。第二层是安全 fetch 包装器 src/shared/network/safeOutboundFetch.ts应用 URL 守卫、规范化超时提供商探测默认OMNIROUTE_PROVIDER_PROBE_TIMEOUT_MS未配置时取 8000ms见 safeOutboundFetch.ts、对瞬时错误做指数退避重试内置validationRead、validationWrite、modelsProbe、modelsDiscovery、modelsPagination等预置策略见 safeOutboundFetch.ts并拦截 3xx 重定向。守卫违规以HTTP 422URL_GUARD_BLOCKED暴露同时写入合规审计日志经providerAudit.ts。错误码归一化在 getSafeOutboundFetchErrorStatus 中完成TIMEOUT→504、INVALID_URL/URL_GUARD_BLOCKED/REDIRECT_BLOCKED→503。10.6 Cooldown-Aware Retries冷却感知重试v3.6.6当上游返回模型级冷却时聊天请求现在自动重试。环境变量环境变量含义默认值REQUEST_RETRY重试次数2MAX_RETRY_INTERVAL_SEC最大重试间隔30 秒同时增强了限流头学习x-ratelimit-reset-requests、x-ratelimit-reset-tokens、Retry-After。每模型的冷却状态在 Resilience 面板可见支持从 UI 手动重新启用被锁定的模型。10.7 Compliance Audit v2合规审计 v2v3.6.6审计日志升级为游标分页、请求上下文富化request ID、user agent、IP、结构化认证事件、带 diff 上下文的提供商 CRUD 事件、SSRF 拦截校验日志。事件由 src/lib/compliance/providerAudit.ts 发出。从源码看该模块做了严谨的脱敏与告警提取summarizeProviderConnectionForAudit 会删除apiKey、accessToken、refreshToken、idToken以及providerSpecificData中的consoleApiKey、alibabaConsoleCookie、alibabaConsoleSecToken等敏感字段extractProviderWarnings 按模式如prompt injection detected、content filtered、safety filter、policy violation从响应负载中递归提取最多 5 条、单条 400 字符上限的告警文本。10.8 API Key Management 与 Audit LogAPI Key 管理创建、限定范围scope、吊销密钥每个密钥可限制到特定模型/提供商支持完全访问或只读权限可视化密钥管理并跟踪用量。v3.8 起还支持带managescope 的 Bearer 密钥可通过 API 执行管理操作Audit Log管理动作跟踪可按动作类型、操作者、目标、IP 地址、时间戳过滤形成完整安全事件历史。十一、Endpoint 与接入形态API、WebSocket、桌面与同步11.1 API Endpoint统一端点仪表盘的 Endpoint 页面展示你的统一 API 端点及能力分解Chat Completions、Responses API、Embeddings、Image Generation、Reranking、Audio Transcription、Text-to-Speech、Moderations以及已注册的 API 密钥。远程访问方面官方文档v3.8.x记载支持Cloudflare Quick Tunnel、Tailscale Funnel、ngrok Tunnel与云端代理。11.2 V1 WebSocket Bridgev3.6.6OmniRoute 支持OpenAI 兼容的 WebSocket 客户端通过/v1/wsupgrade 端点接入。自定义桥接服务scripts/v1-ws-bridge.mjs中文版文档写scripts/v1-ws-bridge.mjs英文版写scripts/dev/v1-ws-bridge.mjs包装 Next.js把 WS 连接升级为全双工双向流式会话。认证与 HTTP 请求一致API Key 或会话 Cookie。关键行为WS 升级在连接建立前由 src/lib/ws/handshake.ts 校验。从源码看握手认证支持三种类型api_key、session、nonetoken 可以从Authorization: Bearer头、URL 查询参数api_key/token/access_token或auth_tokenCookieJWT用JWT_SECRET验证中提取会话关闭或上游出错时流被干净终止与现有 HTTPSSE 流式路径并行共存。11.3 Sync Tokens 与 Config Bundlev3.6.6多设备与外部运维访问现在可通过受限同步令牌实现API作用POST /api/sync/tokens签发新同步令牌可限定范围、可选过期时间DELETE /api/sync/tokens/:id吊销令牌GET /api/sync/bundle下载所有非敏感设置的版本化 JSON 快照密码已脱敏带ETag配置包由 src/lib/sync/bundle.ts 构建包含 settings、providerConnections、providerNodes、modelAliases、combos、apiKeys、reasoningRoutingRules 七个部分。消费者对比ETag响应头即可判断是否有变化无需重复下载全量负载。源码细节令牌格式为osync_前缀 32 字节随机数base64url见 tokens.ts数据库中只存SHA-256 哈希原始明文只返回一次见 tokens.ts密钥读取支持x-sync-token头或Authorization: Bearer见 tokens.tsbundle 构建时对设置做password/requireLogin/cloudEnabled字段剔除bundle.ts对连接列表做稳定排序与字段白名单抽取保证序列化确定性——版本指纹由 serializeStableJson 对规范化后的 JSON 做 SHA-256 得到。11.4 GLM Thinking Presetv3.6.6GLM Thinkingglmt被注册为一等公民提供商65,536最大输出 Token、24,576思考预算、900 秒默认超时、Claude 兼容 API 格式、与 GLM 家族共享用量同步。同版本还引入混合 Token 计数当 Claude 兼容提供商暴露/messages/count_tokens时OmniRoute 会在大型请求前调用它失败时优雅回退到估算。11.5 Media媒体生成v2.0.3从仪表盘直接生成图片、视频、音乐官方支持列表OpenAI、xAI、Together、Hyperbolic、SD WebUI、ComfyUI、AnimateDiff、Stable Audio Open、MusicGen。v3.8 还扩展了 KIE 媒体目录含视频生成模型。11.6 卸载命令v3.6.2官方提供两档干净卸载脚本命令行为npm run uninstall移除系统应用但保留~/.omniroute中的数据库与配置npm run uninstall:full移除应用并永久擦除所有配置、密钥与数据库11.7 Desktop Application桌面应用原生 Electron 桌面应用支持 Windows / macOS / Linux可独立运行特性包括服务就绪轮询冷启动不出现白屏系统托盘与端口管理Content Security Policy单实例锁重启自动更新平台条件 UImacOS 红绿灯、Windows/Linux 默认标题栏加固的 Electron 构建打包v2.5.5独立 bundle 中的符号链接node_modules在打包前被检测并拒绝避免运行时依赖构建机优雅关闭v3.6.2Electronbefore-quit先干净关闭 Next.js防止 SQLite WAL 数据库锁。完整文档见 electron/README.md。11.8 Request Logs请求日志实时请求日志支持按提供商、模型、账号、API Key过滤展示状态码、Token 用量、延迟与响应详情。可用于排障与成本归因。十二、从文档到源码继续探索的路径如果你希望在部署后进一步深入理解或二次开发以下仓库路径是官方文档直接点名的关键入口WS 桥接认证src/lib/ws/handshake.tsauthorizeWebSocketHandshake与getWsRuntimeConfigwsAuth开关控制是否强制认证同步令牌与配置包src/lib/sync/tokens.ts、src/lib/sync/bundle.ts出站 SSRF 防护src/shared/network/outboundUrlGuard.ts守卫模式枚举、src/shared/network/safeOutboundFetch.ts预置重试策略合规审计src/lib/compliance/providerAudit.ts相关专题文档架构总览、压缩指南、RTK 压缩、压缩引擎、功能中文指南、Skills 框架、Memory 系统、Webhooks需要说明的是本文所述版本能力以仓库当前package.jsonv3.8.51见 package.json与官方功能画廊文档v3.8.40为准不同安装方式npm、Docker、Electron 桌面版在具体命令与环境变量上以对应指南为准。功能画廊文档的英文最新版与各语言译本分别位于 docs/guides/FEATURES.md 与 docs/i18n/ 目录下是持续更新的权威功能清单。【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 providers (150 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考