Redis 6+集群必须用redis-cli –cluster创建,最低需3主3从共6节点,须开放客户端端口及对应集群总线端口(+10000),配置正确但端口不通是常见失败原因。
Redis 6+ 原生集群模式必须用 redis-cli --cluster 创建
Redis 5.0 起废弃了 redis-trib.rb,现在所有集群初始化、扩缩容、故障转移都靠内置的 redis-cli --cluster 工具。如果你还在找 Ruby 环境配 redis-trib.rb,直接停手——它不兼容 Redis 6/7,默认启用 ACL 和 TLS 后更跑不通。
关键前提:6 个节点(3 主 3 从)是最低可用集群配置,少于这个数 redis-cli --cluster create 会拒绝执行,并报错 Cluster requires at least 3 master nodes。
- 每个节点需独立配置:
port、bind、cluster-enabled yes、cluster-config-file nodes.conf、cluster-node-timeout 5000 - 关闭
protected-mode yes(否则节点间握手失败,日志里反复出现Connection refused) -
appendonly yes强烈建议开启,否则故障恢复后可能丢数据
启动顺序和端口连通性比配置文件更关键
常见错误不是配置写错了,而是节点根本没真正“看见”彼此。先确保所有节点进程已运行且监听正确端口,再执行创建命令。用 ss -tlnp | grep :700[0-9] 确认每个 redis-server 进程都在监听对应端口(如 7000–7005),且没有被防火墙拦截。
Redis 集群通信不仅走客户端端口(如 7000),还额外占用 client_port + 10000 的集群总线端口(如 7000 对应 17000)。必须同时放行这两组端口,否则 redis-cli --cluster check 会卡在 Connecting to node 或报 IOERR connect。