这篇文章给大家介绍Docker-compose部署redis-cluster集群的完整步骤,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

一、核心配置解析（先理解关键参数）

1. Redis 配置文件（redis1.conf/redis2.conf…）核心参数

参数 作用
port 7001 Redis 节点的服务端口（6 个节点对应 7001-7006）
protected-mode no 关闭保护模式（允许跨机器访问，集群部署必须关闭）
cluster-enabled yes 开启集群模式（Redis Cluster 核心开关）
cluster-config-file nodes.conf 集群节点信息文件（自动生成，无需手动修改）
cluster-node-timeout 5000 集群节点超时时间（5 秒，超时则判定节点不可用）
cluster-announce-ip 172.13.3.160 集群对外公告的 IP（必须是宿主机可访问的 IP，容器内 IP 不行）
cluster-announce-port 7001 集群对外公告的服务端口（和 port 一致）
cluster-announce-bus-port 17001 集群节点间通信的总线端口（服务端口 + 10000）
appendonly yes 开启 AOF 持久化（防止集群重启数据丢失）

2. docker-compose.yml 核心配置

  • &redis-image：YAML 锚点语法，复用 redis:5.0.7 镜像，避免重复写；
  • volumes：挂载本地配置文件到容器内（./redis1.conf:/home/redis/cluster/redis.conf）、挂载数据目录（./7001/data:/data），保证配置生效和数据持久化；
  • ports：映射端口（服务端口 + 总线端口），必须全部开放，否则集群节点无法通信。

二、完整部署步骤（适配通用 Linux 环境，如 CentOS/Ubuntu）

步骤 1：环境准备

检查 Docker 和 Docker Compose 是否安装：

# 检查Docker
docker -v
# 检查Docker Compose
docker-compose -v
# 若未安装，先安装（以CentOS为例）
yum install -y docker docker-compose
systemctl start docker && systemctl enable docker

替换配置中的宿主机 IP：将所有 redis*.conf 和集群创建命令中的 172.13.3.160 替换为你的宿主机实际 IP（可通过 ifconfig/ip addr 查看）。

关闭防火墙 / 开放端口（二选一，推荐开放端口更安全）：

# 方式1：临时关闭防火墙（CentOS）
systemctl stop firewalld && systemctl disable firewalld
# 方式2：开放所需端口（推荐，CentOS）
firewall-cmd --add-port=7001-7006/tcp --permanent
firewall-cmd --add-port=17001-17006/tcp --permanent
firewall-cmd --reload
# Ubuntu 防火墙开放端口
ufw allow 7001-7006/tcp
ufw allow 17001-17006/tcp
ufw reload

步骤 2：创建目录和配置文件

创建项目目录（统一管理文件）：

mkdir -p redis-cluster/{7001,7002,7003,7004,7005,7006}/data
cd redis-cluster

生成 6 个 Redis 配置文件（以 redis1.conf 为例，其他仅改端口）：

# 创建redis1.conf
cat > redis1.conf << EOF
port 7001
protected-mode no
cluster-enabled yes
cluster-config-file nodes.conf
cluster-node-timeout 5000
cluster-announce-ip 你的宿主机IP
cluster-announce-port 7001
cluster-announce-bus-port 17001
appendonly yes
pidfile /var/run/redis_7001.pid
EOF
# 快速生成redis2-redis6.conf（替换端口）
for port in {2..6}; do
  cp redis1.conf redis${port}.conf
  sed -i "s/7001/700${port}/g" redis${port}.conf
  sed -i "s/17001/1700${port}/g" redis${port}.conf
  sed -i "s/redis_7001/redis_700${port}/g" redis${port}.conf
done

创建 docker-compose.yml 文件：

# 注意：新版本Docker Compose可删除version字段（避免过时警告）
x-image:
  &redis-image
    redis:5.0.7
services:
  redis1:
    image: *redis-image
    container_name: redis1
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis1.conf:/home/redis/cluster/redis.conf
      - ./7001/data:/data
    ports:
      - 7001:7001
      - 17001:17001
    # 可选：添加网络模式，避免IP问题
    network_mode: "host"
  redis2:
    image: *redis-image
    container_name: redis2
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis2.conf:/home/redis/cluster/redis.conf
      - ./7002/data:/data
    ports:
      - 7002:7002
      - 17002:17002
    network_mode: "host"
  redis3:
    image: *redis-image
    container_name: redis3
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis3.conf:/home/redis/cluster/redis.conf
      - ./7003/data:/data
    ports:
      - 7003:7003
      - 17003:17003
    network_mode: "host"
  redis4:
    image: *redis-image
    container_name: redis4
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis4.conf:/home/redis/cluster/redis.conf
      - ./7004/data:/data
    ports:
      - 7004:7004
      - 17004:17004
    network_mode: "host"
  redis5:
    image: *redis-image
    container_name: redis5
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis5.conf:/home/redis/cluster/redis.conf
      - ./7005/data:/data
    ports:
      - 7005:7005
      - 17005:17005
    network_mode: "host"
  redis6:
    image: *redis-image
    container_name: redis6
    command: ["redis-server", "/home/redis/cluster/redis.conf"]
    volumes:
      - ./redis6.conf:/home/redis/cluster/redis.conf
      - ./7006/data:/data
    ports:
      - 7006:7006
      - 17006:17006
    network_mode: "host"

✨ 关键优化：添加 network_mode: "host"，让容器使用宿主机网络，避免容器内 IP 和宿主机 IP 不一致导致集群通信失败。

步骤 3：启动容器

# 启动并后台运行容器
docker-compose up -d
# 检查容器状态（6个容器都应是Up状态）
docker-compose ps
# 或
docker ps | grep redis

步骤 4：初始化 Redis Cluster 集群

进入任意一个 Redis 容器（比如 redis1）：

docker exec -it redis1 /bin/bash

执行集群创建命令（替换为你的宿主机 IP）：

redis-cli --cluster create 你的宿主机IP:7001 你的宿主机IP:7002 你的宿主机IP:7003 你的宿主机IP:7004 你的宿主机IP:7005 你的宿主机IP:7006 --cluster-replicas 1

--cluster-replicas 1：表示每个主节点对应 1 个从节点，最终形成 3 主 3 从的集群；

执行后会提示集群规划，输入 yes 确认即可。

步骤 5：验证集群是否正常

连接集群（-c 表示开启集群模式，自动重定向）：

查看集群节点信息：

redis

127.0.0.1:7001> cluster nodes
# 输出会显示6个节点，标注主（master）/从（slave）、槽位分配等信息

测试数据读写（验证集群分片）：

127.0.0.1:7001> set name test
OK
127.0.0.1:7001> get name
"test"
# 切换节点测试（比如7002）
127.0.0.1:7001> exit
redis-cli -c -p 7002
127.0.0.1:7002> get name
# 会自动重定向到存储该key的节点并返回结果

三、常用运维命令

# 停止集群容器
docker-compose stop
# 启动集群容器
docker-compose start
# 彻底删除集群（含数据，谨慎使用）
docker-compose down
rm -rf 700*/data/*  # 删除持久化数据
# 查看集群状态
docker exec -it redis1 redis-cli -c -p 7001 cluster info

四、常见问题及解决方法

  • 集群创建失败：Could not connect to xxx:7001
    • 原因：端口未开放、宿主机 IP 配置错误、容器网络模式问题；
    • 解决：检查防火墙 / 端口、确认 cluster-announce-ip 是宿主机 IP、添加 network_mode: "host"。
  • 容器启动后日志报错：Cluster state changed: fail
    • 原因：节点间总线端口（17001-17006）未开放；
    • 解决：开放 17001-17006 端口，重启容器。
  • 数据写入后重启容器丢失
    • 原因：数据目录未挂载或权限问题；
    • 解决：检查 volumes 挂载路径是否正确，给本地数据目录赋权：
  • 运行

总结

  1. 部署核心：替换宿主机 IP + 开放所有端口（7001-7006、17001-17006） + 初始化集群命令；
  2. 关键配置：cluster-announce-ip 必须是宿主机 IP，protected-mode no 关闭保护模式；
  3. 避坑点：添加 network_mode: host 避免容器网络隔离导致的通信失败，开启 AOF 持久化防止数据丢失。

到此这篇关于Docker-compose部署redis-cluster集群的文章就介绍到这了,更多相关Docker compose redis-cluster集群内容请搜索5186建站网以前的文章或继续浏览下面的相关文章希望大家以后多多支持5186建站网！

您可能感兴趣的文章:

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。