密码学与证书 / 系统课时
整理 Certbot 上线检查清单
整理 Certbot 上线检查清单
上线前最容易漏掉的不是“证书能否申请”,而是申请、加载、续期和告警能否形成闭环。本篇把 DNS、80/443、Challenge、证书路径、私钥权限、自动续期和到期监控整理成一套可重复执行的发布检查。
学习目标
- 能按固定顺序检查 DNS、HTTP-01、HTTPS 与证书加载状态。
- 能确认 Certbot 证书路径、私钥权限和 Nginx 引用关系一致。
- 能验证自动续期调度,并用独立到期监控发现续期或重载失效。
先定义上线通过标准
上线检查应验证“外部用户实际访问到的结果”,而不只是确认某条命令执行成功。HTTP-01 的公网验证入口是 80 端口,Challenge 文件必须能通过 /.well-known/acme-challenge/ 被取到。([Let's Encrypt][1])
| 检查项 | 通过标准 |
|---|---|
| DNS | A/AAAA 指向预期公网入口;若发布 AAAA,IPv6 路径也必须可达 |
| 80 / Challenge | 从外部网络能读取预期 Challenge 内容 |
| 443 | TLS 握手成功,访问的是目标站点,证书覆盖当前主机名 |
| 证书路径 | Nginx 引用的证书链与私钥路径和 Certbot 管理对象一致 |
| 私钥权限 | 私钥不对无关用户开放,Nginx 仍具备启动和重载所需读取权限 |
| 自动续期 | certbot renew --dry-run 成功,并且存在实际调度入口 |
| 到期监控 | 监控的是 443 端口当前对外提供的证书,并在阈值内告警 |
验证 DNS 与 Challenge 公网入口
先在 Web 服务器的实际 webroot 放一个一次性探针,再从外部网络请求同一个 URL。服务器本机访问成功不能替代公网检查,因为 DNS、边界防火墙、负载均衡或 IPv6 路径仍可能不同。
HOST="<HOST>"
WEBROOT="<PATH>"
TOKEN="preflight-$(date +%s)"
CHALLENGE_DIR="$WEBROOT/.well-known/acme-challenge"
sudo mkdir -p "$CHALLENGE_DIR"
printf '%s\n' "$TOKEN" | sudo tee "$CHALLENGE_DIR/$TOKEN" >/dev/null
getent ahosts "$HOST" | awk '{print $1}' | sort -u
curl -fsS --max-time 10 "http://$HOST/.well-known/acme-challenge/$TOKEN"
sudo rm -f "$CHALLENGE_DIR/$TOKEN"预期输出
<IP>
preflight-<ID>如果这里失败,不要继续申请证书:先纠正 DNS、80 端口转发、Nginx server_name、Challenge location 或 webroot。若 DNS 同时发布 A 与 AAAA,还要分别确认两条网络路径都到达同一套验证内容。
核对 HTTPS、证书路径与私钥权限
443 端口要验证两件事:外部握手拿到的是预期证书,以及 Nginx 配置引用的是 Certbot 当前管理的文件。不要只看 /etc/letsencrypt/live/ 里“有文件”就判断上线完成。
HOST="<HOST>"
CERT_NAME="<ID>"
curl -sS -o /dev/null -w 'https_status=%{http_code}\n' "https://$HOST/"
echo | openssl s_client -connect "${HOST}:443" -servername "$HOST" 2>/dev/null \
| openssl x509 -noout -checkhost "$HOST" -dates
sudo certbot certificates
sudo nginx -T 2>/dev/null \
| grep -E '^[[:space:]]*ssl_certificate(_key)?[[:space:]]'
sudo stat -Lc '%A %U:%G %n' "/etc/letsencrypt/live/$CERT_NAME/privkey.pem"预期结果
https_status=<ID>
主机名校验通过,并显示 notBefore / notAfter
Certificate Path 与 Nginx ssl_certificate 指向同一证书链
Private Key Path 与 Nginx ssl_certificate_key 指向同一私钥
私钥实际目标文件不是 world-readablehttps_status 的具体状态码由应用决定,关键是请求到达预期站点且 TLS 校验成功。私钥权限也不要机械统一成某个数字模式;应按实际运行账户采用最小权限,并在修改后执行 nginx -t 和重载验证。
验证自动续期真的会发生
Certbot 官方建议用 certbot renew --dry-run 测试未来续期;不同安装方式可能通过 systemd timer 或 cron 调度,因此上线检查必须找到至少一个实际调度入口,不能只假设“安装包会自动处理”。([Certbot文档][2])
sudo certbot renew --dry-run
systemctl list-timers --all | grep -i certbot || true
sudo grep -R "certbot renew" \
/etc/crontab /etc/cron.d /etc/cron.daily /etc/cron.weekly 2>/dev/null || true预期结果
renew dry-run:成功
scheduler:能在 systemd timer 或 cron 中找到至少一个 Certbot 续期入口
实际 unit 名称或 cron 路径取决于安装方式如果证书使用 webroot 续期,而 Nginx 是手工配置证书路径,还要确认成功续期后有可靠的 deploy hook 或等价机制重载 Nginx;否则磁盘上的证书已经更新,443 端口仍可能继续提供旧证书。Certbot 支持在成功续期后运行 deploy hook。([Certbot文档][3])
把到期监控纳入上线
最后从监控节点直接检查 443 端口正在提供的证书,而不是只读取服务器本地文件。下面以“30 天内到期即告警”为例;阈值应按你的发布和响应周期调整。
HOST="<HOST>"
if echo | openssl s_client -connect "${HOST}:443" -servername "$HOST" 2>/dev/null \
| openssl x509 -checkend $((30 * 24 * 60 * 60)) -noout; then
echo "expiry-window=ok"
else
echo "expiry-window=alert"
exit 1
fi预期输出
Certificate will not expire
expiry-window=ok若进入阈值,输出会变为即将过期并返回非零状态,可直接接入监控系统。上线签字应建立在整条链路同时通过之上:DNS 能到正确入口、Challenge 能取到、443 提供正确证书、私钥权限合理、dry-run 成功、调度真实存在,并且到期监控能独立发现异常。