kornrunner/redis-cluster-proxy

redis-cluster-proxy-docker

镜像概述

redis-cluster-proxy-docker是Redis Cluster Proxy的Docker化封装，提供轻量级代理服务以简化客户端与Redis集群的交互。该镜像允许客户端通过单一网络连接访问整个Redis集群，无需直接处理集群拓扑变化、槽位分配和重定向等底层逻辑。

核心功能与特性

• 统一接入点：提供单一网络接口，客户端无需了解集群节点分布
• 透明重定向处理：自动处理Redis集群返回的MOVED/ASK重定向响应
• 连接优化：集中管理与集群节点的连接，减少客户端连接数
• 协议兼容性：兼容Redis集群协议，支持大多数Redis核心命令
• 轻量级设计：资源占用低，性能损耗小，适合生产环境部署

使用场景与适用范围

• 客户端不原生支持Redis集群协议的应用系统
• 需要减少与Redis集群直接连接数的高并发场景
• 简化应用层Redis集群访问逻辑的开发场景
• 微服务架构中统一Redis集群访问入口的场景

使用方法与配置说明

基本部署（docker run）

bash
docker run -d -p 7777:7777 --name redis-cluster-proxy \
  redis-cluster-proxy-docker \
  redis-cluster-proxy --cluster <redis-cluster-node-ip>:<port>

说明：<redis-cluster-node-ip>:<port>需替换为Redis集群中任意节点的IP和端口

主要配置参数

自定义端口与日志级别示例

bash
docker run -d -p 6379:6379 --name redis-cluster-proxy \
  redis-cluster-proxy-docker \
  redis-cluster-proxy --cluster 192.168.1.100:6379 --port 6379 --log-level debug

docker-compose配置示例

yaml
version: '3.8'
services:
  redis-cluster-proxy:
    image: redis-cluster-proxy-docker
    container_name: redis-cluster-proxy
    ports:
      - "7777:7777"
    command: redis-cluster-proxy --cluster redis-cluster-node:6379 --timeout 3000 --max-connections 2000
    restart: unless-stopped
    networks:
      - redis-network

networks:
  redis-network:
    driver: bridge