密码学与证书 / 系统课时
用 certonly --webroot 申请证书
用 certonly --webroot 申请证书
这一节完成一次可验证的 Webroot 签发流程:先确认 Nginx 能从指定目录公开挑战文件,再用 certbot certonly --webroot 申请证书。整个过程不让 Certbot 改写 Nginx,证书签发后仍由管理员决定如何部署。
学习目标
- 正确组合
certonly、--webroot、-w与-d参数 - 在正式申请前验证 Webroot 与域名映射
- 判断签发成功后的证书位置以及多域名 Webroot 的参数归属
先确认域名和 Webroot 对得上
-w 指定的是 Web 服务器对外提供文件时所使用的根目录,不是 Nginx 配置文件所在目录,也不是随便选择的可写目录。执行前把 <PATH> 替换为真实 Webroot,把 <HOST> 和 <HOST_ALIAS> 替换为本次证书需要包含的域名;如果只申请一个域名,就删除第二个 -d 参数。
下面的主示例先创建临时挑战文件并通过 HTTP 读取,再删除测试文件并发起签发。首次使用 Certbot 时,终端可能根据本机账户状态要求完成 ACME 账户注册或服务条款确认。
DOMAIN="<HOST>"
ALT_DOMAIN="<HOST_ALIAS>"
WEBROOT="<PATH>"
TOKEN="anystack-webroot-check"
sudo mkdir -p "$WEBROOT/.well-known/acme-challenge"
printf 'webroot-ok\n' | sudo tee "$WEBROOT/.well-known/acme-challenge/$TOKEN" >/dev/null
curl --fail --silent --show-error "http://$DOMAIN/.well-known/acme-challenge/$TOKEN"
sudo rm -f "$WEBROOT/.well-known/acme-challenge/$TOKEN"
sudo certbot certonly \
--webroot \
-w "$WEBROOT" \
-d "$DOMAIN" \
-d "$ALT_DOMAIN"预期结果
webroot-ok
Certbot completes the HTTP-01 validation for <HOST> and <HOST_ALIAS> and reports that the certificate was obtained successfully.
The certificate and private key are stored under /etc/letsencrypt/live/<CERT_NAME>/.证书名称 <CERT_NAME> 由 Certbot 管理,实际目录名可能与第一个域名相同,也可能因已有同名证书而不同。后续配置 Nginx 时应以 Certbot 实际报告的证书路径为准,不要手工猜目录名。
参数分别控制什么
certonly 表示只获取或续订证书,不调用安装器修改 Web 服务器配置。--webroot 选择 Webroot 验证器;-w 指定挑战文件要写入的站点根目录;每个 -d 声明一个要写入证书的域名。
同一个 -w 后可以跟多个 -d,前提是这些域名都能通过这个 Webroot 提供 /.well-known/acme-challenge/。如果一张证书包含的域名分属不同站点目录,需要再次写 -w;后续的 -d 会归属于它前面最近一次出现的 Webroot。
例如,若 a.example.com 和 www.a.example.com 使用目录 A,而 b.example.com 使用目录 B,参数关系应按“目录 A → 两个域名 → 目录 B → 一个域名”的顺序组织,而不是把所有 -d 写完再补目录。
签发成功后不要立即移动证书文件
Certbot 管理的证书通常通过 /etc/letsencrypt/live/<CERT_NAME>/ 下的路径供服务器引用。Nginx 应直接引用 Certbot 管理的 fullchain.pem 和 privkey.pem 路径,而不是把当前文件复制到另一个固定目录后长期使用;否则后续续期完成后,Nginx 可能仍指向旧副本。
本节使用 certonly,因此“签发成功”只代表证书已经获取,并不代表站点已经启用 HTTPS。把证书接入 Nginx、执行配置测试并安全重载,应作为独立部署步骤处理,这样证书生命周期和 Web 服务器配置变更可以分别审计与回滚。
验证失败时按请求链路排查
如果 Certbot 报告 HTTP-01 验证失败,优先回到前面的临时文件测试。404 通常说明域名命中了错误的 server 块或目录映射;403 常见于权限、访问控制或针对隐藏目录的限制;返回业务 HTML 往往意味着挑战路径被反向代理、重写或 SPA 回退接管。
还要确认待申请的每个 -d 域名都已经解析并能从公网访问。多域名证书只要有一个域名验证失败,整次签发就不能按预期完成。先让每个域名的挑战 URL 都能独立返回测试文件,再执行 Certbot,比反复重试签发更容易定位问题。