wrboyce/haproxy-gen

自动配置HAProxy Docker镜像

镜像概述

本镜像结合HAProxy和docker-gen工具，为Docker容器提供自动化的负载均衡和反向代理解决方案。docker-gen通过监听Docker守护进程事件，自动生成HAProxy配置文件并实时更新，实现容器服务的动态发现与配置，避免手动管理HAProxy配置的复杂性。

核心功能与特性

• 动态配置更新：无需手动修改HAProxy配置文件，docker-gen自动根据容器生命周期事件（启动、停止、重启）更新配置并重载HAProxy
• 容器自动发现：通过Docker标签或网络自动识别需要代理的容器服务
• 灵活的负载均衡算法：支持HAProxy原生负载均衡算法（roundrobin、leastconn、source等）
• 反向代理支持：支持HTTP/HTTPS协议的反向代理，可配置SSL终结
• 自定义配置模板：允许挂载自定义HAProxy配置模板，满足个性化需求
• 轻量级设计：基于官方HAProxy镜像构建，体积小，资源占用低

使用场景与适用范围

• 微服务架构：为多实例微服务提供动态负载均衡，支持服务扩缩容
• 容器化应用：简化多容器应用的流量入口管理，统一服务访问端点
• 开发/测试环境：快速搭建临时代理环境，无需手动配置
• 生产环境：作为边缘代理，实现服务高可用和流量分发

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name haproxy-auto \
  -p 80:80 \
  -p 443:443 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e HAPROXY_CONFIG_TEMPLATE=/etc/haproxy/haproxy.tmpl \
  -e LOG_LEVEL=info \
  your-image-name

docker-compose配置示例

yaml
version: '3'
services:
  haproxy:
    image: your-image-name
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./haproxy.tmpl:/etc/haproxy/haproxy.tmpl:ro  # 自定义模板
      - ./ssl:/etc/haproxy/ssl:ro  # SSL证书
    environment:
      - DOCKER_HOST=unix:///var/run/docker.sock
      - HAPROXY_PORT=80
      - HAPROXY_SSL_PORT=443
      - LOG_LEVEL=notice
    restart: always

环境变量配置

容器标签配置

通过为后端容器添加以下标签控制HAProxy配置：

自定义配置模板

默认模板位于/etc/haproxy/haproxy.tmpl，可通过挂载自定义模板文件覆盖。模板使用Go模板语法，可通过docker-gen提供的容器元数据动态生成配置。示例模板片段：

frontend http
    bind *:{{ .Env.HAPROXY_PORT }}
    mode http
    {{ range $container := .Containers }}
        {{ if eq $container.Labels "haproxy.enable" "true" }}
            acl {{ $container.Labels "haproxy.backend" }} hdr(host) -i {{ $container.Labels "haproxy.host" }}
            use_backend {{ $container.Labels "haproxy.backend" }} if {{ $container.Labels "haproxy.backend" }}
        {{ end }}
    {{ end }}

{{ range $backend := .Backends }}
backend {{ $backend.Name }}
    mode http
    balance roundrobin
    {{ range $server := $backend.Servers }}
        server {{ $server.Name }} {{ $server.IP }}:{{ $server.Port }} weight {{ $server.Weight }} check
    {{ end }}
{{ end }}

注意事项

• 确保容器具有访问Docker socket的权限（挂载/var/run/docker.sock）
• 自定义模板时需熟悉HAProxy配置语法和docker-gen模板规则
• 生产环境建议配置健康检查和自动重启策略
• SSL证书需通过卷挂载至容器内，并在模板中正确引用