leojonathanoh/docker-certbot-dns-cron

docker-certbot-dns-cron

镜像概述

本镜像将Certbot（EFF开发的SSL证书工具）Docker化，集成DNS验证插件、定时任务（cron）、部署脚本及邮件提醒功能，旨在帮助用户自动获取、续期SSL证书，简化证书管理流程。

核心功能

1. 多DNS插件支持：兼容Cloudflare、AWS Route53、Google Cloud DNS等主流DNS提供商，通过DNS验证方式获取证书；
2. 定时自动续期：通过cron任务定期检查证书有效期，自动续期即将过期的证书；
3. 自定义部署钩子：证书更新后可自动执行自定义脚本（如重启Web服务）；
4. 邮件状态通知：证书更新成功或续期失败时发送邮件提醒，及时掌握证书状态。

使用场景

• 网站服务无法通过HTTP验证获取证书（如无公网HTTP访问、使用非标准端口）；
• 批量管理多个域名的SSL证书；
• 需要证书更新后自动触发服务配置更新。

配置说明

通过环境变量配置关键参数：

• EMAIL：接收通知的***地址；
• DOMAINS：目标域名（如example.com,*.example.com）；
• DNS_PLUGIN：DNS插件名称（如cloudflare）；
• DNS_PLUGIN_API_KEY：DNS提供商的API密钥；
• CRON_SCHEDULE：定时任务时间（默认0 0 * * *）；
• DEPLOY_HOOK：证书更新后执行的脚本路径（如/app/deploy.sh）。

部署示例

Docker Run命令

bash
docker run -d \
  --name certbot-dns \
  -e EMAIL="your-email@example.com" \
  -e DOMAINS="example.com,*.example.com" \
  -e DNS_PLUGIN="cloudflare" \
  -e DNS_PLUGIN_API_KEY="your-cloudflare-api-key" \
  -v /path/to/certs:/etc/letsencrypt \
  leojonathanoh/docker-certbot-dns-cron

Docker Compose示例

yaml
version: '3'
services:
  certbot:
    image: leojonathanoh/docker-certbot-dns-cron
    environment:
      *** "***"
      DOMAINS: "example.com,*.example.com"
      DNS_PLUGIN: "cloudflare"
      DNS_PLUGIN_API_KEY: "your-cloudflare-api-key"
      CRON_SCHEDULE: "0 2 * * *"
    volumes:
      - ./certs:/etc/letsencrypt
      - ./deploy.sh:/app/deploy.sh
    restart: always