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。
- 测试连通性别只 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 的
phpredis4.0+ 才有RedisCluster类，低版本只能靠代理（如 Codis） - 集群模式下
KEYS *、FLUSHALL禁用，要用redis-cli --cluster call分节点执行
