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 命令快速启动容器：

console
docker run --name haproxy bitnami/haproxy:latest

获取镜像

拉取***镜像

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

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

手动构建镜像

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

基础配置

执行命令

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

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

挂载自定义配置文件

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

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

Docker Compose 配置

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

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

启动服务：

console
docker-compose up -d

FIPS 模式配置（Bitnami Secure Images）

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

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

示例：

console
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 公告。