支持的标签及对应的 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

• 镜像更新：
  haproxytech/haproxy-docker-debian-quic 提交记录、haproxytech/haproxy-docker-debian-quic 镜像顶层文件夹

• 本描述的来源：
  README.md

什么是 HAProxy？

HAProxy 是速度最快、使用最广泛的开源负载均衡器和应用交付控制器。它采用 C 语言编写，以高效利用处理器和内存资源而闻名。HAProxy 可在四层（TCP）或七层（HTTP）进行代理，并具备检查、路由和修改 HTTP 消息的额外功能。

它内置了一个 Web UI（称为 HAProxy 统计页面），可用于监控错误率、流量 volume 和延迟。通过更新单个配置文件即可启用功能，该文件提供了定义路由规则、速率限制、访问控制等的语法。

其他功能包括：

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

!logo

如何使用此镜像

此镜像附带一个简单的示例配置，实际使用时应根据详细文档和示例进行配置。以下将展示如何用您自己的 haproxy.cfg 覆盖默认配置。

创建 Dockerfile

FROM haproxytech/haproxy-debian-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 my-haproxy

您还需要通过指定 -p 选项将 HAProxy 监听的端口发布到主机，例如 -p 8080:80 将容器的 80 端口映射到主机的 8080 端口。

使用卷实现配置持久化

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

注意，主机的 /path/to/etc/haproxy 文件夹应包含名为 haproxy.cfg 的文件以及 /etc/haproxy 本地的其他相关文件。

重新加载配置

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

$ docker kill -s USR2 my-running-haproxy

启用 Data Plane API

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

1. 通过 userlist 定义一个或多个用户
2. 通过 program api 启用 dataplane api 进程
3. 以读写方式挂载 Docker 中的 haproxy.cfg，可通过将卷挂载为 r/w 或使用自定义 haproxy.cfg 重建镜像实现
4. 使用 --expose 暴露 dataplane 的 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

运行此类镜像的命令如下（注意包含 haproxy.cfg 的卷以读写方式挂载，且暴露 tcp/5555 端口）：

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

许可证

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

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