密码学与证书 / 系统课时

renew 成功后 Nginx 会自动生效吗

renew 成功后 Nginx 会自动生效吗

certbot renew 成功说明新证书已经取得并写入 Certbot 管理的证书目录,但这不等于正在运行的 Nginx 一定已经切换到新证书。是否自动生效取决于续期时使用的安装器和 hook;对只更新证书文件的链路,通常还需要一次安全的 reload。

学习目标

  • 区分“证书文件已更新”和“Nginx 已加载新证书”
  • 判断现有续期流程是否包含 Nginx reload
  • 使用 deploy hook 在成功续期后可靠地重载 Nginx,并验证对外证书

为什么文件更新不等于进程已经切换

Nginx 启动或 reload 时会读取 ssl_certificate 与 ssl_certificate_key 指向的文件。Certbot 续期后,/etc/letsencrypt/live/<HOST>/ 下的链接会指向新的证书版本,但已经运行的 Nginx worker 不会因为磁盘文件发生变化就自动重新读取它们。

Certbot 续期后通过 deploy hook 让 Nginx 加载新证书的流程

因此,判断标准不应是“续期命令退出码为 0”,而应是续期成功之后有没有触发安装器或 reload。使用 Nginx installer 的流程可能由 Certbot 完成安装相关动作;如果证书是通过 certonly、Webroot 或 DNS 等方式取得,再由 Nginx 直接引用证书文件,则显式配置 deploy hook 更容易保证行为一致。

用 deploy hook 只在成功续期后 reload

Certbot 的 deploy hook 只针对成功签发或成功续期的证书执行,适合把“证书变更”与“Nginx reload”绑定起来。下面创建一个系统级 hook:先测试配置,只有 nginx -t 成功才 reload。

bash
sudo install -d -m 755 /etc/letsencrypt/renewal-hooks/deploy
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh >/dev/null <<'EOF'
#!/bin/sh
set -eu
nginx -t
systemctl reload nginx
EOF
sudo chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

预期结果

text
文件 <PATH>/reload-nginx.sh 被创建并具有可执行权限;以上创建命令成功时通常没有额外终端输出。

这里使用 deploy hook,而不是简单的 post hook,是因为 deploy hook 只在证书实际成功取得后执行。这样当本轮 renew 检查发现“尚未到续期时间”时,不会为了没有发生的证书变更而无意义地 reload Nginx。

单独验证 reload 脚本

先直接执行 hook,确认 Nginx 配置测试和 reload 本身都能成功。这样可以把 Nginx 配置错误与 Certbot 续期错误分开排查。

bash
sudo /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
echo $?

预期输出

text
nginx: the configuration file <PATH>/nginx.conf syntax is ok
nginx: configuration file <PATH>/nginx.conf test is successful
0

如果 nginx -t 失败,脚本会因为 set -e 停止,systemctl reload nginx 不会继续执行,现有 Nginx 进程仍保持原配置提供服务。应先修复配置错误,再测试自动续期链路。

模拟一次成功续期后的 hook

在支持 --run-deploy-hooks 的当前 Certbot 中,可以让 dry-run 成功后同时执行 deploy hook,从而验证“模拟续期成功 → reload”这一整条链路。

bash
sudo certbot renew --dry-run --run-deploy-hooks

预期结果

text
命令退出码应为 0;输出中没有 renewal failure,成功的 dry-run 会执行适用的 deploy hook。

dry-run 使用测试流程,不会把模拟证书替换成生产证书;这里运行 deploy hook 时,reload 的仍是当前有效配置。生产环境上线前,既要确认 dry-run 成功,也要确认 hook 脚本本身能够无交互运行。

验证客户端实际看到的新证书

真正的验收应比较 Certbot 本地证书和客户端从 443 端口拿到的证书序列号。把 <HOST> 替换为实际域名;下面的命令适用于客户端直接连接这台 Nginx 的场景。

bash
HOST="<HOST>"
LOCAL_SERIAL=$(sudo openssl x509 -in "/etc/letsencrypt/live/$HOST/fullchain.pem" -noout -serial | cut -d= -f2)
REMOTE_SERIAL=$(echo | openssl s_client -connect "$HOST:443" -servername "$HOST" 2>/dev/null | openssl x509 -noout -serial | cut -d= -f2)
printf 'local=%s\nremote=%s\n' "$LOCAL_SERIAL" "$REMOTE_SERIAL"

预期输出

text
local=<ID>
remote=<ID>

两行序列号应一致。若本地已经是新证书而远端仍是旧序列号,优先检查 reload 是否执行、请求是否经过反向代理或负载均衡,以及 TLS 是否实际上在其他节点终止。对多节点部署,每个终止 TLS 的节点都必须完成证书同步与 reload,不能只验证其中一台。

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

目录与阅读设置

阅读设置

17

记录一个想法

renew 成功后 Nginx 会自动生效吗

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

登录哪都通