haproxytech/haproxy

HAProxy 社区版 Docker 镜像

支持的标签

• alpine、debian 和 ubuntu 前缀：表示容器基础操作系统
• 带 s6 和不带 s6：分别适用于需要或不需要 S6 覆盖层的 HAProxy 和 Dataplaneapi 用户
• 其他常规 HAProxy CE 分支标签：2.4、2.6、2.8、3.0、3.1、3.2、3.3、3.4 等

快速参考

• 获取帮助：
  HAProxy 邮件列表、HAProxy 社区 Slack 或 #haproxy on Libera.chat

• 提交问题：
  https://github.com/haproxytech/haproxy-docker-alpine/issues

• 维护者：
  https://github.com/haproxytech

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  linux/amd64、linux/arm64、linux/arm/v6、linux/arm/v7、linux/386

• 镜像更新：
  https://github.com/haproxytech/haproxy-docker-alpine/commits/main%E3%80%81https://github.com/haproxytech/haproxy-docker-alpine

• 描述来源：
  https://github.com/haproxytech/haproxy-docker-alpine/blob/main/README.md

什么是 HAProxy？

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

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

其他功能包括：

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

!logo

如何使用此镜像

此镜像附带一个简单的示例配置，实际使用时应根据详细文档和https://github.com/haproxy/haproxy/tree/master/examples%E8%BF%9B%E8%A1%8C%E9%85%8D%E7%BD%AE%E3%80%82%E4%BB%A5%E4%B8%8B%E5%B1%95%E7%A4%BA%E5%A6%82%E4%BD%95%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E9%85%8D%E7%BD%AE%E8%A6%86%E7%9B%96%E9%BB%98%E8%AE%A4%E7%9A%84 haproxy.cfg。

创建 Dockerfile

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

构建容器

console
$ docker build -t my-haproxy .

测试配置文件

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

运行容器

console
$ docker run -d --name my-running-haproxy my-haproxy

需通过 -p 选项将 HAProxy 监听的端口映射到主机，例如 -p 8080:80 表示将主机的 8080 端口映射到容器的 80 端口。

使用卷实现配置持久化

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

注意：主机的 /path/to/etc/haproxy 文件夹应包含 haproxy.cfg 文件及 /etc/haproxy 目录下的其他相关文件。

重新加载配置

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

console
$ docker kill -s USR2 my-running-haproxy

启用 Data Plane API

使用 Data Plane API 最简单的方式是使用带 s6 标签的镜像，这类镜像默认运行 Data Plane API。

许可证

查看此镜像中包含软件的https://raw.githubusercontent.com/haproxy/haproxy/master/LICENSE%E3%80%82

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