CentOS 7 部署 Redis 7.0 集群的核心难点是 GCC ≥9.3 编译兼容性、6 节点全部独立启动且配置隔离、redis-cli --cluster create 命令必须带 --cluster-replicas 1 参数并确保 IP 可达;缺一即导致集群创建失败或状态为 fail。

CentOS 7 上部署 Redis 7.0 集群,核心难点不在配置本身,而在环境兼容性和节点初始化逻辑。GCC 版本低于 9.3、cluster-enabled 开启后未清空旧 nodes-*.conf、6 个节点未全部启动就执行 redis-cli --cluster create——这三类问题占实际部署失败的 80% 以上。
GCC 9.3+ 是硬门槛,yum install devtoolset-x 基本无效
CentOS 7 默认 gcc --version 输出 4.8.5,而 Redis 7.0 编译时会触发 std::filesystem 等 C++17 特性,直接报错:error: ‘filesystem’ is not a member of ‘std’。
- 别信
yum install devtoolset-9——它只改 shell 环境变量,make 过程中仍调用系统默认 gcc - 正确做法:临时切换编译器路径,再 make
sudo scl enable devtoolset-9 bash
然后在该子 shell 中执行make && make PREFIX=/usr/local/redis install - 验证:进入
/usr/local/redis/bin后运行./redis-server --version,输出含Redis server v=7.0.x即成功
六个节点必须全部独立启动,且 port + cluster-config-file 严格隔离
Redis 集群要求至少 3 主 3 从(共 6 节点),任意一个节点未就绪,redis-cli --cluster create 就会卡在 “Waiting for the cluster to join…” 或报错 Node x.x.x.x:xxxx is not ready。
- 每个节点目录必须完全独立,不能共用同一份
redis.conf模板文件(否则cluster-config-file冲突) - 推荐结构:
/opt/redis-cluster/7001/redis.conf、/opt/redis-cluster/7002/redis.conf…,其中关键项逐节点替换:port 7001cluster-config-file nodes-7001.confpidfile /var/run/redis_7001.piddir /opt/redis-cluster/7001 - 启动命令必须带绝对路径配置文件:
/usr/local/redis/bin/redis-server /opt/redis-cluster/7001/redis.conf,不能只写redis-server
创建集群时 --cluster-replicas 1 参数不能省,且节点 IP 必须可路由
执行 redis-cli --cluster create 时若漏掉 --cluster-replicas 1,Redis 会默认尝试 0 从节点,导致只有 3 个主节点上线,集群状态为 fail(CLUSTER INFO 返回 cluster_state:fail)。
- 命令格式(假设 6 个节点都在本机):
/usr/local/redis/bin/redis-cli --cluster create 127.0.0.1:7001 127.0.0.1:7002 127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 127.0.0.1:7006 --cluster-replicas 1 - 跨机器部署时,所有 IP 必须互相 ping 通,且防火墙放行对应端口(如 7001–7006 及对应 +10000 的集群总线端口,即 17001–17006)
- 首次创建后,
nodes-*.conf文件会被自动写入 node id 和拓扑信息,后续重启节点前切勿手动修改或删除它们
最容易被忽略的是:集群创建成功后,redis-cli -c -p 7001 连入任一节点执行 CLUSTER NODES,看到 6 行输出且每行含 master 或 slave 标识,并无 fail 字样——这才是真正可用的状态。任何一行出现 disconnected 或 noaddr,都说明某个节点的集群总线通信没通,得回头查端口和防火墙。


















