如何在 Nacos 控制台手动上下线服务实例进行灰度发布？

Nacos 控制台支持在服务实例列表中手动启用或禁用实例，该操作会立即改变实例的健康状态。此方法适合全量发布切换或紧急隔离，不适用于需要按流量比例分发的细粒度灰度场景，风险在于禁用后该实例将不再接收任何请求。

先说结论：通过控制台手动上下线实例可实现粗粒度的版本切换，但并非标准的流量灰度方案。

界面操作速用版

Nacos 控制台为图形化界面，无需命令，按以下路径快速定位操作入口：

登录控制台 > 服务管理 > 服务列表 > 点击目标服务名 > 实例列表 > 点击操作列的“编辑”或切换开关。

手动禁用实例会直接修改 Nacos 服务端存储的实例健康状态，消费者拉取列表时会过滤掉禁用实例。

Nacos 客户端默认只订阅健康实例列表。当你在控制台将实例标记为“禁用”或“下线”时，服务端将该实例的健康状态置为 false。消费者端下次拉取服务列表或收到推送时，会将该实例从本地缓存移除，从而停止向其发送请求。这属于服务发现层面的隔离，而非流量网关层面的权重控制。

按以下步骤在 Nacos 控制台手动操作实例上下线，每步需确认状态变化：

步骤 1：登录并定位服务
访问 Nacos 控制台地址，进入“服务管理”菜单下的“服务列表”。在搜索框输入目标服务名称，点击服务名进入详情页。

步骤 2：查看实例状态
在“实例列表”标签页，确认当前实例的 IP、端口及健康状态。健康实例通常显示为绿色，异常或不健康显示为红色或灰色。

步骤 3：执行上下线操作
找到目标实例，点击操作列的“编辑”按钮。在弹窗中找到“是否启用”或“健康状态”选项，取消勾选或选择“禁用”，点击确认。部分版本支持直接点击开关切换。

步骤 4：观察状态刷新
操作完成后，实例列表中的状态应立即变为“禁用”或颜色变灰。若未变化，刷新页面确认服务端已持久化配置。

回滚提醒：若发现业务报错率上升，立即按相同路径将实例重新启用，恢复健康状态。

通过控制台状态颜色和消费者日志双重确认流量是否切断。

1. 控制台检查
返回 Nacos 控制台实例列表，被禁用的实例健康状态应显示为“不健康”或“禁用”，颜色通常为灰色或红色，不再显示绿色健康标识。

2. 消费者日志检查
查看调用该服务的消费者应用日志。确认请求不再分发到被禁用实例的 IP 地址。若开启 debug 日志，可观察 Nacos 客户端拉取的服务列表是否已移除该 IP。

3. 链路追踪检查
若有 SkyWalking 或 Zipkin 等链路追踪系统，查询当前时间段的服务调用拓扑，确认被禁用实例不再出现在调用节点中。

手动上下线实例时需注意客户端缓存和健康检查机制的干扰，避免操作无效或误伤。

通常在秒级内生效，具体取决于消费者客户端的缓存刷新间隔。

不能，手动上下线只能控制实例有无流量，无法精确控制 10% 或 50% 的流量比例。

不会自动恢复，除非手动重新启用，或健康检查机制覆盖了手动状态。