密码学与证书 / 系统课时

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])

Certbot 插件在证书申请与安装流程中的职责

四类常见方式怎么选

方式 域名验证 自动安装证书 主要前提 常见场景
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 能发现的插件:

bash
sudo certbot plugins

预期输出

text
* 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 插件的选择通常就很明确。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Certbot 插件负责什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通