密码学与证书 / 系统课时

整理 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 路径仍可能不同。

bash
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"

预期输出

text
<IP>
preflight-<ID>

如果这里失败,不要继续申请证书:先纠正 DNS、80 端口转发、Nginx server_name、Challenge location 或 webroot。若 DNS 同时发布 A 与 AAAA,还要分别确认两条网络路径都到达同一套验证内容。

核对 HTTPS、证书路径与私钥权限

443 端口要验证两件事:外部握手拿到的是预期证书,以及 Nginx 配置引用的是 Certbot 当前管理的文件。不要只看 /etc/letsencrypt/live/ 里“有文件”就判断上线完成。

bash
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"

预期结果

text
https_status=<ID>
主机名校验通过,并显示 notBefore / notAfter
Certificate Path 与 Nginx ssl_certificate 指向同一证书链
Private Key Path 与 Nginx ssl_certificate_key 指向同一私钥
私钥实际目标文件不是 world-readable

https_status 的具体状态码由应用决定,关键是请求到达预期站点且 TLS 校验成功。私钥权限也不要机械统一成某个数字模式;应按实际运行账户采用最小权限,并在修改后执行 nginx -t 和重载验证。

验证自动续期真的会发生

Certbot 官方建议用 certbot renew --dry-run 测试未来续期;不同安装方式可能通过 systemd timer 或 cron 调度,因此上线检查必须找到至少一个实际调度入口,不能只假设“安装包会自动处理”。([Certbot文档][2])

bash
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

预期结果

text
renew dry-run:成功
scheduler:能在 systemd timer 或 cron 中找到至少一个 Certbot 续期入口
实际 unit 名称或 cron 路径取决于安装方式

如果证书使用 webroot 续期,而 Nginx 是手工配置证书路径,还要确认成功续期后有可靠的 deploy hook 或等价机制重载 Nginx;否则磁盘上的证书已经更新,443 端口仍可能继续提供旧证书。Certbot 支持在成功续期后运行 deploy hook。([Certbot文档][3])

把到期监控纳入上线

最后从监控节点直接检查 443 端口正在提供的证书,而不是只读取服务器本地文件。下面以“30 天内到期即告警”为例;阈值应按你的发布和响应周期调整。

bash
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

预期输出

text
Certificate will not expire
expiry-window=ok

若进入阈值,输出会变为即将过期并返回非零状态,可直接接入监控系统。上线签字应建立在整条链路同时通过之上:DNS 能到正确入口、Challenge 能取到、443 提供正确证书、私钥权限合理、dry-run 成功、调度真实存在,并且到期监控能独立发现异常。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理 Certbot 上线检查清单

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

登录哪都通