config set 仅能热更新 timeout、maxmemory 等少数运行时参数；cluster-node-timeout 等集群关键配置虽支持命令但实际不生效，必须滚动重启节点并同步 redis.conf 与防火墙规则。

CONFIG SET 命令只能修改部分运行时参数，绝大多数集群相关配置无法热更新——比如 cluster-enabled、cluster-config-file、cluster-node-timeout 这些关键项，改了也不会生效，必须重启节点。

---

cluster-node-timeout 看似可改，但实际无效

Redis 文档里写 cluster-node-timeout 支持 CONFIG SET，但实测在 6.0+ 版本中：

• 执行 CONFIG SET cluster-node-timeout 20000 不报错
• CONFIG GET cluster-node-timeout 返回新值，看起来成功了
• 但 CLUSTER NODES 输出的节点状态、故障检测行为仍按旧值（如 15000）运行
• 查看源码可知：该参数只在节点启动时读取一次，后续不 reload

所以别被 CONFIG GET 的返回值骗了——它只是缓存了你设的值，没真正重载逻辑。

---

哪些集群参数真能热更新？

极少数不影响集群拓扑和通信机制的参数可以生效，例如：

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• timeout（客户端空闲断连时间）
• maxmemory（配合 maxmemory-policy）
• slowlog-log-slower-than、slowlog-max-len
• notify-keyspace-events

但注意：requirepass 和 masterauth 虽然能 CONFIG SET，但如果集群已有主从连接，已建立的复制链路不会自动重认证，会导致后续同步失败，必须手动 REPLICAOF 重连。

---

修改集群配置的唯一可靠路径

想改 cluster-enabled、cluster-node-timeout、bind、port 等，必须：

• 编辑每个节点的 redis.conf 文件
• 确保所有节点配置一致（尤其是 cluster-config-file 路径不能冲突）
• 逐个滚动重启节点：先 redis-cli -p 7001 CLUSTER FAILOVER 把主切走，再停该节点，启动新配置；避免整个集群不可用
• 重启后检查 CLUSTER INFO 中的 cluster_state 和 cluster_slots_assigned 是否正常

最易被忽略的是：集群总线端口（port + 10000）的防火墙规则必须同步更新，否则节点握手失败，CLUSTER NODES 会显示大量 fail? 状态。