注意： 这是 haproxy官方镜像 的 i386 架构构建版本的“特定架构”仓库 — 更多信息请参见官方镜像文档中的 “非amd64架构？” 和官方镜像FAQ中的 “Git中的镜像源已更改，该怎么办？”。

快速参考

• 维护者：
  Docker社区

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

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

• 3.3-dev10, 3.3-dev, 3.3-dev10-trixie, 3.3-dev-trixie

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

• 3.2.6, 3.2, latest, lts, 3.2.6-trixie, 3.2-trixie, trixie, lts-trixie

• 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, 3.1, 3.1.9-trixie, 3.1-trixie

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

• 3.0.12, 3.0, 3.0.12-trixie, 3.0-trixie

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

• 2.8.16, 2.8, 2.8.16-trixie, 2.8-trixie

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

• 2.6.23, 2.6, 2.6.23-trixie, 2.6-trixie

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

• 2.4.30, 2.4, 2.4.30-trixie, 2.4-trixie

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

快速参考（续）

• 提交issue的途径：
  [***]

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

• 镜像 artifact 详情：
  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

FROM i386/haproxy:2.3
COPY haproxy.cfg /usr/local/etc/haproxy/haproxy.cfg

构建容器

$ docker build -t my-haproxy .

测试配置文件

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

运行容器

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

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

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

直接通过绑定挂载

$ 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 i386/haproxy:2.3

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

重新加载配置

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

$ docker kill -s HUP my-running-haproxy

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

镜像变体

i386/haproxy 镜像有多种变体，分别针对不同使用场景设计。

i386/haproxy:<version>

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

部分标签可能包含如 trixie 等名称，这些是 Debian 的版本代号，表示镜像基于该 Debian 版本构建。如果镜像需要安装基础镜像之外的其他软件包，建议显式指定这些代号以减少 Debian 新版本发布时的兼容性问题。

i386/haproxy:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，源自 alpine 官方镜像。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此生成的镜像通常更精简。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用 musl libc 而非 glibc 及相关库，因此软件可能因对 libc 的依赖或假设而遇到问题。有关可能出现的问题及使用 Alpine 镜像的优缺点对比，请参见 此 Hacker News 评论线程。

为最小化镜像大小，Alpine 镜像通常不包含额外相关工具（如 git 或 bash）。如需使用此类工具，可基于此镜像在自己的 Dockerfile 中添加（不熟悉如何安装软件包可参考 alpine 镜像描述 中的示例）。

许可证

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

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

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

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