PuppyIP 资源中心
网络与连接排错 9 分钟 发布于 2026-11-17

acme.sh 续签成功却被回滚:检查 SAN 校验大小写与定时任务路径

ACME 日志显示签发成功而站点仍返回旧证书时,先检查部署校验和定时任务执行路径,再决定是否需要证书回滚。

acme.sh SAN 证书续签 cron Nginx TLS 回滚

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 签发成功、安装到目标路径、服务 reload 和客户端实际看到新证书是不同步骤。
  • 用区分大小写的文本比较 SAN 可能误拒绝只在字母大小写上不同的 DNS 名称;校验应按 DNS 主机名规则比较并验证实际证书。
  • cron 与交互 shell 的 PATH、HOME 和脚本路径可能不同,手动命令成功不证明定时任务运行相同脚本。
  • 保留上一张可用证书和部署日志,只有验证新证书真实不匹配时才回滚。

把续签、部署、校验和回滚分成四步

acme.sh 成功签发证书,并不自动证明 Nginx 或 x-ui 已载入新证书。续签流程通常还包含证书复制/安装、证书内容校验、服务 reload 和失败回滚;其中任何一步误判,都可能导致磁盘上的证书与客户端看到的证书不一致。

若脚本在 SAN 检查失败后将旧证书恢复,先对照 ACME 输出、候选证书文件、部署目标、回滚记录和服务器实际返回值。不要只因文件时间戳较新就认定新证书正在服务,也不要因回滚日志就立即重新签发。

只读检查证书的 SAN、有效期和目标主机名

在安全的服务器终端查看候选证书的 subject、issuer、有效期和 subjectAltName,确认目标域名是否确实包含在证书中。现代主机名验证应以 SAN 为准,不能仅凭 CN 或脚本中的字符串片段判定。若新证书没有目标 DNS 名称或已过期,应停止部署并检查 ACME 请求的域名,而不是放宽校验。

再用与当前 OpenSSL 版本匹配的主机名验证选项检查完整名称。不同版本工具的选项可能不同;若命令不支持,应按当前版本官方文档采用等价验证。分享输出前遮盖私钥路径、真实主机名、账户目录和部署主机标识。

读取候选证书的 SAN 与主机名匹配

sh
CERT='/PATH/TO/CANDIDATE-CERT.pem'
openssl x509 -in "$CERT" -noout -subject -issuer -dates -ext subjectAltName
openssl x509 -in "$CERT" -noout -checkhost EXAMPLE.HOST
在服务器本机将证书路径和目标主机占位符替换为实际值。若 OpenSSL 版本不支持 -checkhost,先查该版本文档;这些命令仅读取证书。

检查部署脚本是否用错误的大小写比较 SAN

若证书确实包含目标域名,但脚本仍报告名称不匹配,检查校验代码是否把 SAN 文本与输入域名做了区分大小写的原始字符串比较。DNS 主机名比较应遵循标准的名称匹配规则;不要通过删除 SAN 检查、只比较 CN 或接受任意通配符来绕过验证。对于复杂通配符,使用受支持的 X.509 主机名验证器。

修改前保存部署脚本和当前有效证书。只在检测器误拒绝真实匹配证书时修正比较方式,再对正确域名、错误域名和通配符边界做离线校验。若 SAN 本身缺少目标名,正确行为是拒绝安装并修复签发配置,不是弱化检测。

核对 cron 与手动运行的脚本路径和环境

手动续签可能在登录 shell 中找到正确的 acme.sh 和部署脚本,而 cron 使用另一个用户、HOME、PATH 或配置目录。检查计划任务实际命令、绝对脚本路径、文件权限和日志输出;确认 acme.sh 账户配置与续签证书属于同一用户。不要只运行交互式命令后就关闭告警。

若 cron 指向旧脚本或过期路径,先备份计划任务,再修正为确认的绝对路径;不要把私钥、DNS API token 或完整账户目录写入 cron 行。通过受控的下一次运行确认任务读取了新配置,检查日志里的签发、部署、校验及 reload 各阶段。

查看当前用户的计划任务和相关定时器

sh
crontab -l
systemctl list-timers --all | grep -iE 'acme|cert|renew'
command -v acme.sh
在执行续签的同一账号下只读检查任务入口与命令路径;cron 行可能含域名或密钥引用,分享前先脱敏。

验证服务实际提供的新证书再清理旧版本

部署后对 Nginx 或 x-ui 实际 TLS 端口使用目标 SNI 查看证书 SAN、有效期和链。确认服务进程重新加载了正确文件,并从真实访问路径再次检查。如果本机端口已更新但公网仍返回旧证书,继续排查反代、CDN、负载均衡和缓存,而不是重复签发。

只有新证书满足主机名和有效期要求、服务 reload 成功并且实际入口返回它,才认为部署完成。保留旧证书直到新证书在所有预期端口通过验证;不要过早删除备份或禁用可用的旧证书。

验证服务实际提供的证书链和主机名

sh
DOMAIN='EXAMPLE.HOST'
CONNECT_ADDRESS='127.0.0.1'
PORT='REPLACE_WITH_TLS_PORT'
openssl s_client -connect "$CONNECT_ADDRESS:$PORT" -servername "$DOMAIN" -verify_hostname "$DOMAIN" -verify_return_error </dev/null
替换地址、端口和域名为实际 TLS 入口与目标 SNI。该命令要求 OpenSSL 支持 verify_hostname,且不会隐藏 TLS 握手或验证错误。

回滚条件和安全限制

若新证书实际 SAN 不含目标名、证书无效或服务 reload 失败,恢复上一张已验证证书及其部署配置,然后再 reload 并检查实际入口。若仅脚本校验误报,不要让脚本覆盖有效新证书;先修正校验器并保存当前候选文件。

DNS 主机名的大小写、SAN 语义和具体 OpenSSL 命令行为应以适用标准及工具版本为准。续签日志、cron 环境和外部 TLS 结果要分别记录;不要把签发成功当作证书已部署,也不要把脚本回滚本身当作新证书无效的证据。

资料来源

常见问题

ACME 显示成功,为什么站点仍返回旧证书?

签发、复制到服务目录、校验、reload 和实际入口返回新证书是不同步骤。逐一检查证书文件和服务端口的结果。

SAN 只在字母大小写上不同就一定不匹配吗?

不能用区分大小写的原始文本比较做结论。按 DNS 主机名匹配规则及当前 X.509 验证工具检查完整目标名。

交互式续签成功,是否说明 cron 已修好?

不一定。cron 可能使用不同用户、PATH、HOME、脚本路径或证书配置目录。检查计划任务实际调用和运行日志。

何时可以删除旧证书备份?

只有新证书在目标 SNI、实际 TLS 端口和预期外部入口都通过验证,并且回滚窗口结束后再评估保留策略。