HAProxy Ubuntu QUIC Docker镜像

支持的标签和对应的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-ubuntu-quic、顶级haproxytech/haproxy-docker-ubuntu-quic镜像文件夹

• 本描述的来源：
  README.md

什么是HAProxy？

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

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

其他功能包括：

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

!logo

如何使用此镜像

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

创建Dockerfile

FROM haproxytech/haproxy-ubuntu-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-ubuntu-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，可通过将卷挂载为rw或使用自定义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的卷以rw方式挂载，且tcp/5555端口被暴露）：

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

许可证

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

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