注意： 这是 haproxy镜像 的 arm32v6 架构构建的"per-architecture"仓库——更多信息，请参见镜像文档中的 "除amd64之外的架构？" 和***镜像FAQ中的 "镜像源在Git中更改后，该怎么办？"。

快速参考

• 维护者：
  Docker社区

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• 3.3-dev10-alpine, 3.3-dev-alpine, 3.3-dev10-alpine3.22, 3.3-dev-alpine3.22

• 3.2.6-alpine, 3.2-alpine, alpine, lts-alpine, 3.2.6-alpine3.22, 3.2-alpine3.22, alpine3.22, lts-alpine3.22

• 3.1.9-alpine, 3.1-alpine, 3.1.9-alpine3.22, 3.1-alpine3.22

• 3.0.12-alpine, 3.0-alpine, 3.0.12-alpine3.22, 3.0-alpine3.22

• 2.8.16-alpine, 2.8-alpine, 2.8.16-alpine3.22, 2.8-alpine3.22

• 2.6.23-alpine, 2.6-alpine, 2.6.23-alpine3.22, 2.6-alpine3.22

• 2.4.30-alpine, 2.4-alpine, 2.4.30-alpine3.22, 2.4-alpine3.22

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构： (更多信息)
  amd64, arm32v5, arm32v6, arm32v7, arm64v8, i386, ppc64le, riscv64, s390x

• 已发布镜像工件详情：
  repo-info仓库的repos/haproxy/目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/haproxy标签
  official-images仓库的library/haproxy文件 (历史记录)

• 本描述的来源：
  docs仓库的haproxy/目录 (历史记录)

什么是HAProxy？

HAProxy是一款免费、开源的高可用解决方案，通过将请求分发到多个服务器，为基于TCP和HTTP的应用提供负载均衡和代理功能。它采用C语言编写，以快速和高效（在处理器和内存使用方面）而闻名。

***.org/wiki/HAProxy

!logo

如何使用本镜像

由于HAProxy的用户配置需求各不相同，本镜像未提供默认配置。

有关配置HAProxy以满足您需求的详细信息，请参考上游优秀且全面的文档。

也值得查看上游的examples/目录。

创建Dockerfile

dockerfile
FROM arm32v6/haproxy:2.3
COPY haproxy.cfg /usr/local/etc/haproxy/haproxy.cfg

构建容器

console
$ docker build -t my-haproxy .

测试配置文件

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

运行容器

console
$ docker run -d --name my-running-haproxy --sysctl net.ipv4.ip_unprivileged_port_start=0 my-haproxy

使用--sysctl net.ipv4.ip_unprivileged_port_start=0需要4.11或更新版本的内核。您可能需要通过指定-p选项将HAProxy监听的端口发布到主机，例如-p 8080:80将容器的80端口发布到主机的8080端口。确保您使用的端口未被占用。

注意： 2.4+版本的容器默认以USER haproxy运行（因此需要上述--sysctl net.ipv4.ip_unprivileged_port_start=0），但旧版本为了兼容性仍默认以root运行；如果您想在旧版本中以非root用户运行，请使用--user haproxy（或其他UID）。

通过绑定挂载直接运行

console
$ docker run -d --name my-running-haproxy -v /path/to/etc/haproxy:/usr/local/etc/haproxy:ro --sysctl net.ipv4.ip_unprivileged_port_start=0 arm32v6/haproxy:2.3

注意，主机的/path/to/etc/haproxy文件夹应包含名为haproxy.cfg的文件。如果此配置文件引用了该文件夹中的其他文件（例如400.http、404.http等模板文件），请确保这些文件也存在。不过，许多最小配置不需要任何支持文件。

重新加载配置

如果您使用绑定挂载了配置文件并编辑了haproxy.cfg，可以通过向容器发送SIGHUP信号使用HAProxy的优雅重新加载功能：

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

镜像中的入口点脚本会检查是否运行haproxy命令，并将其替换为HAProxy上游的haproxy-systemd-wrapper，该工具负责信号处理以实现优雅重新加载。在底层，这使用了haproxy的-sf选项，因此“在高负载下，可能会有两个几毫秒的小窗口出现少量连接失败”（参见停止和重启HAProxy）。

镜像变体

arm32v6/haproxy镜像有多种版本，每种版本设计用于特定用例。

arm32v6/haproxy:<version>

这是默认镜像。如果您不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

arm32v6/haproxy:<version>-alpine

此镜像基于流行的Alpine Linux项目，可在alpine***镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是您的主要关注点时，此变体非常有用。需要注意的主要问题是它使用musl libc而非glibc及相关库，因此软件可能会因对libc的依赖/假设深度而遇到问题。有关可能出现的问题以及使用Alpine-based镜像的优缺点比较，请参见此Hacker News评论线程。

为了最小化镜像大小，Alpine-based镜像中通常不包含额外的相关工具（如git或bash）。以此镜像为基础，可在您自己的Dockerfile中添加所需工具（如果不熟悉如何安装软件包，请参见alpine镜像描述中的示例）。

许可证

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

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

一些能够自动检测到的额外许可证信息可能位于repo-info仓库的haproxy/目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。