PingCAP Haproxy Docker镜像文档

镜像概述

本镜像为PingCAP提供的Haproxy Docker镜像，基于Haproxy构建，专注于TCP服务负载均衡场景（如MySQL协议代理），包含预设配置以支持后端服务健康检查、连接控制及统计监控功能，适用于构建高可用的服务转发层。

核心功能与特性

• TCP负载均衡：支持TCP模式负载均衡，默认采用leastconn（最少连接数）算法分发请求，优化后端服务资源利用。
• 健康检查：自动对后端服务器进行健康状态检查（check参数），确保请求仅转发至可用服务。
• 统计监控：内置HTTP统计页面，可实时查看后端服务状态、连接数等关键指标，支持基本认证保护。
• 连接控制：配置超时时间（客户端30s、服务器30s、连接3s）及最大并发连接数（4096），保障服务稳定性。
• 高可用性：支持后端服务故障自动切换，提升整体服务可用性。

使用场景与适用范围

• TiDB集群代理：作为TiDB等MySQL兼容数据库的前端入口，分发客户端请求至多个TiDB节点，实现读写分离或负载分担。
• TCP服务负载均衡：适用于各类TCP协议服务（如数据库、消息队列）的流量分发，提升服务吞吐量与可用性。
• 服务监控：通过内置统计页面实时监控后端服务状态，辅助运维与问题排查。
• 测试与生产环境：轻量级部署，支持快速搭建负载均衡环境，满足测试验证及生产级服务需求。

使用方法与配置说明

基本运行

通过以下命令启动容器，映射代理端口（4000）和统计端口（8080）：

bash
docker run -d -p 4000:4000 -p 8080:8080 --name haproxy-pingcap pingcap/haproxy

默认配置详解

镜像默认配置包含以下关键部分：

defaults 全局设置

defaults
    log global              # 使用全局日志配置
    mode http               # 默认HTTP模式（可在监听段覆盖）
    option redispatch       # 会话失败时重新分发请求
    timeout client  30s     # 客户端超时时间
    timeout server  30s     # 服务器超时时间
    timeout connect 3s      # 连接超时时间

mysql_proxy 代理配置（TCP模式）

listen mysql_proxy 
    bind *:4000             # 监听4000端口
    mode tcp                # 显式指定TCP模式
    balance leastconn       # 最少连接数负载均衡算法
    maxconn 4096            # 最大并发连接数
    server tidb1 tidb1:4000 check  # 后端服务器1（含健康检查）
    server tidb2 tidb2:4000 check  # 后端服务器2（含健康检查）
    server tidb3 tidb3:4000 check  # 后端服务器3（含健康检查）

stats 统计监控配置（HTTP模式）

listen stats 
    bind *:8080             # 监听8080端口
    mode http               # HTTP模式
    balance roundrobin      # 轮询算法（统计页面自身请求分发）
    stats uri /             # 统计页面访问路径
    stats realm Haproxy\ Statistics  # 页面提示信息
    stats auth admin:admin  # 访问认证（用户名:密码）

自定义配置

如需修改后端服务器地址、端口或调整负载均衡策略，可通过挂载本地配置文件覆盖默认配置：

1. 创建自定义配置文件（如haproxy.cfg），参考默认配置格式调整参数（如修改后端服务器地址为实际环境IP）。

2. 启动容器时挂载配置文件：

bash
docker run -d -p 4000:4000 -p 8080:8080 -v /path/to/custom/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg --name haproxy-pingcap pingcap/haproxy

访问统计页面

启动容器后，通过 http://<容器IP>:8080 访问统计页面，使用默认认证信息登录：

• 用户名：admin
• 密码：admin

登录后可查看后端服务健康状态、当前连接数、请求流量等实时监控数据。