pndlm/proxy

HAProxy + Certbot Docker镜像文档

镜像概述

本镜像整合HAProxy（高性能负载均衡器与反向代理）和Certbot（Let's Encrypt证书管理工具），旨在简化HTTPS服务部署流程，实现SSL证书的自动获取、更新及反向代理配置，适用于需要安全访问的Web应用场景。

核心功能与特性

• 证书自动化：集成Certbot，支持自动申请、续期Let's Encrypt SSL证书
• 反向代理：内置HAProxy，提供负载均衡、请求路由等反向代理功能
• 多版本支持：提供多个标签版本，适配不同Certbot版本及基础系统（Ubuntu/Debian）
• 配置灵活：支持自定义HAProxy配置，适应多样化应用需求

标签说明

使用场景

• 需要快速部署HTTPS服务的Web应用
• 需实现负载均衡的多实例应用
• 需要自动管理SSL证书的服务器环境
• 对证书续期自动化有需求的生产环境

使用方法

基本使用（docker run）

bash
docker run -d \
  --name haproxy-certbot \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/haproxy.cfg:/etc/haproxy/haproxy.cfg \
  -v /path/to/certbot-data:/etc/letsencrypt \
  -e DOMAINS="example.com,www.example.com" \
  -e EMAIL="admin@example.com" \
  your-image-name:latest

Docker Compose配置

yaml
version: '3'
services:
  haproxy-certbot:
    image: your-image-name:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./haproxy.cfg:/etc/haproxy/haproxy.cfg
      - ./certbot-data:/etc/letsencrypt
    environment:
      - DOMAINS=example.com,www.example.com
      - EMAIL=admin@example.com
    restart: unless-stopped

环境变量说明

自定义HAProxy配置

将自定义的haproxy.cfg文件挂载到容器内/etc/haproxy/haproxy.cfg路径，配置示例：

frontend http_front
  bind *:80
  acl letsencrypt-acl path_beg /.well-known/acme-challenge/
  use_backend certbot-backend if letsencrypt-acl
  redirect scheme https code 301 if !{ ssl_fc }

frontend https_front
  bind *:443 ssl crt /etc/letsencrypt/live/example.com/fullchain.pem
  default_backend web-backend

backend certbot-backend
  server certbot 127.0.0.1:8080

backend web-backend
  server web1 192.168.1.100:80 check

注意事项

• stretch标签版本已过时，建议使用v3/latest或bullseye版本
• 证书数据通过卷挂载持久化，避免容器重建导致证书丢失
• 首次启动时需确保80/443端口未被占用，Certbot需通过80端口完成域名验证