tecnativa/haproxy-letsencrypt

HTTPS代理镜像

![镜像信息]([] ![版本信息]([] ![提交信息]([***]

镜像概述

本镜像基于官方Alpine版HAProxy和Let's Encrypt官方ACME客户端Certbot构建，旨在为任意HTTP服务快速添加HTTPS加密层，无需复杂配置即可实现生产级安全代理。

核心功能

1. 自动证书管理：通过Certbot自动获取、更新Let's Encrypt SSL证书
2. HTTP转HTTPS：默认将所有HTTP请求重定向至HTTPS
3. 域名前缀处理：自动移除www.前缀（可配置为强制添加或关闭）
4. 特殊模式支持：提供ODOO模式，适配Odoo应用的长轮询需求
5. 代理头传递：向后端服务传递X-Forwarded-Proto等标准代理头
6. 自定义扩展：支持通过环境变量或钩子注入自定义规则

使用场景

• 为Web应用、API服务快速添加HTTPS加密
• 简化小型项目的SSL证书管理流程
• 为Odoo等特定应用提供适配的HTTPS代理

配置说明

关键环境变量

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 -p 443:443 \
  --link your-app:www \
  -e STAGING=false \
  -e EMAIL=admin@example.com \
  -e DOMAINS=example.com,www.example.com \
  -v ./letsencrypt:/etc/letsencrypt \  # 持久化证书目录
  tecnativa/haproxy-letsencrypt

Docker Compose示例

yaml
version: '3'
services:
  proxy:
    image: tecnativa/haproxy-letsencrypt
    ports:
      - "80:80"
      - "443:443"
    links:
      - app:www
    environment:
      STAGING: "false"
      EMAIL: "admin@example.com"
      DOMAINS: "example.com,www.example.com"
    volumes:
      - letsencrypt_data:/etc/letsencrypt  # 持久化证书
  app:
    image: your-web-app:latest
    ports:
      - "8080:80"

volumes:
  letsencrypt_data:

注意事项

• 证书安全：务必持久化/etc/letsencrypt目录，避免证书丢失
• 自定义错误页：可通过子镜像替换/usr/local/etc/haproxy/errors下的HTML文件
• 后端端口：若后端服务非80端口，需设置PORT环境变量（如-e PORT=8080）

反馈

如有问题或建议，请提交至https://github.com/Tecnativa/docker-haproxy-letsencrypt/issues%E3%80%82 ===FULL_DESC===