一、功能简介

代理节点（Proxy）是 Redis 实例的接入层组件，负责客户端连接管理、请求转发、负载均衡与路由，是实例高可用的关键一环。当单个或多个代理节点出现异常（如负载过高、健康状态异常、硬件老化）时，您可以通过代理节点替换功能，在控制台一键完成代理节点的替换，替换后的新节点会自动同步配置并重新接入集群，保障业务持续可用。

本功能支持：

• 单节点替换：对实例内的某一个代理节点单独发起替换。
• 批量替换：对实例内多个异常代理节点批量发起替换，一次完成集群内代理节点的整体恢复。

二、代理节点说明

实例中的代理节点具有如下特征：

项目	说明
节点数量	标准架构无代理；集群架构的代理节点随分片数线性增加
高可用	代理节点组件高可用，支持故障自动转移，代理节点故障时自动切换连接
自愈	系统支持拨测自愈能力，异常代理节点会自动进行健康检查与恢复
替换行为	替换代理节点会重建节点组件，替换期间连接产生短暂中断

三、功能限制与前提条件

在发起代理节点替换前，请确认满足以下条件：

条件	说明
实例状态	实例状态须为【运行中】
节点状态	仅支持更换节点状态正常的代理节点，存在当前执行中的节点提升、备节点提升等部署任务时不可操作
任务互斥	实例无正在进行的备份、扩容、迁移等任务，否则请在任务结束后再操作
网络条件	客户端具备自动重连能力，替换期间连接中断可自动恢复

四、操作步骤

4.1 进入节点管理

1. 登录百度智能云控制台，进入云数据库 Redis。
2. 在左侧导航选择目标地域，在实例列表中单击目标实例 ID / 名称，进入实例详情页。
3. 在左侧导航栏选择服务可用性，切换到代理节点（Proxy）页签，查看当前实例的代理节点列表及各节点状态。

4.2 单节点替换

1. 在代理节点列表中，找到需要替换的代理节点，点击操作列的【替换】。

2. 在弹出的替换确认窗口中，确认替换节点信息：

   • 执行时间：可选【立即执行】或【维护窗口执行】（在您设定的可维护时间内自动执行）；
   • 确认风险提示：替换期间连接中断时间小于 1 分钟，业务需具备自动重连能力；
3. 点击【确定】，提交替换任务。系统开始替换代理节点，节点状态变为【替换中】。

4.3 批量替换

1. 在代理节点列表中，勾选需要替换的多个代理节点（支持全选）。
2. 点击列表上方的【批量替换】，在弹出的确认窗口中确认替换数量与执行时间（立即执行/维护窗口执行）。
3. 点击【确定】，系统将对勾选节点逐个执行替换任务。

批量替换会逐个进行，避免多个节点同时替换造成集群整体不可用的风险。

4.4 查看替换任务

1. 替换任务提交后，可在实例详情页的【任务中心】中查看任务类型为【代理节点替换】的任务进度。
2. 任务执行完毕后，代理节点状态恢复为【运行中】，客户端连接自动恢复，即可正常访问。

五、相关API

六、错误/常见问题 FAQ

Q1：替换期间业务会中断多久？ 替换过程中代理节点重建会导致连接中断，连接中断时间小于 1 分钟。建议在低峰期执行，并确保业务配置了自动重连（Redis 客户端连接池配置好重试机制）。

Q2：为什么我提交替换提示失败？ 请检查：实例状态是否为【运行中】；是否存在备份、扩容、迁移等互斥任务；代理节点状态是否正常可替换。

Q3：替换后数据会不会丢失？ 不会。代理节点为接入层组件，不持有数据；数据仍保存在数据节点（分片）中，替换过程不影响数据持久化与缓存数据。

Q4：批量替换可以勾选全部节点吗？ 可以，但系统会逐个执行替换（串行执行），避免同时替换多个节点导致短时间连接全不可用。

Q5：替换任务的执行时间如何选择？ 如需立即处理故障，选择【立即执行】；如非紧急，建议选择【维护窗口执行】，在您设置的维护时间窗口内统一执行，避免影响白天业务高峰。