在Redis 6.0中怎样配置并启动原生Redis Cluster？-Redis-PHP中文网

必须开启cluster-enabled yes，否则无法进入集群模式；需配置cluster-config-file（各节点文件名不可重复）、bind 0.0.0.0 ::1、protected-mode no，并清理残留数据与配置文件，再用redis-cli --cluster create指定6节点（3主3从）执行初始化。

在redis 6.0中怎样配置并启动原生redis cluster？

redis.conf 必须开启 cluster-enabled yes

这是启动原生集群最基础、也最容易被跳过的一步。不加这行，redis-server 启动后只是个普通实例，redis-cli --cluster create 会直接报错 [ERR] Node 127.0.0.1:7001 is not empty 或 CLUSTER NODES 返回空，因为根本没进集群模式。

注意：cluster-enabled 必须写在配置文件里，不能靠 CONFIG SET cluster-enabled yes 动态开启 —— Redis 不允许运行时启用集群模式。

必须同时设置 cluster-config-file，且每个节点的文件名不能重复（比如 nodes-7001.conf、nodes-7002.conf）
bind 建议显式设为 0.0.0.0 ::1（IPv4+IPv6），否则单机多实例或 IPv6 环境下可能连不上
protected-mode no 要关掉，否则即使 bind 了 0.0.0.0，也会拒绝非本地连接

启动前必须清空数据和 node 配置文件

反复执行 redis-cli --cluster create 失败，十有八九是因为残留了旧状态。Redis Cluster 启动时会读取 cluster-config-file 和 dir 下的 dump.rdb / appendonly.aof，只要里面存了键或已有集群元数据，就会拒绝加入新集群。

每次重试前务必手动清理：

删掉 cluster-config-file 指定的文件（如 nodes-7001.conf）
清空 dir 目录下的所有文件（尤其是 dump.rdb、appendonly.aof、nodes-*.conf）
确认 pidfile 对应的进程已退出，避免端口占用或 pid 文件残留

别信“重启服务就行”——redis-server 不会自动覆盖或清理这些文件。

redis-cli --cluster create 的参数顺序和数量限制

命令本身不难，但参数稍有差池就直接退出并打印一堆 *** ERROR。核心规则就两条：

节点列表必须是完整的 6 个地址（3 主 3 从），格式统一为 IP:PORT，不能混用 hostname（除非 /etc/hosts 全局配好且各节点互通）
--cluster-replicas 1 表示“每 1 个主节点配 1 个从节点”，所以总节点数必须是 (master + master × replicas)，即最小合法组合是 6 节点（3 主 × 1 从 = 3 从）

常见错误：

redis-cli --cluster create 127.0.0.1:7001 127.0.0.1:7002 --cluster-replicas 1 → 报错 Redis Cluster requires at least 3 master nodes

Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务，分析慢查询并诊断问题。

下载

redis-cli --cluster create 127.0.0.1:7001 ... --cluster-replicas 2 → 6 节点配 2 从/主 = 12 节点，不够就报错

正确示例（单机伪集群）：

redis-cli --cluster create \
  127.0.0.1:7001 127.0.0.1:7002 127.0.0.1:7003 \
  127.0.0.1:7004 127.0.0.1:7005 127.0.0.1:7006 \
  --cluster-replicas 1

集群初始化后，cluster nodes 返回 IP 是绑定地址还是发现地址？

这是线上踩坑最多的一环：你 bind 了 0.0.0.0，但 cluster nodes 里显示的可能是容器内网 IP、Docker bridge 地址，甚至 127.0.0.1 —— 导致其他节点连不上。

根本原因是 Redis 启动时会自动探测“本机可路由的 IP”，优先选第一个非 loopback 接口地址。它不看 bind，只看系统路由表。

解决方法只有两个：

启动前用 ip addr 确认主网卡 IP，并在 redis.conf 中显式加 cluster-announce-ip 192.168.10.10（替换为你的真实业务 IP）
如果跑在 Docker 或 Kubernetes 里，必须挂载 host 网络，或用 --add-host 统一解析，否则 cluster-announce-ip 也救不了跨主机发现

这个 IP 一旦写入 nodes-*.conf，后续重启都会沿用，改配置不重启是无效的。