Bitnami HAProxy 镜像文档

镜像概述和主要用途

关于 HAProxy

HAProxy 是一款高性能的 TCP 代理和 HTTP 反向代理服务器，支持 SSL 终止与卸载、TCP/HTTP 流量标准化、流量调节、缓存及 DDoS 攻击防护等功能。

Bitnami 镜像用途

Bitnami HAProxy 镜像提供预配置、安全优化的容器化部署方案，简化 HAProxy 在开发、测试及生产环境中的使用流程，确保与 Bitnami 生态系统（如虚拟机、云镜像）的配置一致性。

核心功能和特性

HAProxy 核心功能

• 多协议支持：TCP 代理与 HTTP 反向代理
• 安全能力：SSL/TLS 终止、卸载及加密
• 流量管理：TCP/HTTP 流量标准化、负载均衡与流量调节
• 可靠性：健康检查、故障转移与会话保持
• 防护功能：DDoS 攻击防护与请求速率限制
• 性能优化：缓存支持与连接复用

Bitnami Secure Images 特性

• 安全加固：基于最小化操作系统（Photon Linux），减少攻击面
• 漏洞透明：通过 VEX/KEV 提供 CVE 可利用性信息，包含 EPSS 评分
• 供应链安全：SLSA-3 合规构建流程，提供签名验证（Notation）、SBOMs 及病毒扫描报告
• 持续更新：上游安全补丁发布后数小时内完成镜像更新
• 跨平台一致：容器、虚拟机及云镜像使用统一组件与配置方法
• FIPS 支持：可选启用 FIPS 模式，满足安全合规要求

使用场景和适用范围

适用场景

• 开发/测试环境：使用 latest 标签的硬化镜像快速验证 HAProxy 配置
• 生产环境：采用 Bitnami Secure Images 获得企业级支持、长期维护及安全加固
• 负载均衡架构：需要 TCP/HTTP 流量代理、SSL 终止或流量控制的服务集群
• 安全敏感场景：对软件供应链安全、漏洞管理有严格要求的应用部署

限制说明

• 非硬化的 Debian 基础镜像已逐步停止支持，旧版本标签（如 2.50.0、10.6）迁移至 docker.io/bitnamilegacy 仓库，不再更新
• docker-compose.yaml 配置文件仅供开发测试，生产环境建议使用 Bitnami HAProxy Helm Chart

详细使用方法和配置说明

快速启动

通过 docker run 命令快速启动容器：

docker run --name haproxy bitnami/haproxy:latest

获取镜像

拉取官方镜像

# 最新版硬化镜像
docker pull bitnami/haproxy:latest

# 旧版本镜像（已迁移至 legacy 仓库）
docker pull bitnamilegacy/haproxy:[TAG]  # 例如 bitnamilegacy/haproxy:2.50.0

手动构建镜像

git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM  # 替换为实际路径
docker build -t bitnami/haproxy:latest .

基础配置

执行命令

在容器内运行 HAProxy 命令（如查看版本）：

docker run --rm --name haproxy bitnami/haproxy:latest -- --version

挂载自定义配置文件

HAProxy 配置需通过挂载 haproxy.cfg 文件实现，默认配置路径为 /bitnami/haproxy/conf/haproxy.cfg：

docker run --rm --name haproxy \
  -v /本地路径/haproxy.cfg:/bitnami/haproxy/conf/haproxy.cfg \
  bitnami/haproxy:latest

Docker Compose 配置

创建 docker-compose.yaml（仅供开发测试）：

version: '2'
services:
  haproxy:
    image: bitnami/haproxy:latest
    volumes:
      - /本地路径/haproxy.cfg:/bitnami/haproxy/conf/haproxy.cfg
    ports:
      - "80:80"  # 根据配置映射端口

启动服务：

docker-compose up -d

FIPS 模式配置（Bitnami Secure Images）

通过环境变量启用 FIPS 模式：

• OPENSSL_FIPS：控制 OpenSSL FIPS 模式，可选值 yes（默认启用）或 no（禁用）

示例：

docker run --rm --name haproxy \
  -e OPENSSL_FIPS=no \
  -v /本地路径/haproxy.cfg:/bitnami/haproxy/conf/haproxy.cfg \
  bitnami/haproxy:latest

重要注意事项

2025 年 8 月 28 日起镜像仓库变更

• 旧镜像迁移：所有版本化标签（如 2.50.0、10.6）从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy，不再接收更新
• 免费 tier 调整：社区用户仅可访问 latest 标签的硬化镜像（开发用途），非硬化 Debian 镜像逐步停止支持
• 生产建议：生产环境需采用 Bitnami Secure Images，获取安全加固、企业支持及长期维护

详情参见 Bitnami Secure Images 公告。

贡献

欢迎通过 GitHub Issues 提交功能请求，或通过 Pull Requests 贡献代码，提交前请遵循 贡献指南。

许可

Copyright © 2025 Broadcom。"Broadcom" 指 Broadcom Inc. 及其子公司。

本软件基于 Apache License 2.0 许可发布，详情参见 许可文件。