**OctaFuse Gateway 2.2.0 正式发布。** 这次升级聚焦一件事：让路由配置更贴近真实的生产流量。


当一个模型同时接入多个账号、多个供应商或多条备用链路时，“先走谁、同层怎么选、失败后往哪里切”不应该是一组藏在代码里的隐含规则。2.2.0 把这些决策继续下沉到 Route Pool 的 priority 层，同时统一 Gemini 的流式与非流式路由语义，让配置、执行与日志看到的是同一套结构。

> 一句话看懂 2.2.0：**一套 Gemini 路由，同时服务流式与非流式请求；一个 Route Pool，可以为不同 priority 层选择不同策略。**

本次版本还统一了路由策略名称，升级了 Admin 的可视化策略编辑，并重新设计 Agent Tools Provider 的配置入口，让凭证、启用状态与三账本定价更容易核对。

## 01｜Gemini 路由：从两套配置收敛为一套

过去，Gemini 的 `generateContent` 与 `streamGenerateContent` 会以两个 operation 出现在路由配置中。它们在客户端侧确实是两个 action，但从网关治理视角看，通常属于同一个能力、共享同一组上游和故障转移策略。

![Gemini 路由统一使用 models.generate operation](https://developer.qcloudimg.com/http-save/yehe-1258501/b19409c5c138320ad0cc2b589605fd23.png)

*Gemini 流式与非流式请求统一配置为 `models.generate`，实际 action 仍由 Proxy 根据请求生成。*

2.2.0 将公开 Surface 与上游 Target 的配置统一为：

```text
models.generate
```

现在，一次 Surface / Pool 配置即可同时服务流式与非流式请求。Proxy 仍会根据客户端请求生成真实的上游 action：

- 非流式请求使用 `generateContent`
- 流式请求使用 `streamGenerateContent`
- 实际 action 写入 `route_trace.gemini.action`，排障时依然清晰可见

这意味着路由配置更少、流式与非流式行为更一致，也减少了两套 Pool 长期漂移的风险。客户端 URL 保持不变，现有 Gemini SDK 与调用方式无需调整。

## 02｜按 priority 层配置策略

Route Pool 原本已经支持 priority 分层：高优先级上游全部失败后，才会进入下一层。但在 2.2.0 之前，一个 Pool 内的所有层共享同一套路由策略。

![Route Pool priority 分层与 Failover 拓扑](https://developer.qcloudimg.com/http-save/yehe-1258501/69732f6dcbafcb71c1dcf91385c5f054.png)

*同一个模型可以拥有多个 Route group；每个 Pool 内按 priority 组织首选层与备用层。*

现在，你可以为每个 priority 层分别选择排序方式：

| 策略 | 适合场景 |
| --- | --- |
| `cache_affinity` | 稳定命中首选上游，提高 Prompt Cache 命中率 |
| `weighted_random` | 按权重随机分配流量，适合灰度与容量分摊 |
| `fixed_order` | 严格按固定顺序尝试，适合主备链路 |
| `weighted_round_robin` | 按权重轮转，适合更均匀、可预期的流量分配 |

![Priority 层策略选择与生效预览](https://developer.qcloudimg.com/http-save/yehe-1258501/daf69c1c3a9fda9241e91faa1960e978.png)

*策略选择器会说明适用场景、取舍、生效来源，并在保存前展示当前层的实际排序效果。*

例如，同一个 Route Pool 可以这样组织：

- **P0 主力层**：使用 `weighted_round_robin`，在多个稳定账号之间分摊流量
- **P10 备用层**：使用 `fixed_order`，优先低成本备用，再进入保底上游

如果某一层没有单独设置策略，它会继续继承 Pool、模型或全局配置。你可以只覆盖真正需要差异化的层，不必重复维护整套规则。

## 03｜策略名称统一，配置即语义

本次版本将策略 ID 统一为更明确的 canonical 名称：

| 旧 ID | 2.2.0 canonical ID |
| --- | --- |
| `affinity` | `cache_affinity` |
| `strict` | `fixed_order` |
| `round_robin` | `weighted_round_robin` |
| `weighted_random` | `weighted_random` |

新名称直接表达策略行为，也为 Admin、API、数据库与运行时建立了统一契约。

需要特别注意：**2.2.0 不再接受三个旧 ID。** 数据库迁移会改写已持久化的配置；如果你有外部自动化直接调用 Admin API 或写入配置，也必须同步使用新名称。

## 04｜Admin：看得见策略来源，也看得懂 Failover

Routes 页面同步升级了策略编辑体验：

- 全局、Pool 与 priority 层统一使用可视化策略选择器
- 每一层都能查看当前生效策略及其来源
- Failover 规则可以在配置现场直接查看
- Gemini Provider 新配置优先写入单一 `models.generate` URL 模板
- 无法安全合并的历史 Gemini 双模板会被保留，并提示人工复核

我们的目标不是把更多配置项塞进页面，而是让运维人员在修改前就能回答：**这层现在按什么顺序走？配置从哪里继承？失败后会切到哪里？**

## 05｜Agent Tools Provider：凭证、价格与启用状态放在一起

2.2.0 也重新设计了 Agent Tools Provider 卡片。现在可以通过卡片与右侧抽屉集中维护：

![Agent Tools Provider 配置总览](https://developer.qcloudimg.com/http-save/yehe-1258501/c3e5a14a783430cd66ae82ed8b55690c.png)

*Web Search、Web Fetch、Deep Search 与 AI Detection 的 Active Provider、凭证状态和三账本价格集中呈现。*

- Provider 凭证
- Standard / Charged / Metered 三账本单价
- “仅保存配置”或“保存并启用”
- 未保存、缺少凭证、服务不可用与亏损定价提示

对于 Web Search、Web Fetch、Deep Search、AI Detection 这类按调用量计费的 Agent 能力，配置是否完整、售价是否覆盖成本、当前 Provider 是否真正启用，都可以在同一处完成核对。

## 升级前必读

- 如果此前的路由策略全部继承自全局配置，可以平滑升级到 2.2.0。
- 如果存在模型、Pool 或 priority 层的独立策略配置，升级期间可能短暂出现因新旧数据不一致导致的请求错误。建议在同一维护窗口内完成数据库迁移，并同步升级 Proxy 与 Admin。

## 获取 2.2.0

- [GitHub Release v2.2.0](https://github.com/OctaFuse/octafuse-gateway/releases/tag/v2.2.0)
- [完整 Changelog](https://github.com/OctaFuse/octafuse-gateway/blob/v2.2.0/CHANGELOG.md)
- [2.2.0 迁移索引](https://github.com/OctaFuse/octafuse-gateway/blob/v2.2.0/docs/operators/README.md)
- [Docker 部署与升级](https://github.com/OctaFuse/octafuse-gateway/blob/v2.2.0/docs/operators/deployment/docker.md)
- [Cloudflare 部署与升级](https://github.com/OctaFuse/octafuse-gateway/blob/v2.2.0/docs/operators/deployment/cloudflare.md)

OctaFuse 是一个可自托管的开源 AI 能力网关与运营控制面。它把模型、图片、语音与 Agent Tools 接入统一入口，并提供路由、密钥、预算、计费、日志和审计能力。

如果你正在管理多个模型供应商、多个账号或复杂的主备链路，欢迎升级到 2.2.0，也欢迎在 [GitHub Issues](https://github.com/OctaFuse/octafuse-gateway/issues) 分享你的使用场景与反馈。

最后，如果您觉得这个项目不错，顺手给个 Star 支持一下，您的支持是持续更新的动力～



OctaFuse Gateway 2.2.0 正式发布。 这次升级聚焦一件事：让路由配置更贴近真实的生产流量。

OctaFuse Gateway 2.2.0：让每一层路由都有自己的策略

云计算

后端

开发工具

OctaFuseGateway2.2.0发布，聚焦生产流量路由优化。Gemini流式与非流式统一为models.generate配置，RoutePool支持按priority层独立选择策略（如cache_affinity、weighted_random），统一策略命名，升级Admin可视化编辑与AgentToolsProvider配置。平滑升级需注意数据库迁移。

代码解释

数据库

路由

Agent

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OctaFuseGateway2.2.0发布，聚焦生产流量路由优化。Gemini流式与非流式统一为models.generate配置，RoutePool支持按priority层独立选择策略（如cache_affinity、weighted_random），统一策略命名，升级Admin可视化编辑与AgentToolsPr...

OctaFuse Gateway 2.2.0：让每一层路由都有自己的策略-腾讯云开发者社区-腾讯云

OctaFuse Gateway 2.2.0：让每一层路由都有自己的策略

OctaFuse Gateway 2.2.0：让每一层路由都有自己的策略

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐