megaxcn/predixy

Predixy Redis代理镜像

镜像概述

Predixy Redis代理镜像是基于Predixy构建的Docker镜像，提供高性能Redis代理服务。该镜像可作为Redis集群的统一接入层，实现集群管理、读写分离、负载均衡等功能，简化Redis集群的部署与维护。

核心功能与特性

• 集群管理：支持配置Redis集群服务器池，集中管理多个Redis节点
• 读写分离：可配置主节点与从节点的读优先级，实现读写流量分离
• 负载均衡：自动分发客户端请求，优化集群资源利用率
• 灵活配置：通过predixy.conf配置文件自定义代理规则、超时时间、认证信息等
• 高可用性：具备服务器故障检测与自动重试机制，提升服务稳定性

使用场景

• Redis集群部署环境，需要统一接入点管理多个Redis实例
• 高并发读写场景，需通过读写分离提高Redis服务吞吐量
• 需要集中配置Redis访问权限及连接策略的生产环境

使用方法与配置说明

基本部署

通过docker run命令启动容器，需挂载自定义配置文件：

bash
docker run -d -p 7617:7617 -v /本地路径/predixy.conf:/conf/predixy.conf docker.xuanyuan.run/megaxcn/predixy

说明：容器默认监听7617端口，需将本地配置文件挂载至容器内/conf/predixy.conf路径

配置文件详解（predixy.conf）

核心配置项说明：

基础配置

• Name：代理服务名称标识
• Bind：监听地址与端口，格式为IP:端口（默认0.0.0.0:7617）
• WorkerThreads：工作线程数（默认1）
• ClientTimeout：客户端连接超时时间（秒，默认300）

日志配置

• LogVerbSample/LogDebugSample/LogInfoSample等：不同级别日志的采样频率，0表示不输出对应级别日志

权限配置（Authority）

Authority {
    Auth "#a complex password#" {  # 客户端连接认证密码
        Mode admin  # 权限模式，admin表示管理员权限
    }
}

集群服务器池配置（ClusterServerPool）

ClusterServerPool {
    Password ""  # Redis服务器认证密码（若Redis服务启用密码认证）
    MasterReadPriority 60  # 主节点读优先级（数值越高优先级越高）
    StaticSlaveReadPriority 50  # 静态从节点读优先级
    DynamicSlaveReadPriority 50  # 动态从节点读优先级
    RefreshInterval 1  # 集群信息刷新间隔（秒）
    ServerTimeout 1  # 服务器连接超时时间（秒）
    ServerFailureLimit 10  # 服务器故障判定阈值（连续失败次数）
    ServerRetryTimeout 1  # 服务器故障重试间隔（秒）
    KeepAlive 120  # TCP连接保活时间（秒）
    Servers {  # Redis集群节点列表，"+"表示启用该节点
        + 192.168.2.107:2211
        + 192.168.2.107:2212
    }
}

配置示例

默认配置文件示例：

Name Predixy

***d 0.0.0.0:7617
WorkerThreads 1
ClientTimeout 300

LogVerbSample 0
LogDebugSample 0
LogInfoSample ***
LogNoticeSample 1
LogWarnSample 1
LogErrorSample 1

Authority {
    Auth "#a complex password#" {
        Mode admin
    }
}
ClusterServerPool {
    Password ""
    MasterReadPriority 60
    StaticSlaveReadPriority 50
    DynamicSlaveReadPriority 50
    RefreshInterval 1
    ServerTimeout 1
    ServerFailureLimit 10
    ServerRetryTimeout 1
    KeepAlive 120
    Servers {
        + 192.168.2.107:2211
        + 192.168.2.107:2212
    }
}