HAProxy Alpine QUIC 镜像文档

镜像概述

简介

HAProxy 是最快且使用最广泛的开源负载均衡器和应用交付控制器。此镜像基于 Alpine Linux 构建，包含 QUIC (quictls) 支持，提供了轻量级且高性能的负载均衡解决方案。

支持的标签及对应 Dockerfile 链接

• 3.3-dev10, 3.3
• 3.2.6, 3.2, latest
• 3.1.9, 3.1
• 3.0.12, 3.0
• 2.8.16, 2.8
• 2.6.23, 2.6

快速参考

• 获取帮助: HAProxy 邮件列表、HAProxy 社区 Slack 或 #haproxy on Libera.chat
• 提交问题: [***]
• 维护者: HAProxy Technologies
• 支持的架构: linux/amd64, linux/arm64, linux/arm/v6, linux/arm/v7
• 镜像更新: haproxytech/haproxy-docker-alpine-quic 提交记录
• 描述来源: README.md

核心功能与特性

主要功能

• 支持第 4 层（TCP）和第 7 层（HTTP）代理
• SSL/TLS 终止
• Gzip 压缩
• 健康检查
• HTTP/2 支持
• gRPC 支持
• Lua 脚本
• DNS 服务发现
• 失败连接自动重试
• 详细日志记录

技术特性

• 高效的处理器和内存利用率
• Web UI 统计页面，可监控错误率、流量和延迟
• 通过单一配置文件定义路由规则、速率限制、访问控制等
• QUIC 协议支持
• 基于 Alpine Linux，轻量级且安全

!logo

使用场景与适用范围

• Web 服务器负载均衡
• API 网关
• TCP/HTTP 流量路由
• SSL 终止
• Web 应用防火墙
• 流量监控与分析
• 高可用性架构
• 微服务架构中的服务发现与负载均衡

使用方法与配置说明

创建 Dockerfile

FROM haproxytech/haproxy-alpine-quic:3.0
COPY haproxy.cfg /usr/local/etc/haproxy/haproxy.cfg

构建容器

$ docker build -t my-haproxy .

测试配置文件

$ docker run -it --rm my-haproxy haproxy -c -f /usr/local/etc/haproxy/haproxy.cfg

运行容器

$ docker run -d --name my-running-haproxy -p 8080:80 my-haproxy

注意：需要使用 -p 选项将容器内的端口发布到主机，例如 -p 8080:80 将主机的 8080 端口映射到容器的 80 端口。

使用卷进行配置持久化

$ docker run -d --name my-running-haproxy -v /path/to/etc/haproxy:/usr/local/etc/haproxy:ro haproxytech/haproxy-alpine-quic:3.0

注意：主机的 /path/to/etc/haproxy 文件夹应包含 haproxy.cfg 文件以及其他必要的配置文件。

重新加载配置

要重新加载 HAProxy 配置，可以向容器发送 SIGUSR2 信号：

$ docker kill -s USR2 my-running-haproxy

启用 Data Plane API

所有 2.0+ 版本的镜像默认包含 Data Plane API 辅助进程，启用步骤如下：

1. 通过 userlist 定义一个或多个用户
2. 通过 program api 启用数据平面 API 进程
3. 以读写方式挂载包含 haproxy.cfg 的卷，或通过重建镜像包含自定义配置
4. 使用 --expose 暴露数据平面 TCP 端口

haproxy.cfg 相关配置部分：

userlist haproxy-dataplaneapi
    user admin insecure-password mypassword

program api
   command /usr/bin/dataplaneapi --host 0.0.0.0 --port 5555 --haproxy-bin /usr/sbin/haproxy --config-file /usr/local/etc/haproxy/haproxy.cfg --reload-cmd "kill -SIGUSR2 1" --restart-cmd "kill -SIGUSR2 1" --reload-delay 5 --userlist haproxy-dataplaneapi
   no option start-on-reload

运行包含 Data Plane API 的容器：

$ docker run -d --name my-running-haproxy --expose 5555 -v /path/to/etc/haproxy:/usr/local/etc/haproxy:rw haproxytech/haproxy-alpine-quic

Docker Compose 示例

创建 docker-compose.yml 文件：

version: '3'
services:
  haproxy:
    image: haproxytech/haproxy-alpine-quic:3.0
    container_name: haproxy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
      - ./ssl:/usr/local/etc/haproxy/ssl:ro
    expose:
      - "5555"
    networks:
      - haproxy-network

networks:
  haproxy-network:
    driver: bridge

启动服务：

$ docker-compose up -d

许可证信息

此镜像包含的软件许可信息请查看 许可信息。

与所有 Docker 镜像一样，此镜像可能还包含其他软件，这些软件可能具有其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。