itzg/haproxy-lets

haproxy-lets 镜像文档

镜像概述

haproxy-lets是基于官方haproxy镜像构建的扩展版本，核心功能是集成Let's Encrypt证书自动管理能力，实现HTTPS加密与反向代理的无缝结合。该镜像简化了SSL证书的获取、更新流程，同时保持haproxy强大的负载均衡和代理功能。

核心功能与特性

• 自动证书管理：集成Let's Encrypt客户端，自动完成证书申请、续期和更新
• 灵活的域名映射：通过环境变量或配置文件定义域名与后端服务的映射关系
• 持久化配置：关键配置信息持久化存储，支持动态调整域名映射而无需重建容器
• 测试环境支持：提供Staging模式，用于测试证书申请流程而不触发生产环境速率限制

使用场景

• 需要为多个域名提供HTTPS服务的Web应用
• Docker环境中需要简化SSL证书管理的反向代理场景
• 需同时代理多个后端服务（如微服务架构）的场景
• 希望自动处理证书续期的生产环境部署

配置说明

数据卷（Volumes）

环境变量

DOMAINS注意事项：
DOMAINS值会持久化到/config/domains文件中。如需修改域名映射，需编辑或删除此文件，否则容器重启后将使用持久化配置。

端口映射

使用示例

基本部署（docker run）

以下命令将为两个域名申请证书，并分别代理到两个不同的后端Docker服务：

bash
docker run -d \
  -e EMAIL=me@example.com \
  -e DOMAINS=one.com@service1:8080,two.com@service2:8080 \
  -p 80:80 \
  -p 443:443 \
  itzg/haproxy-lets

持久化配置部署

如需持久化证书和配置，可挂载数据卷：

bash
docker run -d \
  -e EMAIL=admin@example.com \
  -e DOMAINS=app.example.com@app-service:3000 \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/local/certs:/certs \
  -v /path/to/local/config:/config \
  itzg/haproxy-lets

测试环境部署

使用Staging模式测试证书申请流程：

bash
docker run -d \
  -e EMAIL=*** \
  -e DOMAINS=test.example.com@test-service:80 \
  -e STAGING=true \
  -p 80:80 \
  -p 443:443 \
  itzg/haproxy-lets