extremeshok/acme-http2https

docker-acme-http2https

镜像概述

docker-acme-http2https是一个基于Alpine的Docker镜像，集成Nginx和acme.sh ACME客户端，主要用于自动管理Let's Encrypt SSL证书，并实现HTTP流量到HTTPS的自动重定向。该镜像支持证书自动更新、域名解析检查、多目录布局的证书部署，以及可选的邮件通知功能，适用于需要简化SSL证书管理并强制HTTPS访问的Web服务场景。

核心功能与特性

• 基础环境：基于最新Alpine，集成s6进程管理
• 健康检查：内置HEALTHCHECK机制，确保服务可用性
• Nginx集成：提供HTTP到HTTPS的自动重定向
• 证书管理：集成acme.sh客户端，支持Let's Encrypt证书申请与更新
• 自动更新：容器启动时自动更新acme.sh至最新版本
• 域名监控：每日检查一次域名列表（/acme/domain_list.txt），支持动态更新
• 前置检查：申请证书前验证域名可访问性，避免无效ACME请求
• 智能清理：自动移除无法解析的别名域名，确保证书有效性
• 目录支持：兼容/certs和/var/www/vhosts两种证书存储布局
• 安全增强：默认生成4096位DHPARAM（可禁用），自动生成/root/.rnd文件（修复RNG加载问题）
• 通知功能：支持通过自定义SMTP服务器发送证书更新失败邮件通知

使用场景

• 个人或企业Web服务需要自动管理SSL证书
• 需强制将HTTP流量重定向至HTTPS的网站
• 多域名/泛域名证书管理场景
• 需要证书更新后自动重启关联Docker容器的服务

使用方法与配置说明

环境变量配置

卷挂载

• /certs：若挂载此目录，证书将自动复制到/certs/域名/下
• /var/www/vhosts：若挂载此目录，证书将自动复制到/var/www/vhosts/域名/certs/下
• /acme/domain_list.txt：域名列表文件（每行一个证书，格式见示例）
• /var/run/docker.sock：需重启容器时挂载，用于与Docker守护进程通信

域名列表文件格式（/acme/domain_list.txt）

每行定义一个证书，第一个值为证书主域名，后续为别名域名：

example.org
example.com www.example.com
example.net www.example.net wiki.example.net
service.example.com *.service.example.com
eggs.example.com *.ham.example.com

Docker部署示例

docker run命令

bash
docker run -d \
  --name acme-http2https \
  -p 80:80 \
  -p 443:443 \
  -e REGISTERED_EMAIL=your@email.com \
  -e NOTIFY=yes \
  -e SMTP_HOST=smtp.yourdomain.com \
  -e SMTP_USER=user@yourdomain.com \
  -e SMTP_PASS=yourpassword \
  -v /path/to/certs:/certs \
  -v /path/to/domain_list.txt:/acme/domain_list.txt \
  -v /var/run/docker.sock:/var/run/docker.sock:rw \
  docker.xuanyuan.run/extremeshok/acme-http2https

docker-compose配置（参考docker-compose-sample.yml）

yaml
version: '3'
services:
  acme-http2https:
    image: docker.xuanyuan.run/extremeshok/acme-http2https
    container_name: acme-http2https
    ports:
      - "80:80"
      - "443:443"
    environment:
      - REGISTERED_EMAIL=your@email.com
      - NOTIFY=yes
      - NOTIFY_EMAIL=notify@yourdomain.com
      - SMTP_HOST=smtp.yourdomain.com
      - SMTP_PORT=587
      - SMTP_USER=user@yourdomain.com
      - SMTP_PASS=yourpassword
      - ACME_RESTART_CONTAINERS=webapp1;webapp2
      - GENERATE_DHPARAM=no
    volumes:
      - ./certs:/certs
      - ./domain_list.txt:/acme/domain_list.txt
      - /var/run/docker.sock:/var/run/docker.sock:rw
    restart: unless-stopped

注意事项

• 首次启动时若启用GENERATE_DHPARAM=yes，容器可能需要较长时间生成4096位DHPARAM
• 使用ACME_RESTART_CONTAINERS时，必须挂载/var/run/docker.sock以允许容器操作Docker守护进程
• 域名列表文件domain_list.txt修改后，容器将在24小时内自动检测并更新证书
• 测试环境（ENABLE_STAGING=yes）用于避免Let's Encrypt的请求频率限制，正式环境需设为no