phuongdm1987/docker-redis-cluster

docker-redis-cluster

该镜像基于Redis源代码构建，提供快速搭建Redis集群的能力，适用于本地开发、测试或演示场景，不建议用于生产环境。

镜像概述

本镜像旨在帮助用户以最小成本快速启动Redis集群，支持多种Redis版本，可灵活配置集群节点数量、独立实例及哨兵节点。主要用于本地开发Redis集群客户端、测试集群功能或演示Redis集群特性。

核心功能

• 可配置集群: 默认3主3从（每主1从），支持通过环境变量调整主节点数、每主从节点数及初始端口。
• 独立实例: 可通过环境变量启用非集群模式的独立Redis实例。
• 哨兵支持: 可启用与主节点数量一致的哨兵节点，用于集群监控。
• IPv6支持: 支持IPv6绑定地址（需Docker开启IPv6）。
• 认证功能: 支持默认用户密码及自定义用户认证，保障集群安全。
• 多版本兼容: 提供多个Redis版本的预构建镜像（如5.0.x、6.0.x、6.2.x等）。

使用场景

• 本地开发Redis集群客户端（如redis-py-cluster）。
• 测试Redis集群的故障转移、数据分片等核心特性。
• 向团队或客户演示Redis集群的工作原理。

配置说明

关键环境变量

Mac用户特别配置

Mac上运行时需设置集群发现IP：

bash
# 构建前设置环境变量
export REDIS_CLUSTER_IP=0.0.0.0
# 或运行时添加环境变量
docker run -e "IP=0.0.0.0" -p 7000-7005:7000-7005 grokzen/redis-cluster:latest

部署示例

Docker Run 命令

启动默认3主3从集群：

bash
docker run -p 7000-7005:7000-7005 grokzen/redis-cluster:latest

启用2个独立实例：

bash
docker run -e "STANDALONE=2" -p 7000-7007:7000-7007 grokzen/redis-cluster:latest

启用哨兵节点：

bash
docker run -e "SENTINEL=true" -p 5000-5002:5000-5002 -p 7000-7005:7000-7005 grokzen/redis-cluster:latest

Docker Compose 示例

yaml
version: '2'
services:
  redis-cluster:
    image: grokzen/redis-cluster:latest
    ports:
      - "7000-7005:7000-7005"
    environment:
      - INITIAL_PORT=7000
      - MASTERS=3
      - SLAVES_PER_MASTER=1
      # 可选：启用独立实例
      # - STANDALONE=true
      # 可选：启用哨兵
      # - SENTINEL=true

连接到集群

使用本地redis-cli：

bash
redis-cli -c -p 7000

使用容器内的redis-cli：

bash
docker exec -it <容器ID> redis-cli -c -p 7000

可用镜像标签

预构建镜像涵盖多个Redis版本，例如：

• latest（最新稳定版，如6.2.1）
• 6.2.x系列：6.2.1、6.2.0等
• 6.0.x系列：6.0.12、6.0.11等
• 5.0.x系列：5.0.12、5.0.11等

更多标签可查看Docker Hub页面。

许可证

本项目使用MIT许可证，详情见LICENSE文件。