文档中心

API 网关

注册中心类型 Upstream

管理注册中心类型 Upstream 版本

对于注册中心 Nacos 类型 Upstream，通过 Nacos 服务的 metadata，配置不同的灰度版本，可以对注册中心内的服务进行灰度发布，进行多版本管理功能。

背景信息

注册中心类型 Upstream 版本是指在注册中心 Nacos 类型的 Upstream 中，基于 Nacos 服务的 metadata 划分出的灰度版本。每个 Upstream 版本对应 Nacos 服务中一组具有相同 metadata 标记的实例，用于在网关侧对同一后端服务的不同版本进行流量管理。

灰度发布：将部分流量切换到新版本进行验证，确认无误后逐步扩大流量比例，实现平滑升级。

蓝绿部署：同时运行两个版本的应用。蓝绿部署期间，将生产环境和预发布环境分别配置为不同的 Upstream 版本，通过切换路由权重实现零停机发布和快速回滚。

如需了解 Upstream 版本在蓝绿发布、灰度发布场景下的端到端配置流程，可参见通过控制台实现 Nacos 蓝绿部署和灰度发布。

添加 Upstream 版本

根据 Nacos 应用的 metadata，配置相应的灰度版本。

在实例管理中选择目标实例后，单击 Upstream 列表。在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

在灰度版本区域，单击新增灰度版本。在弹出的新增灰度版本对话框中，设置版本信息。

配置项	说明
版本名称	自定义名称，用于标识该灰度版本。名称长度限制为 2～63 个字符。字符中只能包含大小写字母、数字和中划线-。不能以中划线-开头。同一 Upstream 下版本名称唯一。
标签	填写当前版本在 Nacos 服务中对应的 metadata（key:value）。您需要根据实际业务的注册信息中选择一个键值对，作为划分当前版本的依据。一般存在于环境变量或 SDK 中。注意请务必保证标签的正确性。标签填写错误将导致流量无法转发至当前版本。相同的标签仅支持配置一个灰度版本。

单击确定，完成灰度版本配置。

编辑 Upstream 版本

如果您修改了 Nacos 服务的 metadata，需要在网关侧同步修改当前灰度版本对应的标签。

在实例管理中选择目标实例后，单击 Upstream 列表。在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

在灰度版本表格中，选择要修改的灰度版本，单击操作列的编辑按钮。

修改标签的键值对，修改完成后单击确定。

删除 Upstream 版本

如果您在 Nacos 服务的 metadata 已废弃或删除，可删除当前灰度版本。

注意

删除灰度版本前，必须删除当前灰度版本关联的所有路由。

在实例管理中选择目标实例后，单击 Upstream 列表。在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。

在灰度版本表格中，选择要删除的灰度版本，单击操作列的删除按钮。

在弹出的二次确认框中，单击删除，删除当前灰度版本。

最近更新时间：2026.06.10 14:07:00

这个页面对您有帮助吗？

有用

无用