Docker Compose部署三主三从Redis集群需两阶段启动：先启6个节点并确保就绪，再用redis-cli --cluster create初始化，严格配对主从、固定端口（7000–7005）、声明总线端口（+10000）、关闭protected-mode、统一密码及AOF持久化。
用 Docker Compose 一键部署带复杂主从架构的 Redis 集群，核心不在于“一键”的噱头，而在于配置清晰、节点职责明确、初始化可控。所谓“复杂主从”，通常指三主三从（6 节点）结构，支持自动故障转移、数据分片与读写分离能力。下面直接讲关键怎么做。
明确集群拓扑与端口规划
三主三从不是随意配对，而是严格对应：每个主节点（Master）带一个专属从节点（Slave），形成 3 组复制对。官方推荐槽位（slot）范围均匀分配（0–5460 / 5461–10922 / 10923–16383），因此需固定 6 个唯一端口（如 7000–7005），且每个节点必须声明自己的 IP 和总线端口（cluster-announce-bus-port = port + 10000）。
- 主节点用端口 7000、7001、7002；从节点用 7003、7004、7005
- 所有节点配置中必须设置 cluster-enabled yes、cluster-config-file nodes.conf、cluster-node-timeout 5000
- 若需密码访问，主从节点均要设 requirepass 和 masterauth，值必须一致
编写可复用的节点配置模板
避免为 6 个节点手写 6 份 redis.conf。推荐用统一模板 + 变量替换方式管理，例如：
- 创建通用 conf 模板，用占位符如 PORT、ANNOUNCE_IP、REQUIREPASS
- 用脚本批量生成各节点配置文件（如 sed 或 envsubst），确保每份 conf 中 port、cluster-announce-port、cluster-announce-bus-port 完全匹配容器暴露端口
- 特别注意：protected-mode no 必须关闭，否则集群节点间握手失败；appendonly yes 建议开启，保障 AOF 持久化
Compose 编排需分两阶段启动
不能靠单个 docker-compose.yml 启动就自动完成集群构建——Redis Cluster 初始化（redis-cli --cluster create）必须在所有节点运行后、且全部就绪时执行。因此推荐“两阶段”设计：
- 第一阶段：用 compose 启动 6 个独立 redis 实例（不执行集群命令），确保它们能互相发现、日志显示 Node is up
- 第二阶段：额外起一个临时容器（如 redis:alpine），挂载同一网络，执行 redis-cli -a 密码 --cluster create 命令，传入全部 6 个节点地址，并加 --cluster-replicas 1 表示每主配一从
- 或更稳妥做法：把初始化命令写进最后一个节点的 command 中，用 sleep + wait-for-it 等待其他节点 ready 后再执行 create
验证与日常维护要点
部署完成后别急着切业务，先做几项关键检查：
- 连任一节点执行 redis-cli -p 7000 -a 密码 cluster nodes，确认输出含 6 行，角色标记为 master 或 slave，且每个 slave 的 replicate <master-id> 正确指向对应主节点
- 用 cluster info 查看 cluster_state:ok、cluster_known_nodes:6、cluster_slots_assigned:16384
- 模拟主节点宕机（docker stop redis-7000），观察对应从节点是否在数秒内升为主，且 cluster nodes 中角色已更新
- 日志中避免出现 Connection refused 或 Failed to join cluster，这类错误多因端口映射错、bind 地址未设 0.0.0.0、或总线端口被防火墙拦截
