camcamfresh/certbot

Certbot Docker镜像文档

镜像概述和主要用途

该Docker镜像基于Alpine Linux构建，集成Certbot及其LuaDNS插件，用于通过DNS认证方式获取和自动续期多个域名的SSL证书。适用于需要管理多个顶级域名（TLD）通配符证书的场景，尤其适合Unraid服务器环境。

核心功能和特性

• 自动续期机制：通过cron任务每6小时（每天4次）自动运行Certbot，确保证书及时续期
• 多域名管理：支持为多个域名获取证书，逗号分隔的域名为同一证书，空格分隔的域名为独立证书
• DNS认证：使用LuaDNS插件进行DNS验证，支持通配符证书（如*.example.com）
• 数据持久化：配置目录可映射至宿主机，保存证书文件和Certbot工作数据，降低Let's Encrypt请求速率限制风险
• 手动触发支持：可通过容器内/bin/certbot/certbot.sh脚本手动执行证书操作

使用场景和适用范围

• Unraid服务器环境下的SSL证书集中管理
• 需要为多个域名（含通配符域名）配置SSL证书的场景
• 希望实现SSL证书自动续期的个人或小型企业用户
• 使用LuaDNS作为DNS服务提供商的用户（可扩展至其他DNS提供商）

使用方法和配置说明

环境变量配置

必须设置以下环境变量：

配置目录结构

CONFIG_DIR目录需包含以下关键文件/目录：

• luadns.ini：LuaDNS认证配置文件，需包含LuaDNS账户信息：

  ini
  [luadns]
  email = your-luadns-email@example.com
  token = your-luadns-api-token
  

• certs/：存放生成的SSL证书文件（非符号链接，避免卷映射问题）
• data/：存放Certbot工作数据和证书归档文件

Docker部署示例

基本运行命令

bash
docker run -e DOMAINS='example.com,*.example.com example.org,*.example.org vpn.example.org' \
  -e EMAIL='your-email@example.com' \
  -v /path/to/host/config:/config \
  camcamfresh/certbot

关键注意事项

• 数据持久化：务必将宿主机目录（如/path/to/host/config）映射至容器/config目录，避免容器重启后证书和配置丢失
• 域名验证：example.com为保留域名，测试时需替换为实际域名，否则会被Certbot拒绝
• 手动执行：可通过docker exec -it [容器ID] /bin/certbot/certbot.sh手动触发证书更新

扩展说明

当前镜像默认使用LuaDNS作为DNS提供商，如需使用其他DNS服务，可通过修改Dockerfile更换Certbot DNS插件（支持的插件列表见Certbot官方文档）。