schoolbox/bionic-certbot

Ubuntu Bionic Certbot 镜像文档

镜像概述

本镜像基于Ubuntu Bionic（18.04 LTS）系统构建，集成了自定义编译的Certbot（Let's Encrypt证书工具）及多种dns-01验证插件，旨在提供便捷的SSL证书获取与续期解决方案，尤其适用于需要通过DNS验证方式获取证书的场景。

项目源码：https://github.com/alaress/ubuntu-build-image

核心功能与特性

• 基础环境：基于Ubuntu Bionic，确保系统稳定性与兼容性
• Certbot工具：包含自定义构建的最新版Certbot，支持ACME协议
• DNS验证插件：集成多种dns-01验证插件，包括：
  • certbot-dns-cloudflare（Cloudflare DNS）
  • certbot-dns-cloudxns（CloudXNS DNS）
  • certbot-dns-digitalocean（DigitalOcean DNS）
  • certbot-dns-dnsimple（DNSimple DNS）
  • certbot-dns-dnsmadeeasy（DNS Made Easy DNS）
  • certbot-dns-google（Google Cloud DNS）
  • certbot-dns-luadns（LuaDNS）
  • certbot-dns-nsone（NS1 DNS）
  • certbot-dns-rfc2136（RFC 2136动态DNS）
  • certbot-dns-route53（AWS Route 53 DNS）

使用场景与适用范围

• 无法通过HTTP/HTTPS（http-01）验证的服务器环境（如防火墙限制、非80/443端口服务）
• 需要为多个域名或通配符域名（如*.example.com）申请SSL证书
• 自动化SSL证书申请与续期流程
• 依赖各类DNS服务提供商进行域名验证的场景

使用方法与配置说明

基本使用流程

1. 准备对应DNS插件的配置文件（如API密钥、凭证等）
2. 运行容器，挂载配置文件并执行Certbot命令

Docker Run示例

以Cloudflare DNS插件为例，获取通配符证书：

bash
docker run -it --rm \
  -v /path/to/cloudflare.ini:/etc/letsencrypt/cloudflare.ini \
  -v /etc/letsencrypt:/etc/letsencrypt \
  -v /var/lib/letsencrypt:/var/lib/letsencrypt \
  alaress/ubuntu-build-image \
  certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini \
  -d example.com \
  -d *.example.com

配置文件说明

不同DNS插件需使用对应的凭证配置文件，格式示例（以Cloudflare为例）：

ini
# cloudflare.ini
dns_cloudflare_email = your-email@example.com
dns_cloudflare_api_key = your-cloudflare-api-key  

常用命令参数

• certonly：仅获取证书，不自动配置Web服务器
• --dns-[provider]：指定使用的DNS插件（如--dns-cloudflare）
• --dns-[provider]-credentials：指定凭证配置文件路径
• -d：指定需要申请证书的域名（可多次使用）
• --renew-by-default：强制续期证书
• --dry-run：测试模式，不实际申请证书

数据持久化

为避免容器重启后证书丢失，建议挂载以下目录：

• /etc/letsencrypt：存储证书及配置
• /var/lib/letsencrypt：存储Certbot工作文件