getmargin/docker-redis-cluster

Docker Redis Cluster (多端口分支版)

镜像概述

本镜像为docker-redis-cluster的分支版本，核心功能是在保留原Redis集群功能的基础上，支持在自定义端口上部署和运行Redis集群。适用于需要在同一环境中部署多个Redis集群以避免端口冲突，或有特定端口配置需求的场景。

核心功能与特性

• 多端口支持：允许通过配置指定Redis集群节点使用的端口，突破默认端口限制
• 完整集群功能：继承原docker-redis-cluster的全部Redis集群特性，包括主从复制、数据分片、故障自动转移等
• 兼容性：与官方Redis集群协议完全兼容，支持标准Redis客户端连接
• 简化部署：提供便捷的启动脚本，支持通过环境变量快速配置端口参数

使用场景

• 多集群部署：在同一物理机或容器平台上部署多个独立Redis集群，避免端口冲突
• 开发测试环境：开发人员在本地同时运行多个不同配置的Redis集群进行功能测试
• 多租户环境：为不同租户或应用分配独立的Redis集群，通过端口隔离资源
• 特定网络策略：满足企业网络中对端口访问权限的特殊限制要求

使用方法与配置说明

基本运行方式

通过docker run命令启动单个集群节点（需配合集群配置工具使用）：

bash
docker run -d \
  -p 7000:7000 \
  -p 7001:7001 \
  -e REDIS_PORT=7000 \
  -e CLUSTER_PORT=7001 \
  your-image-name

Docker Compose示例

以下是部署包含3主3从的Redis集群示例（自定义端口7000-7005）：

yaml
version: '3'
services:
  redis-7000:
    image: your-image-name
    ports:
      - "7000:7000"
      - "17000:17000"
    environment:
      - REDIS_PORT=7000
      - CLUSTER_PORT=17000
    volumes:
      - redis-7000-data:/data

  redis-7001:
    image: your-image-name
    ports:
      - "7001:7001"
      - "17001:17001"
    environment:
      - REDIS_PORT=7001
      - CLUSTER_PORT=17001
    volumes:
      - redis-7001-data:/data

  # 省略7002-7005节点配置...

volumes:
  redis-7000-data:
  redis-7001-data:
  # 省略其他数据卷...

环境变量配置

集群初始化

启动所有节点后，需通过Redis集群命令初始化集群（以7000-7005端口为例）：

bash
docker exec -it redis-7000 redis-cli --cluster create \
  127.0.0.1:7000 127.0.0.1:7001 127.0.0.1:7002 \
  127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 \
  --cluster-replicas 1

注意事项

• 确保宿主机端口与容器内端口正确映射，且端口范围未被其他服务占用
• 集群总线端口（通常为服务端口+***）需一并开放，否则集群节点间无法通信
• 生产环境建议使用数据卷挂载持久化Redis数据，避免容器重启导致数据丢失
• 自定义端口时需确保端口规划符合网络安全策略，避免不必要的端口暴露