密码学与证书 / 系统课时
Certbot 插件负责什么
Certbot 插件负责什么
使用 Certbot 申请证书时,真正决定“怎样证明域名控制权”和“是否自动修改 Web 服务器配置”的是插件。理解 nginx、webroot、standalone 与 DNS 插件的职责后,就能根据服务器现状选择合适的验证方式,而不是只记命令参数。
学习目标
- 区分 Certbot 的认证器与安装器职责
- 理解 nginx、webroot、standalone 和 DNS 插件的工作方式
- 使用
certbot plugins检查当前服务器实际可用的插件
先分清认证器和安装器
Certbot 获取证书时至少需要一个 Authenticator(认证器)。认证器负责完成 ACME 域名控制权验证,例如让 CA 能访问指定 HTTP 文件,或者检查 DNS TXT 记录。只有验证成功,CA 才会签发证书。
Installer(安装器) 是另一项职责。它负责把已经取得的证书接入 Web 服务器配置,例如修改 Nginx 的 TLS 配置并重新加载服务。安装器不是签发证书的必要条件,因为也可以取得证书后手工配置服务器。
nginx 插件同时具备认证与安装能力;webroot、standalone 以及常见的 DNS 提供商插件主要承担认证工作。Certbot 官方文档也将插件按 Authenticator 与 Installer 两类能力区分。([Certbot文档][1])

四类常见方式怎么选
| 方式 | 域名验证 | 自动安装证书 | 主要前提 | 常见场景 |
|---|---|---|---|---|
nginx |
HTTP-01 | 可以 | Nginx 已运行,域名可通过 80 端口访问 | 希望 Certbot 同时完成验证和 Nginx HTTPS 配置 |
webroot |
HTTP-01 | 不负责 | 已有 Web 服务,并知道站点 Web Root | 不希望 Certbot 修改现有 Web 配置 |
standalone |
HTTP-01 | 不负责 | Certbot 能占用并对公网开放 80 端口 | 没有现成 Web 服务,或可以临时停止它 |
| DNS 插件 | DNS-01 | 通常不负责 Web 配置 | DNS 服务商提供受支持的 API 和凭据 | 通配符证书、80 端口不可达或证书机与 Web 服务器分离 |
webroot 不会自己启动 Web 服务器,而是把 ACME 挑战文件写到指定站点目录的 .well-known/acme-challenge/ 下,再由现有服务器对外提供。standalone 则相反:它临时启动自己的 HTTP 服务,因此如果 Nginx 已占用 80 端口,通常需要先解决端口冲突。([Certbot文档][2])
DNS 插件通过创建 TXT 记录完成 DNS-01 验证,不要求 CA 访问服务器的 80 端口,也是申请通配符证书时常用的方式。不同 DNS 服务商通常对应不同插件,是否已安装不能只凭 Certbot 本体是否存在来判断。
用 certbot plugins 看本机能力
在真正申请证书前,可以先列出当前 Certbot 能发现的插件:
sudo certbot plugins预期输出
* nginx
Description: Nginx Web Server plugin
Interfaces: Authenticator, Installer, Plugin
Entry point: <ENTRY_POINT>
* webroot
Description: Place files in webroot directory
Interfaces: Authenticator, Plugin
Entry point: <ENTRY_POINT>实际列表取决于安装方式和已经安装的附加插件,因此可能没有 nginx 或任何 DNS 插件。重点查看插件名称以及 Interfaces:包含 Authenticator 表示能参与验证,包含 Installer 表示还能承担证书安装职责。<ENTRY_POINT> 的实际值会随 Certbot 版本和安装包变化。
如果准备执行 certbot --nginx,却在插件列表中看不到 nginx,应先按当前 Certbot 的安装方式补齐对应 Nginx 插件,而不是继续尝试申请命令。
插件与命令不是一回事
插件描述的是“由谁完成某项职责”,命令则决定“这一次运行要做什么”。例如安装了 nginx 插件后,certbot --nginx 可以让它参与申请并安装证书,而 certbot certonly --nginx 使用 Nginx 完成认证,却只取得证书,不执行最终安装。
选择插件时可以先回答两个问题:域名控制权准备通过 HTTP 还是 DNS 证明,以及证书签发后是否允许 Certbot 自动修改 Web 服务器配置。 这两个条件确定后,nginx、webroot、standalone 与 DNS 插件的选择通常就很明确。