docker搭建redis集群核心是网络隔离、配置统一、节点发现和槽位分配四步协同：创建自定义桥接网络，配置6个含cluster-enabled、cluster-announce-ip等参数的redis.conf，分批启动3主3从容器，用redis-cli --cluster create初始化并分配16384槽位，最后验证状态与读写路由。
用 Docker 搭建 Redis 缓存集群，核心是让多个 Redis 实例组成一个具备数据分片与高可用能力的 Cluster 模式集群。这不是简单启动几个容器，而是需要网络隔离、配置统一、节点发现和槽位分配四步协同。下面直接讲关键操作点。
创建专用网络并准备配置文件
Redis Cluster 节点之间必须能互相通信，不能依赖默认 bridge 网络的动态 IP。推荐创建自定义桥接网络：
- 执行
docker network create --subnet=172.20.0.0/24 redis-cluster，固定子网便于配置 - 每个节点需一份独立
redis.conf，关键配置项必须显式声明：cluster-enabled yescluster-config-file nodes.confcluster-node-timeout 5000-
cluster-announce-ip 172.20.0.X（X 为各节点唯一序号，如 2～7） -
cluster-announce-port 6379和cluster-announce-bus-port 16379 -
appendonly yes（开启 AOF 持久化） -
bind 0.0.0.0且protected-mode no（集群内通信必需）
启动 6 个容器（3 主 3 从）
按角色分两批启动，确保主节点先运行再加入从节点：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 主节点（端口映射到宿主机 7001–7003）：
docker run -d --name redis-7001 --net redis-cluster --ip 172.20.0.2 -p 7001:6379 -v $(pwd)/conf/7001.conf:/usr/local/etc/redis/redis.conf redis:7.2 --conf /usr/local/etc/redis/redis.conf
同理启动 redis-7002（IP 172.20.0.3）、redis-7003（IP 172.20.0.4） - 从节点（端口映射 7004–7006，不对外暴露写请求）：
docker run -d --name redis-7004 --net redis-cluster --ip 172.20.0.5 -p 7004:6379 -v $(pwd)/conf/7004.conf:/usr/local/etc/redis/redis.conf redis:7.2 --conf /usr/local/etc/redis/redis.conf
同理启动 redis-7005、redis-7006
初始化集群并分配槽位
所有容器启动后，使用 redis-cli --cluster create 命令初始化：
- 进入任一容器：
docker exec -it redis-7001 bash - 执行集群创建命令（注意替换为实际 IP）：
redis-cli --cluster create 172.20.0.2:6379 172.20.0.3:6379 172.20.0.4:6379 172.20.0.5:6379 172.20.0.6:6379 172.20.0.7:6379 --cluster-replicas 1
参数--cluster-replicas 1表示每主配一从 - 确认后自动完成：节点握手、16384 个哈希槽平均分配（每主约 5461 个）、主从关系绑定
验证与连接使用
集群是否就绪，两个动作就能确认：
- 检查状态：
redis-cli -c -h 172.20.0.2 -p 6379 cluster info | grep "cluster_state"，返回ok即健康 - 测试读写：
redis-cli -c -h localhost -p 7001 set user:1001 "tom"，再用get user:1001验证自动路由是否生效 - 应用连接时，客户端必须支持 Redis Cluster 协议（如 JedisCluster、Lettuce Cluster），不能用普通单节点客户端
整个过程不复杂但容易忽略网络与配置细节。只要 IP 固定、端口开放、cluster-announce- 系列参数匹配真实容器地址，集群就能稳定运行。
