如何快速搭建Redis 7.0高可用集群_通过redis-cli --cluster指令实现一键部署-Redis-PHP中文网

redis-cli --cluster create 初始化 redis 7.0 集群需满足四个前提：所有节点 redis-server 已启动且端口就绪；各节点 redis.conf 启用 cluster-enabled yes 且 cluster-config-file 可写；节点间 tcp 全连通；密码配置一致并正确传入 -a 和 --cluster-yes。

如何快速搭建redis 7.0高可用集群_通过redis-cli --cluster指令实现一键部署

直接用 redis-cli --cluster create 就能完成 Redis 7.0 集群初始化，但前提是 6 个节点已全部启动且配置正确；否则命令会卡住、报错或创建出不可用的“假集群”。

redis-cli --cluster create 命令必须满足的 4 个前提条件

这个命令不是“一键安装”，而是“一键初始化”。它只负责把已运行的节点组织成集群，不负责拉起进程、不校验配置、不处理网络连通性。常见失败都源于前置没做牢：

redis-server 进程必须已在所有目标端口（如 7000–7005）上运行，且日志中无 Failed to bind 或 Address already in use
每个节点的 redis.conf 必须启用集群模式：cluster-enabled yes，且 cluster-config-file 路径可写（否则启动失败静默退出）
所有节点需能互相 TCP 连通：从任意一台机器执行 telnet 127.0.0.1 7001（或对应 IP+端口）必须成功；Docker 环境尤其注意是否在同一个自定义网络内
若配置了密码，requirepass 和 masterauth 必须一致，且 redis-cli --cluster create 命令末尾要加 --cluster-yes 和 -a <password></password>，否则交互式确认阶段会认证失败

redis-cli --cluster create 的参数陷阱

看似简单的一条命令，几个参数选错会导致槽分配异常、主从关系错乱、甚至集群状态为 fail：

Redis Skill - 高性能缓存管理

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

下载

--cluster-replicas 1 表示每个主节点配 1 个从节点；6 个节点时，必须是偶数个节点才能整除（如 6 节点 → 3 主 3 从），填 2 就会报错 Invalid number of replicas
节点地址列表顺序无关，但必须写全所有 6 个地址（不能漏掉某个从节点的端口），否则该节点不会被纳入集群视图
不要加 --cluster-yes 以外的额外 flag（比如 --cluster-use-empty-masters），Redis 7.0 默认拒绝空 master，强行使用会导致后续 CLUSTER INFO 显示 cluster_state:fail
如果已有旧的 nodes-*.conf 文件残留，redis-server 启动时可能加载错误拓扑；建议每次重试前清空数据目录下的 nodes-*.conf 和 appendonly.aof

验证集群是否真正可用，别只看 cluster info

cluster info 显示 cluster_state:ok 只说明元数据一致，不代表读写正常。必须实测以下三点：

用 redis-cli -c -h 127.0.0.1 -p 7000 -a 123456 连入（-c 不可少），执行 SET testkey abc，再换端口连接（如 -p 7001）执行 GET testkey —— 若返回 -> Redirected to slot... 并最终拿到值，才算分片路由生效
检查槽分配是否均匀：redis-cli -c -p 7000 cluster nodes | grep master | wc -l 应等于主节点数；再对每个 master 执行 redis-cli -p <port> cluster countkeysinslot <slot_id></slot_id></port> 抽查几个槽，确认非零
模拟主节点宕机：kill -9 掉一个主节点进程，等待 30 秒后，用 redis-cli -p 7000 cluster nodes 查看原从节点是否已升为 master，且 cluster_state 仍为 ok

最容易被忽略的是：Redis Cluster 要求客户端必须支持 -c（集群模式）和重定向逻辑。普通 redis-cli 直连单节点执行 GET 会失败，这不是集群问题，而是客户端没走集群协议。生产环境务必确认 SDK 是否启用了集群支持（如 JedisCluster、lettuce 的 RedisClusterClient）。