注意： 这是 haproxy 官方镜像 的 mips64le 架构构建的“按架构”仓库——更多信息，请参阅官方镜像文档中的“除 amd64 外的架构？”和官方镜像FAQ中的“Git 中镜像的源代码已更改，现在该怎么办？”。

快速参考

-** 维护者：**Docker 社区

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

支持的标签及对应的 Dockerfile 链接警告：此镜像在 mips64le 架构上不受支持# 快速参考（续）

-** 提交 issue 的位置：[*]

-** 支持的架构：**(更多信息)
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

FROM mips64le/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

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

注意： 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 mips64le/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）。

许可证

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

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

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

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