从零搭建 Redis Cluster

适用场景

需要水平扩展、分片和高可用的 Redis 集群。至少 3 主 3 从，适合缓存和会话等可接受分片的数据。

前置条件

• 6 台节点/实例（3 主 3 从），时间同步。
• 放行客户端端口（6379）和集群总线端口（16379）。
• 规划持久化、内存和淘汰策略。
• 准备监控和故障演练。

步骤

1. 配置每个节点的 redis.conf：

port 6379
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 15000
appendonly yes
bind 0.0.0.0
protected-mode yes
requirepass secret
masterauth secret

2. 启动所有实例：

redis-server /etc/redis/redis.conf

3. 创建集群：

redis-cli --cluster create \
  10.0.0.1:6379 10.0.0.2:6379 10.0.0.3:6379 \
  10.0.0.4:6379 10.0.0.5:6379 10.0.0.6:6379 \
  --cluster-replicas 1 -a secret

4. 验证：

redis-cli -c -a secret -h 10.0.0.1 cluster info
redis-cli -c -a secret -h 10.0.0.1 cluster nodes
redis-cli --cluster check 10.0.0.1:6379 -a secret

5. 测试故障切换：

redis-cli -c -a secret -h 10.0.0.1 DEBUG sleep 20
redis-cli -c -a secret -h 10.0.0.2 cluster nodes

6. 配置监控（集群状态、槽位、延迟、内存）和告警。

验证

• 3 主 3 从，16384 个槽位全覆盖。
• 读写正常，MOVED 重定向正常。
• 主节点故障后从节点自动提升。
• 持久化和重启恢复正常。

回滚/重建

• 测试环境可 redis-cli --cluster del-node 或重建。
• 生产缩容先迁移槽位，再删除节点。
• 保留配置和 RDB/AOF 备份。

常见坑

• 少于 3 主无法形成可靠集群。
• 集群总线端口未放行会导致握手失败。
• 多 key 操作需要 hash tag 保证同槽。
• cluster-require-full-coverage yes 时部分槽位故障会导致整体不可用。
• 客户端必须支持集群重定向（-c 或集群模式）。
• 密码和 masterauth 要一致，否则主从复制失败。

相关命令

• redis-cli — 集群管理
• redis-server — 节点
• redis-sentinel — 非集群高可用