henridwyer/docker-letsencrypt-cron

docker-letsencrypt-cron镜像说明

镜像概述

本Docker镜像基于Let's Encrypt免费证书颁发机构及其客户端certbot，实现网站SSL证书的自动创建与续期。证书每2个月自动更新，最新证书将同步至容器内/certs目录及主机的./certs目录，满足网站HTTPS配置的持续合规需求。

核心功能

1. 自动证书管理：自动生成Let's Encrypt免费SSL证书，并通过cron定时任务每2个月续期；
2. 多模式支持：提供webroot模式（需指定网站根目录）和独立web服务器模式；
3. 灵活配置：可选择合并证书链与私钥（适配haproxy）或分开存储（适配nginx/apache），支持单域名或多域名通配证书；
4. 便捷部署：支持直接使用官方镜像或自行构建，提供docker run及docker-compose部署示例。

使用场景

适用于需要配置HTTPS的各类网站场景，包括个人博客、企业官网、反向代理服务（如haproxy、nginx）等，尤其适合希望自动续期证书以避免手动操作的用户。

配置说明

环境变量配置

• WEBROOT：webroot路径（使用webroot模式时必填，留空则启用独立服务器模式）；
• DOMAINS：空格分隔的域名列表（如domain1.com domain2.com）；
• EMAIL：接收Let's Encrypt通知的***地址；
• CONCAT：是否合并证书链与私钥（true/false，适配haproxy需设为true）；
• SEPARATE：是否为每个域名生成单独证书（true/false）。

部署示例

直接运行官方镜像

shell
docker run --name certbot -v `pwd`/certs:/certs --restart always \
-e "DOMAINS=domain1.com domain2.com" \
-e "EMAIL=webmaster@domain1.com" \
-e "CONCAT=true" \
-e "WEBROOT=" \
henridwyer/docker-letsencrypt-cron

自行构建并启动（使用docker-compose）

1. 构建并启动容器：

shell
docker-compose up -d

2. 首次启动时手动触发证书生成：

shell
docker exec certbot ash -c "/scripts/run_certbot.sh"

（定时任务将在每月奇数月1日3点自动执行续期）

ACME验证配置

需将80端口的/.well-known/路径请求转发至本容器以完成ACME验证：

Haproxy配置示例

haproxy
frontend http
  bind *:80
  acl letsencrypt_check path_beg /.well-known
  use_backend certbot if letsencrypt_check

backend certbot
  server certbot certbot:80 maxconn 32

Nginx配置示例

nginx
upstream certbot_upstream{
  server certbot:80;
}

server {
  listen 80;
  location '/.well-known/acme-challenge' {
    default_type "text/plain";
    proxy_pass http://certbot_upstream;
  }
}

参考链接

• Let's Encrypt官网：[***]
• Certbot GitHub仓库：https://github.com/certbot/certbot

更新日志

0.3

• 新增webroot模式支持；
• 支持一次性为所有域名生成证书。

0.2

• 升级至certbot客户端；
• 基于Alpine Linux构建镜像。

0.1

• 初始版本发布。