carlesbarreda/certbot

carlesbarreda/certbot

基于https://hub.docker.com/r/certbot/certbot/%E7%9A%84%E5%A4%9A%E5%B9%B3%E5%8F%B0%E9%95%9C%E5%83%8F%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86https://github.com/rdrgzlng/certbot-dns-dinahosting%EF%BC%8C%E7%94%A8%E4%BA%8ECertbot%E5%B7%A5%E5%85%B7%E3%80%82

https://github.com/carlesbarreda/docker-certbot/actions/workflows/docker-image-ci.yml/badge.svg](https://github.com/carlesbarreda/docker-certbot/actions/workflows/docker-image-ci.yml)

镜像概述和主要用途

该镜像扩展了官方Certbot镜像，添加了Dinahosting DNS验证插件，允许用户通过DNS-01挑战方式为Dinahosting托管的域名获取和续期Let's Encrypt SSL证书。适用于需要自动化SSL证书管理的场景，尤其适合无法通过HTTP-01挑战验证的服务器环境。

核心功能和特性

• 多平台支持：支持多种架构的Docker环境
• 基于官方镜像：构建于官方certbot/certbot镜像之上，确保兼容性和安全性
• 集成Dinahosting DNS插件：无需手动配置DNS记录，自动完成域名验证
• 完整的证书生命周期管理：支持证书注册、获取、续期等操作

使用场景和适用范围

• 需要为Dinahosting托管的域名获取Let's Encrypt SSL证书的用户
• 无法使用HTTP-01挑战（如服务器位于防火墙后或无公网HTTP服务）的场景
• 希望自动化SSL证书管理流程的系统管理员

使用方法和配置说明

前提条件

• 拥有Dinahosting托管的域名
• Dinahosting账户的用户名和密码

步骤1：创建目录和凭据文件

bash
mkdir -p ./certbot/etc/secrets
cat <<EOF > ./certbot/etc/secrets/dinahosting.ini
dns_dinahosting_username = "your_dinahosting_username"
dns_dinahosting_password = "your_dinahosting_password"
EOF

步骤2：拉取镜像

bash
docker pull carlesbarreda/certbot:latest

步骤3：注册Let's Encrypt ACME账户

bash
docker run --rm \
  --volume "./certbot/etc:/etc/letsencrypt" \
  --volume "./certbot/lib:/var/lib/letsencrypt" \
  --volume "./certbot/log:/var/log/letsencrypt" \
  --cap-drop=all \
  carlesbarreda/certbot:latest register \
    --email "your_email@example.com" \
    --agree-tos \
    --non-interactive

步骤4：获取或续期证书

bash
docker run --rm \
  --volume "./certbot/etc:/etc/letsencrypt" \
  --volume "./certbot/lib:/var/lib/letsencrypt" \
  --volume "./certbot/log:/var/log/letsencrypt" \
  --cap-drop=all \
  carlesbarreda/certbot:latest certonly \
    --authenticator dns-dinahosting \
    --dns-dinahosting-credentials /etc/letsencrypt/secrets/dinahosting.ini \
    --dns-dinahosting-propagation-seconds 900 \
    --domains example.com,*.example.com \
    --renew-by-default \
    --non-interactive

步骤5：查看生成的证书

成功后，证书将存储在 ./certbot/etc/live/example.com 目录下。

注意事项

• 域名所有权：必须拥有Dinahosting托管的域名才能使用此插件
• 自定义构建：可通过以下命令构建自定义镜像：

  bash
  docker build --tag dockeruser/certbot:latest -<<EOF
  FROM certbot/certbot:latest
  RUN /usr/local/bin/python -m pip install --upgrade pip \
      && pip install https://github.com/rdrgzlng/certbot-dns-dinahosting/tarball/master
  VOLUME ["/etc/letsencrypt"]
  VOLUME ["/var/lib/letsencrypt"]
  VOLUME ["/var/log/letsencrypt"]
  EOF
  

• 多平台构建：参考仓库中的 buildx-images.ps1 和 buildx-images.sh 脚本进行多平台构建，需Docker引擎支持实验性功能及buildx命令