redis cluster必须显式启用、初始化并严格满足节点与槽位规则,否则会clusterdown或拒绝写入;关键配置包括cluster-enabled yes、唯一cluster-config-file、合理cluster-node-timeout、cluster-require-full-coverage no、正确bind和protected-mode no。

Redis Cluster 不是“开启某个开关就能自动高可用”,它必须显式启用、手动初始化、严格满足节点数和槽位分配规则,否则会卡在 CLUSTERDOWN 或拒绝写入。
redis.conf 里必须设对的几项 cluster 配置
单个 Redis 实例要参与集群,redis.conf 中以下配置缺一不可,且值不能随意改:
-
cluster-enabled yes:必须开启,注释掉或设为no就只是普通实例 -
cluster-config-file nodes-7000.conf:每个实例必须有**唯一文件名**(端口要对应),不能所有节点共用同一个文件,否则启动时会报Invalid or no cluster configuration file -
cluster-node-timeout 15000:建议设为 15000ms(15秒)以上,太小容易因网络抖动误判节点下线;太大会延长故障转移时间 -
cluster-require-full-coverage no:关键!默认是yes,一旦有任意一个哈希槽没被分配,整个集群拒绝写入。测试/开发环境务必改成no,否则cluster nodes看到全是fail却找不到原因 -
bind 0.0.0.0或明确绑定内网 IP(如bind 192.168.1.100):不能只写127.0.0.1,否则其他节点无法通过该地址握手 -
protected-mode no:若启用了保护模式又没配密码,集群节点间meet会失败,提示DENIED Redis is running in protected mode
启动 6 个实例后为什么还是孤立节点?
启动 6 个带 cluster-enabled yes 的 Redis 进程,只是“准备好加入集群”,它们彼此不认识。必须主动让它们建立连接:
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。
- 用
redis-cli -p 7000 cluster meet 127.0.0.1 7001让 7000 和 7001 握手,再依次meet其余节点(7002~7005) - 更稳妥的做法是用
redis-cli --cluster create一次性完成握手 + 槽分配:redis-cli --cluster create 127.0.0.1:7000 127.0.0.1:7001 ... 127.0.0.1:7005 --cluster-replicas 1 - 如果执行
create报错Node is not empty,说明该端口已有 RDB/AOF 文件或旧nodes-*.conf,需清空dir目录或换新目录 - 执行完
create后,立刻用redis-cli -c -p 7000 cluster nodes查看,每行末尾应有master或slave标识,且没有fail状态
为什么写入报错 MOVED 或 CLUSTERDOWN?
这两个错误背后原因完全不同,别混淆:
-
MOVED 12345 127.0.0.1:7002:正常现象。说明 key 落在 12345 号槽,当前节点不负责,客户端需重定向。使用-c参数启动redis-cli(即redis-cli -c -p 7000)才能自动跳转;普通redis-cli不支持重定向,会直接报错 -
CLUSTERDOWN Hash slot not served:说明至少有一个哈希槽没被任何 master 节点服务。常见于:--cluster create执行中途失败、手动meet后忘了addslots、或某个 master 宕机且没从节点顶上。用redis-cli -p 7000 cluster info查cluster_state:ok和cluster_slots_assigned:16384两个字段确认 - 注意:Redis Cluster **不支持 SELECT 切库**,所有操作都在 db 0;也不支持多键命令(如
mget跨槽 key),会报CROSSSLOT
实际部署时最容易被忽略的三个细节
不是配置写对就万事大吉,这些点线上出过多次故障:
- 每个实例的
dir必须指向**独立目录**,不能多个实例共用同一dir。否则 RDB/AOF 文件会互相覆盖,nodes-*.conf写入冲突,启动直接失败 - 集群通信走的是「集群总线端口」:在客户端端口(如 7000)基础上 +1000,即 7000 实例还需开放 8000 端口。云服务器安全组/防火墙必须放行这批 +1000 端口,否则节点间心跳超时,状态变
fail - 加节点或迁移槽位时,
redis-cli --cluster reshard和--cluster rebalance是在线操作,但期间部分槽会短暂不可写。务必避开业务高峰,并提前确认目标节点内存充足——迁移大 key 可能触发 OOM










