Linux部署Redis集群教程

本文详解了Redis 6+原生集群在Linux环境下的正确部署要点，强调必须使用内置的redis-cli --cluster工具（而非已废弃的redis-trib.rb），严格遵循3主3从共6节点的最低可用架构，并重点揭示了实际落地中最易被忽视却导致90%失败的核心问题：集群总线端口（客户端端口+10000）未开放、节点间IP混用、protected-mode未关闭、以及客户端未启用集群协议支持；从配置规范、启动验证、网络连通性测试到命令执行细节和SDK选型，手把手厘清所有关键陷阱，助你避开“配置全对却组不成集群”的典型困境。

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。

• 测试连通性别只 ping IP：用 telnet 192.168.1.10 17000 实测集群总线端口是否通
• Docker 部署时，--network host 最省事；若用自定义 bridge 网络，必须显式发布 -p 7000:7000 -p 17000:17000
• 云服务器注意安全组——两个端口都要加规则，缺一不可

redis-cli --cluster create 的 --replicas 参数含义易误解

--replicas 1 不是指“总共 1 个从节点”，而是指“每个主节点自动分配 1 个从节点”。6 个节点传入 --replicas 1，工具会按顺序取前 3 个为 master，后 3 个为它们的 replica。如果节点列表顺序不对（比如把本该做从的节点写在前面），集群拓扑就乱了。

真实命令示例：
redis-cli --cluster create 192.168.1.10:7000 192.168.1.10:7001 192.168.1.10:7002 192.168.1.10:7003 192.168.1.10:7004 192.168.1.10:7005 --replicas 1

• 节点 IP 必须可互相解析，不要混用 127.0.0.1 和局域网 IP，否则其他节点无法连接
• 首次创建会提示 Can I set the above configuration?，输 yes 才真正写入 nodes.conf，否则只是预演
• 执行完立刻用 redis-cli -p 7000 cluster nodes 看输出，确认每行都有 master 或 slave 标识，且 connected 为 connected

客户端直连集群必须用支持 Cluster 协议的驱动

普通 redis-cli -p 7000 只能连单节点，执行 SET key val 没问题，但遇到跨槽（cross-slot）命令如 MGET k1 k2（k1/k2 不在同一 slot）会直接报错 MOVED 或 ASK。这不是服务端问题，是客户端没走重定向逻辑。

正确做法：
– 临时调试用：redis-cli -p 7000 -c（加 -c 参数启用集群模式）
– 生产代码必须选带 cluster 支持的 SDK，例如 Python 的 redis-py-cluster（非官方 redis-py）、Java 的 lettuce（Jedis 集群支持弱且已不推荐）

• redis-py 默认不支持集群，硬连会报 ResponseError: MOVED，别试
• PHP 的 phpredis 4.0+ 才有 RedisCluster 类，低版本只能靠代理（如 Codis）
• 集群模式下 KEYS *、FLUSHALL 禁用，要用 redis-cli --cluster call 分节点执行

配置写对只是起点，节点间端口通不通、客户端认不认识 Cluster 协议，才是上线前最常卡住的地方。特别是集群总线端口（client_port + 10000）被忽略，几乎必现“节点列出来了却组不成集群”的现象。

本篇关于《Linux部署Redis集群教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！