epicsoft/haproxy

HAProxy Docker镜像（带标准输出日志与自动配置重载）

镜像概述与主要用途

本镜像基于HAProxy构建，增强了标准输出（stdout）日志记录和自动配置重载功能。解决了传统HAProxy在容器环境中日志收集困难及配置更新需重启服务的问题，适用于需要高效日志管理和灵活配置更新的场景。

核心功能与特性

• 标准输出日志：将HAProxy日志直接输出至stdout，便于容器平台（如Docker、Kubernetes）的日志收集工具（如ELK、Promtail）统一采集和分析。
• 自动配置重载：当挂载的HAProxy配置文件更新时，自动触发配置重载（通过发送sighup信号），无需重启容器即可应用新配置，减少服务中断。

使用场景与适用范围

• 容器化部署环境中需集中管理HAProxy日志的场景（如日志聚合平台对接）。
• 频繁更新HAProxy路由规则、后端服务配置的业务场景（如蓝绿部署、动态服务扩缩容）。
• 对服务可用性要求高，不希望因配置更新导致服务重启的生产环境。

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name haproxy-enhanced \
  -p 80:80 \
  -p 443:443 \
  -v /host/path/to/haproxy.cfg:/etc/haproxy/haproxy.cfg \
  gitlab.com/epicdocker/haproxy:latest

说明：通过-v挂载本地HAProxy配置文件至容器内/etc/haproxy/haproxy.cfg，配置文件更新时将自动重载。

配置文件要求

需确保配置文件中日志输出指向stdout，示例配置片段：

global
    log stdout format raw local0 info  # 输出日志至stdout
    maxconn 4096

defaults
    log global  # 继承global段日志配置
    mode http
    timeout connect 5000ms
    timeout client 50000ms
    timeout server 50000ms

相关链接

• 代码仓库：[***]
• 容器镜像 registry：[***]

注：更多详细配置示例（如SSL配置、负载均衡策略）请参考原仓库README文档。