redis 5.0起redis-trib.rb已被彻底弃用并失效，所有集群管理功能统一由redis-cli --cluster实现，支持密码认证、tls及backup/import等新命令，且要求redis-cli版本与服务端小版本严格匹配。
Redis 5.0 起，redis-trib.rb 已被彻底弃用，所有集群管理功能统一收归 redis-cli --cluster；6.0 并未新增集群工具，只是强化了 redis-cli --cluster 的稳定性与兼容性——不存在“两个版本工具并存”的过渡期，只有“是否还在用旧脚本”的事实判断。
为什么 redis-trib.rb 在 5.0+ 上根本跑不起来
不是“不推荐”，是直接失效。Redis 5.0 编译时已移除对 ruby 工具链的绑定支持，redis-trib.rb 依赖的 redis gem 包在新版 Redis 源码中不再维护，且其底层调用的 CLUSTER 协议字段（如 node-id 格式、fail? 状态标识）与 5.0+ 的响应结构不兼容。
- 运行
redis-trib.rb check 127.0.0.1:7001会报错：ERR Unknown cluster subcommand or wrong number of arguments - 即使强行安装旧版 gem，也会在
reshard或add-node时因心跳超时或槽位解析失败中断 - 6.0 进一步收紧了协议校验，比如对
cluster-node-timeout值的合法性检查更严格，redis-trib.rb完全无法通过 handshake 阶段
redis-cli --cluster 的核心命令替代关系
所有原 redis-trib.rb 场景，都有明确对应的 redis-cli --cluster 子命令，参数语义更直白，且支持密码认证（--cluster-auth）和 TLS（--cluster-use-tls）：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
redis-trib.rb create→redis-cli --cluster create --cluster-replicas 1 host1:port1 host2:port2 ... -
redis-trib.rb check→redis-cli --cluster check host:port（自动识别密码，无需额外-a） -
redis-trib.rb reshard→redis-cli --cluster reshard host:port --from <node-id> --to <node-id> --slots 1000 --yes</node-id></node-id> -
redis-trib.rb add-node→redis-cli --cluster add-node new_host:new_port existing_host:existing_port --cluster-slave --cluster-master-id <master-id></master-id>
注意：--cluster-slave 必须显式指定，否则新节点默认为 master；而 redis-trib.rb 是靠节点数量推断角色，容易出错。
迁移时最容易被忽略的三个坑
很多人以为“把命令换掉就完事了”，结果在生产环境卡在以下环节：
-
redis-cli --cluster默认不读取redis.conf中的requirepass，必须加--cluster-auth <password></password>，否则所有操作返回NOAUTH Authentication required - 6.0 开始强制要求集群节点间时间差 ≤ 500ms，用
redis-trib.rb旧脚本搭建的集群若未同步 NTP，redis-cli --cluster check会直接报Node 127.0.0.1:7001 is marked as failing -
redis-cli --cluster backup和import功能只在 5.0.1+ 和 6.0.6+ 后才稳定，低于这些小版本号执行会提示unknown command `--cluster-backup`，需先升级 redis-cli 二进制
真正平滑的过渡，不是改几条命令，而是确认你的 redis-cli 版本 ≥ 当前 Redis 服务端小版本（如 Redis 6.2.6 需搭配 redis-cli 6.2.6），并且所有节点的 cluster-enabled yes 和 cluster-config-file 路径可写——这两点比语法迁移重要得多。
