服务对象与地域限制
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 与主机名匹配
shCERT='/PATH/TO/CANDIDATE-CERT.pem'
openssl x509 -in "$CERT" -noout -subject -issuer -dates -ext subjectAltName
openssl x509 -in "$CERT" -noout -checkhost EXAMPLE.HOST
检查部署脚本是否用错误的大小写比较 SAN
若证书确实包含目标域名,但脚本仍报告名称不匹配,检查校验代码是否把 SAN 文本与输入域名做了区分大小写的原始字符串比较。DNS 主机名比较应遵循标准的名称匹配规则;不要通过删除 SAN 检查、只比较 CN 或接受任意通配符来绕过验证。对于复杂通配符,使用受支持的 X.509 主机名验证器。
修改前保存部署脚本和当前有效证书。只在检测器误拒绝真实匹配证书时修正比较方式,再对正确域名、错误域名和通配符边界做离线校验。若 SAN 本身缺少目标名,正确行为是拒绝安装并修复签发配置,不是弱化检测。
核对 cron 与手动运行的脚本路径和环境
手动续签可能在登录 shell 中找到正确的 acme.sh 和部署脚本,而 cron 使用另一个用户、HOME、PATH 或配置目录。检查计划任务实际命令、绝对脚本路径、文件权限和日志输出;确认 acme.sh 账户配置与续签证书属于同一用户。不要只运行交互式命令后就关闭告警。
若 cron 指向旧脚本或过期路径,先备份计划任务,再修正为确认的绝对路径;不要把私钥、DNS API token 或完整账户目录写入 cron 行。通过受控的下一次运行确认任务读取了新配置,检查日志里的签发、部署、校验及 reload 各阶段。
查看当前用户的计划任务和相关定时器
shcrontab -l
systemctl list-timers --all | grep -iE 'acme|cert|renew'
command -v acme.sh
验证服务实际提供的新证书再清理旧版本
部署后对 Nginx 或 x-ui 实际 TLS 端口使用目标 SNI 查看证书 SAN、有效期和链。确认服务进程重新加载了正确文件,并从真实访问路径再次检查。如果本机端口已更新但公网仍返回旧证书,继续排查反代、CDN、负载均衡和缓存,而不是重复签发。
只有新证书满足主机名和有效期要求、服务 reload 成功并且实际入口返回它,才认为部署完成。保留旧证书直到新证书在所有预期端口通过验证;不要过早删除备份或禁用可用的旧证书。
验证服务实际提供的证书链和主机名
shDOMAIN='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
回滚条件和安全限制
若新证书实际 SAN 不含目标名、证书无效或服务 reload 失败,恢复上一张已验证证书及其部署配置,然后再 reload 并检查实际入口。若仅脚本校验误报,不要让脚本覆盖有效新证书;先修正校验器并保存当前候选文件。
DNS 主机名的大小写、SAN 语义和具体 OpenSSL 命令行为应以适用标准及工具版本为准。续签日志、cron 环境和外部 TLS 结果要分别记录;不要把签发成功当作证书已部署,也不要把脚本回滚本身当作新证书无效的证据。
资料来源
常见问题
ACME 显示成功,为什么站点仍返回旧证书?
签发、复制到服务目录、校验、reload 和实际入口返回新证书是不同步骤。逐一检查证书文件和服务端口的结果。
SAN 只在字母大小写上不同就一定不匹配吗?
不能用区分大小写的原始文本比较做结论。按 DNS 主机名匹配规则及当前 X.509 验证工具检查完整目标名。
交互式续签成功,是否说明 cron 已修好?
不一定。cron 可能使用不同用户、PATH、HOME、脚本路径或证书配置目录。检查计划任务实际调用和运行日志。
何时可以删除旧证书备份?
只有新证书在目标 SNI、实际 TLS 端口和预期外部入口都通过验证,并且回滚窗口结束后再评估保留策略。