Higress Console 2.1.11 发布解析插件镜像自定义、AI 服务高级配置与可观测性优化【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress本篇技术指南基于 Higress 仓库 release-notes/2.1.11/README.md 与 release-notes/2.1.11/README_ZH.md 两份发布说明展开系统解读 Higress Console 2.1.11 版本包含的 6 项更新4 项新功能、2 项 Bug 修复并结合作者仓库内的 ai-statistics 插件源码、mcp-server 插件发布目录等实现证据进行纵深分析。读者阅读完本文后将掌握如何通过环境变量自定义插件镜像位置、如何为智谱 AIZhipu AI与 Claude 配置高级选项、如何为 ai-statistics 插件启用轻量模式以优化生产环境性能以及本次镜像路径修正与 Swagger UI 修复的来龙去脉。一、版本概览一次面向可配置性与 AI 场景的集中更新Higress Console 2.1.11 是一次小而聚焦的版本发布共包含6项变更分布如下类型数量涉及 PR新功能Features4#666、#665、#661、#657Bug 修复Bug Fixes2#662、#654总计6-从变更内容来看本次发布的核心脉络非常清晰围绕 AI 网关场景增强系统可配置性。四项新功能分别覆盖插件镜像源自定义#666、AI 服务高级选项#665、ai-statistics 插件轻量模式#661与路由管理界面多条件筛选#657两项修复则解决了 mcp-server 插件镜像路径与新插件目录结构不一致#662、Swagger UI 展示空请求体#654两个直接影响日常使用的问题。贡献者主要包括 johnlanni、liangziccc 与 fgksking。下文按新功能 → Bug 修复的顺序逐一展开。二、新功能详解2.1 插件镜像源可自定义pluginImageRegistry 与 pluginImageNamespacePR #666变更内容本 PR 为内置插件新增了pluginImageRegistry镜像仓库与pluginImageNamespace命名空间两个配置项的支持并允许通过环境变量直接指定这些配置。这意味着用户无需修改plugins.properties文件即可灵活定制插件镜像的位置。价值与应用场景对于企业私有化部署通常需要将插件镜像同步到自建或内网镜像仓库如 Harbor、阿里云 ACR 等以绕过公网拉取限制或满足合规要求对于多租户 / 多环境开发、预发、生产隔离的场景不同环境可能使用不同的镜像命名空间通过环境变量注入配置可以避免直接改动plugins.properties文件降低配置漂移风险也便于通过 CI/CD 流水线统一注入。与仓库现状的印证插件镜像的组织结构在 Higress 发布体系中已有明确体现。在 plugins/release/catalog.json 中mcp-server等插件以image: plugins/mcp-server的形式登记镜像名而 plugins/release/snapshots/2.2.5.json 中则记录了实际 OCI 引用higress-registry.cn-hangzhou.cr.aliyuncs.com/plugins/mcp-server:2.0.2可见镜像地址由仓库域名 命名空间 镜像名 版本组成。pluginImageRegistry与pluginImageNamespace正是将其中最常变化的仓库域名与命名空间两段抽离为可配置项从而让用户在不触碰plugins.properties的前提下完成镜像源的切换。2.2 智谱 AI 与 Claude 高级配置选项PR #665变更内容本 PR 为Zhipu AI智谱 AI与Claude两类 AI 服务引入了高级配置选项主要包括自定义域custom domains允许用户将 AI 服务的请求指向自定义域名或网关地址适用于通过 Higress 做 AI 服务聚合、走私有化出口或对接代理的场景代码计划模式切换code plan mode switching用于控制 AI 服务的代码生成行为模式满足需要优化代码生成能力的开发场景API 版本设置API version settings显式指定所调用 AI 服务的 API 版本避免因上游接口版本演进导致行为不一致。价值与应用场景这些配置将 AI 服务接入的控制粒度从可用/不可用提升到精确行为控制。例如在内部研发平台接入 Claude 时可以指定走公司内部的 API 网关域名、锁定 API 版本从而保证代码生成行为稳定可复现接入智谱 AI 时则可针对不同业务线切换不同的计划模式。2.3 ai-statistics 插件轻量模式use_default_response_attributesPR #661变更内容本 PR 为ai-statistics 插件配置启用了轻量模式新增USE_DEFAULT_RESPONSE_ATTRIBUTES常量并在AiRouteServiceImpl中应用该设置。轻量模式解决了什么问题ai-statistics 插件默认会提取question、answer、reasoning、tool_calls等大字段这需要缓冲完整的流式响应体在高并发、高延迟的生产环境下会带来明显的内存与性能开销。轻量模式的目标是只保留 Token 统计等必要信息放弃大字段提取。源码级印证在 plugins/wasm-go/extensions/ai-statistics/main.go 中getDefaultResponseAttributes()的注释明确写道这是为高并发、高延迟的生产环境设计的轻量默认属性配置其策略为缓冲请求体以提取 model 字段必要的小字段不提取question、system、messages等大字段不缓冲流式响应体因此不提取answer、reasoning、tool_calls仅从响应上下文中提取 Token 统计信息。对应的默认属性集只包含四个轻量字段见 main.go内置 Key含义来源reasoning_tokens推理 Token 数如 o1 模型响应上下文无需缓冲cached_tokens缓存命中的 Token 数响应上下文无需缓冲input_token_details完整输入 Token 明细对象响应上下文无需缓冲output_token_details完整输出 Token 明细对象响应上下文无需缓冲配置启用方式在 ai-statistics 插件的 WasmPlugin 配置中设置apiVersion: extensions.higress.io/v1alpha1 kind: WasmPlugin metadata: name: ai-statistics spec: defaultConfig: use_default_response_attributes: true解析逻辑佐证在 main.go 的parseConfig中插件会依次检查use_default_attributes与use_default_response_attributes两个开关开启use_default_response_attributes时调用getDefaultResponseAttributes()并打印日志Using default response attributes configuration (lightweight mode)轻量模式下若未显式配置value_length_limit默认值收敛为4000而完整默认属性模式的默认值高达 10MB 缓冲上限进一步印证了减少响应属性缓冲、提升系统效率的设计目标。关于 USE_DEFAULT_RESPONSE_ATTRIBUTES 常量PR 描述中提到的该常量位于 Higress Console 侧AiRouteServiceImpl用于在控制台创建/编辑 AI 路由时默认下发use_default_response_attributes: true的轻量配置实现生产环境默认开箱即用的效果。价值与应用场景轻量模式尤其适合对问题/答案内容无强审计需求、但需要 Token 计量与成本统计的规模化生产流量若需要完整的对话内容留痕可关闭该开关并配合 plugins/wasm-go/extensions/ai-statistics/README_EN.md 中的内置属性question、answer、tool_calls、reasoning进行完整提取。2.4 路由管理多条件筛选多选下拉替代输入框搜索PR #657变更内容本 PR 移除了原有基于输入框的搜索功能新增了针对路由名称、域名等多个属性的多选下拉筛选框并同步实现了中英文语言适配。价值与应用场景当网关中路由数量庞大时基于模糊关键词的输入框搜索难以精确命中目标改为多选下拉后用户可以按路由名 域名 其他属性自由组合筛选条件精确定位并管理特定路由中英文适配保证了控制台在两种语言环境下的使用一致性提升国际化用户体验。三、Bug 修复详解3.1 mcp-server OCI 镜像路径修正从mcp-server/all-in-one到plugins/mcp-serverPR #662变更内容本 PR 将 mcp-server 的 OCI 镜像路径从mcp-server/all-in-one修正为plugins/mcp-server以匹配新的插件目录结构。问题背景随着 Higress 插件体系向统一目录结构演进所有插件镜像统一归入plugins/命名空间下。旧的mcp-server/all-in-one路径与新的插件结构不一致若控制台仍按旧路径拉取镜像将导致部署或运行时报镜像不存在/路径错误。仓库证据交叉验证当前仓库中恰好可以同时看到新旧两种路径的痕迹直观印证了这一迁移方向旧路径残留在 pkg/config/envs.go 中环境变量MCP_SERVER_WASM_IMAGE_URL的默认值仍为oci://higress-registry.cn-hangzhou.cr.aliyuncs.com/mcp-server/all-in-one:1.0.0新路径事实在 plugins/release/catalog.json 中mcp-server 的登记镜像名为plugins/mcp-serverplugins/release/snapshots/2.2.5.json 中记录的 OCI 引用为higress-registry.cn-hangzhou.cr.aliyuncs.com/plugins/mcp-server:2.0.2新路径使用示例在 plugins/wasm-go/extensions/mcp-server/README_EN.md 中推荐配置为url: oci://higress-registry.cn-hangzhou.cr.aliyuncs.com/plugins/mcp-server:version。实践建议升级 Console 到 2.1.11 后请检查存量 mcp-server 插件配置中的镜像 URL 是否仍指向旧路径mcp-server/all-in-one如有则需迁移到plugins/mcp-server若通过环境变量注入镜像地址如上述MCP_SERVER_WASM_IMAGE_URL也需同步更新为新的镜像路径。3.2 Swagger UI 空请求体显示修复PR #654变更内容本 PR 通过升级 springdoc 内置的 swagger-ui 依赖解决了Swagger UI 中请求体显示为空的问题保证 API 文档的准确性。问题背景Higress Console 后端基于 Spring Boot springdoc 生成 OpenAPI 文档。旧版 swagger-ui 存在渲染缺陷导致带有请求体的接口在 Swagger UI 中展示为空即接口测试时无法看到、无法编辑请求体。价值修复后接口测试与实际使用保持一致开发者可以信任控制台生成的 API 文档并直接在 Swagger UI 中进行请求调试提升了开发者体验与联调效率。四、升级与验证建议升级 Console将 Higress Console 升级到 2.1.11 版本后重启控制台服务以使 swagger-ui 依赖升级#654与路由筛选界面#657生效。自定义插件镜像源若部署环境需要内网镜像仓库可通过环境变量设置pluginImageRegistry与pluginImageNamespace无需修改plugins.properties对应 PR #666。AI 服务接入在控制台配置智谱 AI 或 Claude 时按需填写自定义域、代码计划模式与 API 版本对应 PR #665。AI 路由性能调优生产环境建议在 ai-statistics 插件配置中开启use_default_response_attributes: true启用轻量模式以降低响应属性缓冲开销对应 PR #661需要完整对话审计时可关闭该开关改用内置属性提取。校验 mcp-server 镜像路径确认 mcp-server 插件的 OCI 镜像路径已迁移至plugins/mcp-server对应 PR #662。五、总结Higress Console 2.1.11 虽仅含 6 项变更但每一项都指向明确的使用痛点插件镜像源可配置化降低了私有化部署门槛智谱 AI 与 Claude 高级选项提升了 AI 服务接入的精确控制能力ai-statistics 轻量模式为生产环境的 AI 可观测性提供了性能更优的默认选择路由多条件筛选优化了大规模网关的管理体验两项修复则分别消除了 mcp-server 镜像路径与目录结构不一致的部署隐患以及 Swagger UI 请求体显示异常的问题。对于正在使用 Higress AI 网关、尤其是以控制台为主要管理入口的团队本版本值得尽快跟进升级。【免费下载链接】higress AI Gateway | AI Native API Gateway项目地址: https://gitcode.com/GitHub_Trending/hi/higress创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考