oba11/haproxy-confd

haproxy-confd

镜像概述

haproxy-confd是一个结合HAProxy和confd的Docker镜像，旨在通过环境变量实现反向代理的动态配置。该镜像简化了HAProxy的配置流程，无需手动编辑配置文件，直接通过环境变量定义后端服务器，适用于需要灵活管理后端服务的场景。

核心功能与特性

• 动态后端配置：通过环境变量轻松定义HTTP或HTTPS后端服务器
• 统计功能：内置HAProxy统计页面，支持密码保护
• 配置简化：无需手动编写HAProxy配置文件，减少配置复杂度
• 灵活选择：支持HTTP或HTTPS后端协议（二者只能选其一配置）

使用场景

• 需要动态管理后端服务器的反向代理场景
• 简单的负载均衡需求，如将请求分发到多个后端服务实例
• 快速部署需要统计监控的HTTP/HTTPS代理服务

使用方法

Docker运行

通过以下命令直接运行镜像：

bash
docker run -d oba11/haproxy-confd

环境变量配置

该镜像支持以下环境变量进行配置：

1. 统计密码

• 变量名：STATS_PASSWORD
• 描述：HAProxy统计页面的访问密码
• 默认值：admin
• 示例：STATS_PASSWORD=mysecret

2. HTTP后端服务器

• 变量名：HTTP_BACKENDS
• 描述：逗号分隔的HTTP后端服务器列表（格式为IP:端口）
• 示例：HTTP_BACKENDS=192.168.1.10:80,192.168.1.11:80

3. HTTPS后端服务器

• 变量名：HTTPS_BACKENDS
• 描述：逗号分隔的HTTPS后端服务器列表（格式为IP:端口）
• 示例：HTTPS_BACKENDS=192.168.1.20:443,192.168.1.21:443

注意：HTTP_BACKENDS和HTTPS_BACKENDS只能设置其中一个，不可同时配置。

完整配置示例

运行一个带有自定义统计密码和HTTP后端的实例：

bash
docker run -d \
  -e STATS_PASSWORD=haproxy123 \
  -e HTTP_BACKENDS=10.0.0.1:8080,10.0.0.2:8080 \
  oba11/haproxy-confd

运行一个带有HTTPS后端的实例：

bash
docker run -d \
  -e HTTPS_BACKENDS=172.17.0.3:443,172.17.0.4:443 \
  oba11/haproxy-confd