1. Redis集群与Docker容器化部署背景
Redis Cluster是Redis官方提供的分布式解决方案，通过数据分片（Sharding）和主从复制（Replication）实现高可用与横向扩展。在Docker环境下部署Redis集群，需要特别关注网络通信和数据持久化两个核心问题。
传统物理机部署Redis集群时，节点间通信和客户端访问相对简单，但在容器化环境中，网络拓扑变得复杂。Docker默认的bridge网络模式会导致容器间通信问题，因此Redis Cluster官方推荐使用host网络模式，这也是本文选择host模式的主要原因。
重要提示：Redis Cluster要求所有节点能互相发现并建立双向通信，使用host模式可避免NAT带来的端口映射问题，确保集群总线端口（Redis端口+10000）正常通信。
2. 环境准备与配置规划
2.1 基础环境要求
部署Redis Cluster需要至少6个节点（3主3从），本文示例使用两台物理主机：
- 主机A：192.168.10.10
- 主机B：192.168.10.11
每台主机部署3个Redis实例，形成跨主机的集群拓扑。硬件配置建议：
- 每台主机至少2核CPU
- 4GB以上内存
- 10GB可用磁盘空间（用于AOF持久化）
2.2 目录结构设计
为方便管理，我们采用以下目录结构：
/usr/local/docker-redis/ └── redis-cluster/ ├── 6371 │ ├── conf/redis.conf │ └── data/ ├── 6372 │ ├── conf/redis.conf │ └── data/ └── ...（其他端口同理）这种结构的好处是：
- 每个实例有独立的配置和数据目录
- 便于批量操作（通过shell循环）
- 容器重启后数据不会丢失
3. Redis配置文件详解
3.1 基础配置模板
Redis集群节点的核心配置如下（以192.168.10.10为例）：
port ${PORT} requirepass 1234 masterauth 1234 protected-mode no daemonize no appendonly yes cluster-enabled yes cluster-config-file nodes.conf cluster-node-timeout 15000 cluster-announce-ip 192.168.10.10 cluster-announce-port ${PORT} cluster-announce-bus-port 1${PORT}关键参数说明：
cluster-enabled yes：启用集群模式cluster-announce-*：集群通信相关IP和端口requirepass/masterauth：设置访问密码（生产环境应使用更复杂的密码）appendonly yes：开启AOF持久化
3.2 批量生成配置文件
使用envsubst命令动态生成各节点配置：
for port in `seq 6371 6373`; do \ mkdir -p ${port}/conf \ && PORT=${port} envsubst < redis-cluster.tmpl > ${port}/conf/redis.conf \ && mkdir -p ${port}/data;\ done这个脚本会：
- 创建端口号对应的目录
- 用实际端口号替换模板中的${PORT}
- 生成最终的redis.conf文件
4. Docker容器部署实战
4.1 容器创建命令
在两台主机上分别执行（注意修改IP和端口范围）：
for port in $(seq 6371 6373); do \ docker run -di --restart always --name redis-${port} --net host \ -v /usr/local/docker-redis/redis-cluster/${port}/conf/redis.conf:/usr/local/etc/redis/redis.conf \ -v /usr/local/docker-redis/redis-cluster/${port}/data:/data \ redis redis-server /usr/local/etc/redis/redis.conf; \ done关键参数解析：
--net host：使用host网络模式-v：挂载配置和数据目录--restart always：容器退出时自动重启
4.2 验证容器状态
执行以下命令检查容器是否正常运行：
docker ps -n 3正常应看到类似输出：
CONTAINER ID IMAGE COMMAND PORTS NAMES a1b2c3d4e5f6 redis "docker-entrypoint.s…" ... redis-63715. 集群创建与验证
5.1 初始化集群
进入任意容器执行集群创建命令：
redis-cli -a 1234 --cluster create \ 192.168.10.10:6371 192.168.10.10:6372 192.168.10.10:6373 \ 192.168.10.11:6374 192.168.10.11:6375 192.168.10.11:6376 \ --cluster-replicas 1参数说明：
--cluster-replicas 1：每个主节点有1个从节点- 列表中的节点顺序会影响主从分配
5.2 集群状态检查
验证集群健康状态：
redis-cli -a 1234 --cluster check 192.168.10.10:6371正常输出应包含：
[OK] All 16384 slots covered. [OK] All nodes agree about slots configuration.5.3 数据读写测试
通过集群客户端执行操作：
redis-cli -c -a 1234 -h 192.168.10.10 -p 6371 > set foo bar > get foo观察键值重定向过程，验证集群是否正常工作。
6. 常见问题与解决方案
6.1 节点无法加入集群
现象：执行集群创建命令时卡在"Waiting for the cluster to join"
排查步骤：
- 检查防火墙是否开放了Redis端口和集群总线端口
- 确认所有节点配置中的cluster-announce-ip是否正确
- 使用telnet测试节点间网络连通性
6.2 槽位分配失败
现象：集群创建后显示"[ERR] Not all 16384 slots are covered"
解决方案：
- 清理旧集群数据：删除所有节点的data目录下的nodes.conf和appendonly.aof文件
- 重新执行集群创建命令
6.3 主从切换问题
现象：主节点宕机后从节点未自动切换
检查要点：
- 确认cluster-node-timeout设置合理（建议15000ms）
- 检查从节点配置的masterauth是否与主节点requirepass一致
- 查看Redis日志：docker logs redis-6371
7. 生产环境优化建议
7.1 安全加固措施
- 修改默认密码：使用复杂密码替换"1234"
- 启用TLS加密通信
- 配置合理的ACL规则
7.2 性能调优参数
# 内存管理 maxmemory 4gb maxmemory-policy allkeys-lru # 网络优化 tcp-backlog 511 timeout 0 # 持久化调整 appendfsync everysec auto-aof-rewrite-percentage 1007.3 监控方案
推荐监控指标：
- 集群状态：cluster info
- 内存使用：info memory
- 持久化状态：info persistence
- 命令统计：info stats
可以使用Prometheus+Redis_exporter+Grafana搭建可视化监控平台。
8. 维护与扩展
8.1 集群扩容步骤
- 准备新节点：按照相同方式部署新Redis实例
- 添加节点到集群：
redis-cli --cluster add-node 新节点IP:端口 现有集群节点IP:端口 - 重新分配槽位：
redis-cli --cluster reshard 现有集群节点IP:端口
8.2 备份与恢复
备份方案：
- 定时备份AOF文件
- 使用BGSAVE创建RDB快照
- 考虑使用Redis的持久化复制功能
恢复流程：
- 停止所有Redis实例
- 替换AOF/RDB文件
- 重启集群并验证数据完整性
9. 容器化部署的替代方案
虽然本文使用原生Docker命令部署，但在生产环境中可以考虑：
- Docker Compose：简化多容器管理
- Kubernetes Operators：如Redis Operator实现自动化管理
- 云托管服务：AWS ElastiCache、Azure Cache for Redis等
每种方案都有其适用场景，需要根据团队技术栈和业务需求选择。
