如何在不同网段搭建Redis集群？-Redis-PHP中文网

跨网段无法直接用redis-cli --cluster create初始化集群，因节点需双向连通cluster bus端口（port+10000）并显式配置cluster-announce-ip/port/bus-port，且须禁用cluster-require-full-coverage以保障可用性。

如何在不同网段搭建redis集群？

不能直接跨网段用 redis-cli --cluster create 自动初始化集群，因为节点间通信依赖 TCP 端口直连 + 集群总线端口（port + 10000），而跨网段往往存在防火墙、NAT 或路由策略限制，导致 MEET 失败或心跳超时。

cluster-enabled 节点必须能互相访问 cluster bus 端口

Redis 集群节点除监听客户端端口（如 7000）外，还会自动监听 port + 10000 的集群总线端口（即 17000）。该端口用于节点间 gossip 通信、故障检测和槽位同步。若跨网段节点无法双向访问彼此的 17000、17001 等总线端口，集群将卡在 connecting 或反复 fail 状态。

检查方式：telnet 192.168.10.5 17000 和 telnet 192.168.20.8 17001 必须双向通
常见坑：云厂商安全组默认只放行客户端端口，漏掉总线端口；内网 NAT 设备不支持端口映射回环
不要试图用 cluster-announce-ip 绕过——它只影响对外宣告地址，不解决底层连通性

跨网段必须显式配置 cluster-announce-ip 和 cluster-announce-port

当节点物理 IP（如 10.0.1.10）与客户端/其他节点实际访问 IP（如公网 203.0.113.5 或另一网段 192.168.20.5）不一致时，节点在集群握手阶段会广播错误地址，导致后续重定向失败或从节点无法正确加入。

Redis Skill - 高性能缓存管理

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

下载

每个节点的 redis.conf 中必须设置：

cluster-announce-ip 192.168.20.5
cluster-announce-port 7000
cluster-announce-bus-port 17000

cluster-announce-ip 填其他节点能路由到的真实可达 IP，不是本机 bind 地址
所有节点的 cluster-announce-bus-port 必须显式声明，否则仍会按默认 port + 10000 计算，但可能被防火墙拦截
配置后需重启 Redis，CONFIG REWRITE 不会持久化这些 announce 参数

禁止用 --cluster-replicas 自动分配主从关系

跨网段场景下，redis-cli --cluster create ... --cluster-replicas 1 极易把主从节点分配在同一网段内（比如全分给 192.168.10.x），违背高可用设计初衷——单网段故障即全挂。

应改用手动方式：先用 --cluster create 创建仅含主节点的集群（6 个节点中只传 3 个主节点地址），再用 CLUSTER REPLICATE <node-id></node-id> 指定跨网段从节点
例如：让 192.168.10.10:7000（主）和 192.168.20.20:7003（从）配对，需先 redis-cli -h 192.168.20.20 -p 7003 -a pwd CLUSTER REPLICATE <node-id-of-7000></node-id-of-7000>
验证命令：redis-cli -c -h 192.168.10.10 -p 7000 CLUSTER NODES | grep slave，确认从节点 IP 是另一网段