gordonchan/auto-letsencrypt

gordonchan/auto-letsencrypt

该镜像基于quay.io/letsencrypt/letsencrypt基础镜像，灵感来源于kvaps/letsencrypt-webroot，通过certbot和Webroot方法自动从Let's Encrypt申请、续期SSL/TLS证书，并支持向Web服务器容器发送HUP信号以应用新证书，简化证书管理流程。

核心功能

• 自动向Let's Encrypt申请SSL/TLS证书
• 定期检查并续期即将过期的证书（默认30天）
• 向指定Web服务器容器发送HUP信号，触发配置重载以使用新证书
• 支持将证书复制到自定义目录，避免暴露完整的Let's Encrypt目录
• 可自定义Webroot路径和证书检查频率

使用场景

适用于需要SSL/TLS证书的Web服务（如Nginx、Apache等），自动完成证书的申请与续期，减少手动操作成本。

配置说明

环境变量

• DOMAINS: 证书对应的域名，多个域名用空格分隔（如example.com www.example.com）
• EMAIL: 用于接收紧急通知和密钥恢复的***（如your@email.tld）
• WEBROOT_PATH: Web服务器中ACME挑战文件的存储路径，默认/var/www
• CERTS_PATH: 可选，证书复制的目标目录（如/etc/nginx/certs）
• SERVER_CONTAINER: 可选，需要发送HUP信号的Web服务器容器名称
• SERVER_CONTAINER_LABEL: 可选，用于Docker Swarm场景的服务器容器标签
• CHECK_FREQ: 证书检查频率（天），默认30天

部署示例

Docker Run命令

bash
docker run -d \
  -e 'DOMAINS=example.com www.example.com' \
  -e EMAIL=your@email.tld \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  -v /tmp/letsencrypt:/var/www \
  gordonchan/auto-letsencrypt

带全部功能的Docker Run示例

bash
docker run -d \
  -e 'DOMAINS=example.com www.example.com' \
  -e EMAIL=your@email.tld \
  -e SERVER_CONTAINER=nginx \
  -e CERTS_PATH=/etc/nginx/certs \
  -e WEBROOT_PATH=/tmp/letsencrypt/www \
  -e CHECK_FREQ=7 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  -v /tmp/letsencrypt/www:/tmp/letsencrypt/www \
  -v /etc/nginx/certs:/etc/nginx/certs \
  gordonchan/auto-letsencrypt

Docker Compose示例

yaml
version: '2'

services:
  server:
    container_name: server
    image: gordonchan/nginx-ssl-ghost
    volumes:
      - certs:/etc/nginx/certs
      - /tmp/letsencrypt/www:/tmp/letsencrypt/www
    links:
      - app:ghost
    ports:
      - "80:80"
      - "443:443"
    restart: unless-stopped

  letsencrypt:
    container_name: letsencrypt
    image: gordonchan/auto-letsencrypt
    links:
      - server
    volumes:
      - /var/log/letsencrypt/:/var/log/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock
      - /etc/letsencrypt:/etc/letsencrypt
      - /var/lib/letsencrypt:/var/lib/letsencrypt
      - /tmp/letsencrypt/www:/tmp/letsencrypt/www
      - certs:/etc/nginx/certs
    environment:
      - EMAIL=your@email.tld
      - SERVER_CONTAINER=server
      - WEBROOT_PATH=/tmp/letsencrypt/www
      - CERTS_PATH=/etc/nginx/certs
      - DOMAINS=example.com www.example.com
      - CHECK_FREQ=7
    restart: unless-stopped

volumes:
  certs:

许可证

该镜像基于MIT许可证发布，可根据https://github.com/gchan/dockerfiles/blob/master/LICENSE.txt%E6%96%87%E4%BB%B6%E7%9A%84%E6%9D%A1%E6%AC%BE%E9%87%8D%E6%96%B0%E5%88%86%E5%8F%91%E3%80%82