arunsr/redis-cluster

docker-redis-cluster

https://img.shields.io/docker/stars/grokzen/redis-cluster.svg](https://hub.docker.com/r/grokzen/redis-cluster/) https://img.shields.io/docker/pulls/grokzen/redis-cluster.svg](https://hub.docker.com/r/grokzen/redis-cluster/) https://travis-ci.org/Grokzen/docker-redis-cluster.svg?branch=master](https://travis-ci.org/Grokzen/docker-redis-cluster)

镜像概述

本镜像从源码构建Redis，并快速搭建Redis集群，旨在以最小成本快速启动集群，适用于本地开发、演示或 presentation 场景，不建议用于生产环境。支持多种Redis版本，可按需选择指定版本。

核心功能

• 快速集群搭建：默认启动3主3从（共6个节点），端口范围7000-7005；
• 多模式支持：通过环境变量启用独立实例（2个节点，端口7006-7007）或哨兵模式（3个节点，端口5000-5002）；
• 版本灵活：支持构建Redis 3.0.x至5.0.x的多个版本；
• 可配置性：自定义初始端口、主节点数、每主节点的从节点数。

使用场景

• 开发Redis集群客户端代码；
• 演示Redis集群的特性（如分片、故障转移）；
• 本地测试Redis集群相关功能。

配置说明

环境变量

Mac用户注意事项

需设置内部IP用于集群发现：

bash
# 构建前导出环境变量
export REDIS_CLUSTER_IP=0.0.0.0
# 或在docker run时添加
docker run -e "IP=0.0.0.0" grokzen/redis-cluster:latest

部署示例

基础使用（Make命令）

bash
# 构建镜像
make build
# 启动集群
make up
# 停止集群
make down
# 连接集群（使用容器内redis-cli）
make cli

Docker Run命令

bash
# 启动默认集群（3主3从）
docker run -d -p 7000-7005:7000-7005 grokzen/redis-cluster:latest
# 启用独立实例
docker run -d -p 7006-7007:7006-7007 -e STANDALONE=true grokzen/redis-cluster:latest
# 启用哨兵模式
docker run -d -p 5000-5002:5000-5002 -e SENTINEL=true grokzen/redis-cluster:latest

Docker Compose配置（自定义节点数）

yaml
version: '2'
services:
  redis-cluster:
    image: grokzen/redis-cluster:latest
    ports:
      - "9000-9005:9000-9005"
    environment:
      INITIAL_PORT: 9000
      MASTERS: 2
      SLAVES_PER_MASTER: 2

构建指定Redis版本

bash
# Docker build
docker build --build-arg redis_version=4.0.13 -t grokzen/redis-cluster .
# Docker Compose build
docker-compose build --build-arg "redis_version=4.0.13" redis-cluster

可用标签

支持Redis 3.0.x、3.2.x、4.0.x、5.0.x系列版本，例如：

• 5.0.5（latest）、5.0.4、...、5.0.0
• 4.0.14、4.0.13、...、4.0.0
• 3.2.13、3.2.12、...、3.2.0
• 3.0.7、3.0.6、...、3.0.0

许可证

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