cargsl/cloudflare-certbot-cron

Cloudflare Certbot Docker镜像

镜像概述和主要用途

该Docker镜像旨在运行Let's Encrypt Certbot工具，通过Cloudflare的DNS验证机制生成SSL证书。主要用于为域名获取免费、可信的SSL/TLS证书，无需在服务器上开放80/443端口，特别适合使用Cloudflare作为DNS服务提供商的用户。

核心功能和特性

• 集成Let's Encrypt Certbot，支持自动生成和更新SSL证书
• 采用Cloudflare DNS验证方式，避免对服务器端口的依赖
• 支持证书配置和生成文件的持久化存储
• 容器重启策略默认配置为自动恢复，确保服务稳定性

使用场景和适用范围

• 需要为域名获取免费SSL证书的个人或企业用户
• 使用Cloudflare作为DNS服务提供商的网站管理员
• 服务器环境受限（如无法开放80/443端口）但需配置HTTPS的场景
• 需要自动化SSL证书管理的Docker化部署环境

详细使用方法和配置说明

基本部署命令

使用以下docker run命令部署镜像：

bash
docker run -d \
  --name cloudflare-certbot-cron \
  --restart unless-stopped \
  -v "$(pwd)/tls-config:/config" \
  -v "$(pwd)/tls-config:/etc/letsencrypt" \
  docker.xuanyuan.run/cloudflare-certbot-cron:latest

参数说明

• -d: 以守护进程模式后台运行容器
• --name cloudflare-certbot-cron: 指定容器名称为cloudflare-certbot-cron，便于管理
• --restart unless-stopped: 设置容器重启策略，除非手动停止，否则自动重启
• -v "$(pwd)/tls-config:/config": 挂载本地目录到容器内/config，用于存储配置文件
• -v "$(pwd)/tls-config:/etc/letsencrypt": 挂载本地目录到容器内/etc/letsencrypt，用于存储生成的SSL证书文件

配置要求

1. 本地需提前创建tls-config目录，确保容器有读写权限：

   bash
   mkdir -p $(pwd)/tls-config && chmod 755 $(pwd)/tls-config
   

2. 需配置Cloudflare API认证信息（通常通过环境变量或配置文件设置，具体方法请参考Certbot Cloudflare插件文档）

注意事项

• 首次运行前需确保Cloudflare DNS配置正确，域名解析指向Cloudflare
• 证书生成过程可能需要几分钟时间，可通过docker logs cloudflare-certbot-cron查看进度
• 生成的证书文件位于本地tls-config目录下，可用于Web服务器配置