跳到主要内容
安装配置教程

宝塔 SSL 证书无效怎么排查?根因、Nginx 配置示例与验证命令全流程

宝塔ssl证书无效 — 宝塔 SSL 证书无效怎么排查?根因、Nginx 配置示例与验证命令全流程
核心结论

宝塔 SSL 证书无效通常不是面板没保存,而是证书链不完整、域名不匹配、Nginx 未重载或 CDN 仍用旧证书;用 openssl s_client -connect 域名:443 -servername 域名 可一次看出实际下发证书的 CN/SAN 与有效期。 宝塔 8.x/9.x 的证书路径通常是 /www/server/panel/vhost/cert/域名/fullchain.pem 与 privkey.pem,Nginx 配置需同时包含 ssl_certificate 和 ssl_certificate_key,改完执行 nginx -t && nginx -s reload。 Let's Encrypt 证书有效期 90 天,acme.sh 3.0.x 默认在第 60 天续期;若续期后浏览器仍报 NET::ERR_CERT_DATE_INVALID,优先检查 CDN/负载均衡是否回源旧证书。 对比:免费 DV 0 元/90 天,商业 DV 约 10–100 元/年,OV 约 300–1500 元/年;自签名证书浏览器会告警,只适合内网或测试。 验证:curl -Iv https://域名 2>&1 | grep -E 'SSL certificate|expire|subject',再用 SSL Labs 检查链完整性,目标为 Chain issues: None 且证书链可信。

为什么宝塔面板显示证书已部署,浏览器仍提示“证书无效”?

宝塔面板显示“证书已部署”,本质上只说明它把 PEM 内容写进了 /www/server/panel/vhost/nginx/*.conf 里的 ssl_certificate 与 ssl_certificate_key 指令——面板既不校验证书链是否完整,也不检查 SAN、系统时间和吊销状态。因此“面板打绿勾、浏览器报红锁”完全可以同时成立,宝塔ssl证书无效的绝大多数案例都落在下面六类根因里。据 Let’s Encrypt 文档,其叶子证书由中间证书(如 R10/R11)签发,服务器必须把中间证书一并下发;RFC 5280 §6 要求客户端能自行构建出从叶子到信任锚的完整路径,缺环即失败。

浏览器报错 最可能根因 一条命令定位
NET::ERR_CERT_AUTHORITY_INVALID 证书链缺中间证书 openssl s_client -showcerts
ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN SAN 不含当前域名 openssl x509 -text | grep -A1 "Alternative Name"
NET::ERR_CERT_DATE_INVALID 证书过期,或本机时钟偏差 >5 分钟 date -u、timedatectl
证书显示为其他域名 443 端口 server_name 冲突 / 未 reload nginx -t && nginx -s reload
仅部分地区报错 CDN 边缘仍缓存旧证书 对比源站与 CDN 的 serial
ERR_CERT_REVOKED 证书被吊销(如私钥泄露) openssl ocsp

1. 证书链不完整。这是 Windows 与旧版 Android 报 NET::ERR_CERT_AUTHORITY_INVALID 的头号原因。宝塔证书目录下 fullchain.pem 的正确顺序是“叶子证书在前、中间证书在后”,根证书通常不放(客户端自带,顺序错了反而握手失败)。验证服务器实际下发了什么:

# 查看服务端实际下发的整条链,正确时应输出 2 组 s:/i:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E "^(s|i):"
# 正常输出示例:
# s:/CN=example.com
# i:/C=US/O=Let's Encrypt/CN=R11
# s:/C=US/O=Let's Encrypt/CN=R11
# i:/C=US/O=Internet Security Research Group/CN=ISRG Root X1
# 若只有一组 s:/i:,说明只配了域名证书,需改用 fullchain.pem

2. 域名不匹配。证书 SAN 不覆盖当前访问域名时,Chrome 报 ERR_CERT_COMMON_NAME_INVALID,Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN。注意通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com(RFC 6125 §6.4.3)。

openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -text 
  | grep -A1 "Subject Alternative Name"

3. 服务器时间偏差。系统时间与真实时间相差超过 5 分钟即触发 NET::ERR_CERT_DATE_INVALID。生产机建议常开 chronyd 或 systemd-timesyncd:

date -u                    # 与外部时间源比对
timedatectl status         # 关注 "System clock synchronized: yes"
chronyc tracking           # Last offset 应远小于 5 分钟

4. Nginx 未重载或多站点冲突。宝塔保存证书只改 vhost 文件,不自动 reload,进程仍下发旧证书;同一 443 端口若 server_name 重复,Nginx 会用该端口的第一个 server 块(或 default_server)响应 SNI 不匹配的请求,浏览器于是看到别的域名证书。

nginx -t && nginx -s reload      # 改完证书必须执行
grep -rn "listen 443|server_name" /www/server/panel/vhost/nginx/*.conf   # 查冲突

5. CDN 缓存旧证书。源站换证后边缘节点可能仍下发旧证书。直连源站 IP 与走 CDN 各取一次 serial 对比即可定位是哪一层没更新:

# 直连源站(-servername 保留 SNI)
openssl s_client -connect 1.2.3.4:443 -servername example.com /dev/null 
  | openssl x509 -noout -serial -enddate
# 走 CDN 域名
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -serial -enddate

6. 证书过期或被吊销。Let’s Encrypt 证书有效期 90 天(ACME 协议与 Let’s Encrypt 文档明确说明),到期即报 NET::ERR_CERT_DATE_INVALID;私钥泄露等情形被吊销后报 ERR_CERT_REVOKED。

openssl x509 -in fullchain.pem -noout -enddate        # 查到期时间
openssl ocsp -issuer chain.pem -cert cert.pem 
  -url http://r11.o.lencr.org -resp_text -no_nonce    # 查吊销状态,返回 "good" 为正常

排查顺序建议:先用 openssl s_client -showcerts 看链是否完整,再用 openssl x509 -text 看 SAN 与有效期,最后对比源站/CDN 的 serial——三步能覆盖宝塔ssl证书无效中八成以上的场景。

宝塔 SSL 证书无效的完整修复步骤(按顺序执行)

问:宝塔面板里证书状态显示”已部署”,浏览器却仍然报 NET::ERR_CERT_DATE_INVALID 或”证书无效”?先别急着删站点重装。下面 6 步按顺序执行,每一步都有可验证的输出,出问题能立刻定位到具体环节。

第 1 步:备份现场,记录版本

# 备份 Nginx 站点配置与证书目录,任何一步失败都能原样回滚
tar -czf /root/bt-nginx-$(date +%F).tgz 
  /www/server/panel/vhost/nginx 
  /www/server/panel/vhost/cert

# 记录版本与证书到期时间,后续对比用
bt default            # 宝塔 8.x / 9.x 面板与组件版本
nginx -v              # 实测常见 nginx/1.22.1、nginx/1.24.0
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem 
  -noout -enddate     # 记录 notAfter

第 2 步:核对 Nginx 真正加载的那张证书。面板显示和磁盘文件经常不一致——尤其是手工上传过证书、或续签后没重载。据 RFC 6125,现代客户端只认 SAN 扩展,CN 字段早已不参与匹配:

openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem 
  -noout -subject -issuer -dates -ext subjectAltName

期望看到 X509v3 Subject Alternative Name: DNS:example.com, DNS:www.example.com,且 Not After 晚于当前时间。如果 SAN 里只有裸域、缺 www,或者日期是去年的,那就是”证书无效”的真正原因,直接跳到第 3 步重签。

第 3 步:重新签发或上传。路径:宝塔面板 > 网站 > 设置 > SSL > Let’s Encrypt,裸域与 www 两个都勾选。两种验证方式怎么选:

验证方式 端口/依赖要求 典型耗时 常见失败原因
文件验证(HTTP-01) 80 端口对公网可达,/.well-known/acme-challenge/ 不被伪静态或 CDN 拦截 约 10–30 秒 开了”强制 HTTPS”导致 301 跳转、安全组未放行 80
DNS 验证(DNS-01) Cloudflare / 阿里云 DNS API Token 具备 Zone.DNS 编辑权限 API 返回后等待约 120 秒生效 Token 权限不足、DNS 未刷新、泛域名记录冲突

据 Let’s Encrypt 文档,HTTP-01 必须能从公网访问 80 端口的质询文件,且不允许跟随到 HTTPS 的跳转,这是文件验证失败最常见的原因。泛域名(*.example.com)只能用 DNS 验证。

第 4 步:写入 443 server 块。最常见的坑是只改了 80 端口的配置:

server {
    listen 443 ssl;
    http2 on;                                  # Nginx 1.25.1+ 写法;旧版用 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /www/server/panel/vhost/cert/example.com/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;

    ssl_protocols       TLSv1.2 TLSv1.3;       # Mozilla 中间配置推荐值,禁用 TLSv1.0/1.1
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;
}

fullchain.pem 必须含中间证书,只配 cert.pem 会导致部分安卓机和旧版 curl 报”证书链不完整”。

第 5 步:测试并重载

nginx -t
# 期望输出:
# nginx: the configuration file /www/server/nginx/conf/nginx.conf syntax is ok
# nginx: configuration file /www/server/nginx/conf/nginx.conf test is successful

nginx -s reload     # 或 systemctl reload nginx

如果 nginx -t 报 cannot load certificate ... PEM_read_bio_X509_AUX() failed,说明文件损坏或路径写错,回到第 2 步重新导出。Nginx 1.22 与 1.24 的重载语义一致,均支持热重载不断连接。

第 6 步:清缓存复验。浏览器用无痕窗口打开,避免 HSTS 或旧会话干扰;挂了 CDN 的站点需在控制台刷新证书缓存,通常等 5–10 分钟生效。Cloudflare 代理模式下,SSL/TLS 必须设为 Full (strict)——Flexible 模式会让边缘以 HTTP 回源,源站证书形同虚设,还容易触发重定向循环。验证命令:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -subject -dates -ext subjectAltName
curl -sSI https://example.com | head -1     # 期望 HTTP/2 200 或 HTTP/1.1 200

只要这条 s_client 输出与第 2 步的本地文件一致,就说明宝塔 SSL 证书无效的问题出在客户端缓存或 CDN 层,而不是源站配置。

Nginx 与 OpenSSL 配置/命令示例(可直接复制)

宝塔面板生成的站点配置默认写在 /www/server/panel/vhost/nginx/example.com.conf,证书文件则由 Let’s Encrypt 或 acme.sh 落在 /www/server/panel/vhost/cert/example.com/ 目录下。出现“宝塔 SSL 证书无效”时,先确认 Nginx 读到的到底是不是这两个路径下的文件——很多无效案例都是因为站点绑定了新域名,而 server_name 仍是旧域名,证书与 SNI 不匹配。

下面是 Nginx 1.22 / 1.24(宝塔 7.x、8.x 默认版本)的最小可用 443 配置,可直接复制后按域名替换:

# /www/server/panel/vhost/nginx/example.com.conf
server {
    listen 443 ssl http2;                 # 1.25.1 起 http2 需拆成独立指令,见下
    server_name example.com www.example.com;   # 两个域名都要写,否则 www 会拿到默认站证书

    ssl_certificate     /www/server/panel/vhost/cert/example.com/fullchain.pem;  # 必须含中间证书
    ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;

    ssl_protocols       TLSv1.2 TLSv1.3;  # 显式声明,避免继承到 TLSv1.0/1.1
    ssl_session_cache   shared:SSL:10m;   # 10m 约可缓存 4 万个会话
    ssl_session_timeout 1d;

    root  /www/wwwroot/example.com;
    index index.php index.html;

    # ACME 文件验证专用,必须放在伪静态规则之前
    location ^~ /.well-known/acme-challenge/ {
        default_type text/plain;
        root /www/wwwroot/example.com;
    }
}

Nginx 1.25.1 起官方 CHANGES 明确废弃了 listen ... http2 写法,继续使用会在 nginx -t 时提示 the "listen ... http2" directive is deprecated, use the "http2" directive instead,应改为 listen 443 ssl; 加一行独立的 http2 on;。两者差异如下:

Nginx 版本 HTTP/2 开启方式 说明
1.22 / 1.24 listen 443 ssl http2; 宝塔默认版本,仍为唯一写法
1.25.1+ listen 443 ssl; + http2 on; 旧写法仍兼容但产生 deprecation 警告

证书链检查:证书“无效”最常见的根因是只部署了站点证书、漏掉中间证书。用 OpenSSL 1.1.1 / 3.x 直接向线上服务端取证书链:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

把 -showcerts 换成 -status 之外,再单独看握手结果里的验证码:若出现 Verify return code: 20 (unable to get local issuer certificate),就是中间证书缺失——服务端只发了叶子证书。把 fullchain.pem(叶子证书 + 中间证书)而非 cert.pem 写进 ssl_certificate 即可。据 OpenSSL 文档,verify code 20 对应 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY,常见返回码含义如下:

返回码 含义 典型原因
0 ok 链完整且可信
20 unable to get local issuer certificate 中间证书缺失
21 unable to verify the first certificate 同上,客户端无根证书
10 certificate has expired 证书过期,续期未生效
18 self-signed certificate 误部署自签证书

私钥匹配检查:ssl_certificate 与 ssl_certificate_key 不配对时,Nginx 会直接启动失败并报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。RSA 证书用 modulus 比对,两行 MD5 必须完全一致:

# RSA 证书:两条命令输出的 MD5 必须一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5

# ECDSA 证书(Let's Encrypt 已普遍签发 ECDSA):用公钥 SHA256 比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256
openssl pkey -in privkey.pem -pubout       | openssl sha256

ACME 文件验证:Let’s Encrypt 文档规定 HTTP-01 校验必须能从 http:// 直接取到 token 文件,任何 301 跳转 HTTPS、404 或宝塔伪静态拦截都会导致签发失败,进而表现为“证书无效”。验证方式:

# 期望返回 HTTP/1.1 200;返回 301/404 都说明校验路径被拦
curl -I http://example.com/.well-known/acme-challenge/test

OCSP stapling:开启后客户端握手即可拿到吊销状态,省一次外网请求。Nginx 中 ssl_stapling 默认为 off,需配合 chain.pem 与可达的 resolver:

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/chain.pem;  # 仅中间证书
resolver 223.5.5.5 1.1.1.1 valid=300s;   # valid 默认 300s
resolver_timeout 5s;

# 验证:期望看到 OCSP Response Status: successful (0x0)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 
  | grep -A2 'OCSP Response Status'

续期与计划任务:Let’s Encrypt 官方建议在证书有效期剩余 30 天左右(即签发后约 60 天)完成续期;acme.sh 3.0.x 可手动强制续:

acme.sh --renew -d example.com --force   # --force 忽略 30 天阈值立即重签
crontab -l | grep acme                   # 确认自动续期任务存在
nginx -t && nginx -s reload              # 续期后重载,否则旧证书仍在内存中

宝塔的计划任务默认每天检查一次证书到期情况;若曾手动改过 crontab,务必确认 acme.sh --cron 那一行还在,否则证书静默过期正是“宝塔 SSL 证书无效”最隐蔽的来源之一。

免费 DV、商业 DV/OV 与自签名证书怎么选?参数对比表

问:宝塔里点一下申请的免费 Let’s Encrypt 证书,和花钱买的 DV/OV,浏览器表现有区别吗?没有区别——只要证书链完整、域名匹配、未过期,三者都会让地址栏显示正常的锁标识。现代 Chrome/Edge/Firefox 早已不再用绿色地址栏区分 OV/EV,差别只体现在保障赔付额度、身份审核深度、有效期长度和续期方式上。这也意味着:绝大多数「宝塔ssl证书无效」的报障,根因是过期或中间证书链缺失,而不是证书类型选错了。

方案 价格区间 有效期 浏览器信任 适用场景 续期方式
Let’s Encrypt DV 0 元 90 天 是 个人站、测试、预算敏感 acme.sh/宝塔自动,约 60 天续
商业 DV 单域 约 10–100 元/年 通常 1 年 是 企业官网、API 控制台手动或 API
商业 OV 约 300–1500 元/年 1–2 年 是 政企、金融展示 人工审核后签发
通配符 DV 约 300–2000 元/年 1 年 是 多子域 DNS-01 自动
自签名 0 元 自定义 否 内网、开发测试 内部 CA 脚本

怎么选?公网面向真实用户,优先 DV;政企或金融展示页需要 OV 的身份信息写入证书主题字段(O/OU),价格约 300–1500 元/年,签发需 1–3 个工作日。Let’s Encrypt 适合预算低且能保证自动续期的站点——它的 90 天有效期不是缺点而是强制自动化,据 Let’s Encrypt 官方文档,官方建议在剩余 30 天时续期,宝塔的定时任务默认就是这个窗口。

签发时间成本对比:Let’s Encrypt 文件验证(HTTP-01)通常 1–3 分钟出证;商业 DV 约 10–30 分钟;OV 需人工核验企业工商信息,1–3 个工作日;EV 约 3–7 个工作日,但浏览器已不显示绿色地址栏,性价比下降。注意 CA/Browser Forum 的 SC-081 表决已确定公开证书最长有效期将逐步缩短(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天),这意味着无论免费还是付费,自动化续期都是唯一可持续方案。

泛域名与兼容性限制:*.example.com 覆盖 www.example.com 和 a.example.com,但不覆盖 a.b.example.com;Let’s Encrypt 的通配符证书必须走 DNS-01 验证,且单张证书最多包含 100 个域名。算法上 RSA 2048/4096 与 ECDSA P-256 均可被主流客户端接受,但 Android 7 以下的老设备可能缺少 ISRG Root X1 根证书,出现「证书无效」提示。据 Mozilla SSL Configuration Generator,生产站至少应启用 TLSv1.2 与 TLSv1.3,并禁用 TLSv1.0/1.1。

# 查看宝塔站点证书的实际到期时间与签发者,用于判断"宝塔ssl证书无效"是否由过期引起
# 证书路径:Let's Encrypt 申请的在 /www/server/panel/vhost/cert/<域名>/ 下
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem 
  -noout -subject -issuer -dates
# 输出示例:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Jan 10 00:00:00 2025 GMT
# notAfter=Apr 10 00:00:00 2025 GMT   <-- 早于当前时间即已过期
# 手动触发 acme.sh 续期检查(宝塔内置的 Let's Encrypt 亦可用面板计划任务)
# 适用 acme.sh 3.x,默认安装于 ~/.acme.sh
~/.acme.sh/acme.sh --cron --home ~/.acme.sh
# 内网/测试环境生成自签名证书(OpenSSL 1.1.1+ 才支持 -addext 与 SAN)
# 自签名证书不会被浏览器信任,客户端需手动导入 self.crt 到受信任根存储
openssl req -x509 -newkey rsa:2048 -sha256 -days 365 -nodes 
  -keyout self.key -out self.crt 
  -subj "/CN=internal.lan" 
  -addext "subjectAltName=DNS:internal.lan,DNS:*.internal.lan"

风险控制:免费证书 90 天,忘记续期是「证书无效」的第一大原因;商业证书同样要设 30/7/1 天到期提醒。把 notAfter 写进监控是最省事的做法,例如 Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,或 Zabbix 的 web.certificate.get 监控项,阈值设为剩余 21 天告警。自签名证书则要区分场景:仅限内网,一旦被误部署到公网,访客看到的是 NET::ERR_CERT_AUTHORITY_INVALID,与配置错误的表现几乎一样,排查时先看 issuer 就能快速定位。

常见报错与排查:浏览器和 Nginx 分别提示什么?

宝塔ssl证书无效时,浏览器和 Nginx 给出的报错其实指向不同层次的问题:浏览器报错看的是证书内容(有效期、域名、签发链),Nginx 的 [emerg] 报错看的是文件本身(是否存在、可读、与私钥匹配)。先认清报错属于哪一层,再执行对应命令,比盲目重签快得多。

报错原文 出错层 根因 一条验证命令
NET::ERR_CERT_DATE_INVALID 有效期 证书过期,或服务器时钟漂移 openssl x509 -noout -dates -in fullchain.pem
ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN 域名覆盖 SAN 不含当前访问域名 openssl x509 -noout -ext subjectAltName -in fullchain.pem
NET::ERR_CERT_AUTHORITY_INVALID 信任链 缺中间证书或自签名 openssl s_client -connect ... -showcerts
nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed 文件读取 空文件、权限不足、上传成 .txt ls -l + head -1
SSL_CTX_use_certificate_chain_file() failed (…key values mismatch) 密钥配对 fullchain 与 privkey 来自不同订单 modulus / pubkey 对比
404 /.well-known/acme-challenge/xxx 签发通道 伪静态、301、CDN 不回源 curl -I

问:浏览器说证书过期,但面板显示还在有效期内?先排除时钟问题——据 RFC 5280,有效期校验基于本地时间,容器或 VPS 时间漂移会让未过期证书被判过期。同时确认续期后是否 reload:Nginx 只在 reload 时重新读取证书文件,仅续期不重载是最常见的宝塔ssl证书无效原因。

# 证书实际有效期(notBefore / notAfter)
openssl x509 -noout -dates -in /www/server/panel/vhost/cert/example.com/fullchain.pem
# 与服务器 UTC 时间对比,偏差超过几分钟就要校准(chronyd / ntpdate)
date -u
# 续期成功后必须重载,否则进程仍持有旧证书
nginx -t && nginx -s reload

问:报 SSL_ERROR_BAD_CERT_DOMAIN,是不是证书签错了?通常不是签错,而是只签了 example.com 没签 www.example.com。Let’s Encrypt 文档明确:域名匹配依据 SAN 扩展而非 CN,所以必须检查 SAN。注意 openssl x509 -ext 需 OpenSSL 1.1.1+,CentOS 7 自带 1.0.2k 不支持,改用 -text 过滤。

# OpenSSL 1.1.1+
openssl x509 -noout -ext subjectAltName -in fullchain.pem
#   X509v3 Subject Alternative Name:
#       DNS:example.com, DNS:www.example.com
# 老版本(CentOS 7 默认 1.0.2k)
openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name"

缺哪个域名就补签哪个;若站点有大量子域,直接改用通配符 *.example.com(注意通配符不覆盖多级子域,也不覆盖裸域)。

问:ERR_CERT_AUTHORITY_INVALID 怎么确认是链不完整?看 s_client 的 Verify return code:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -E 'Verify return code|^ *[is]:'
# Verify return code: 20 (unable to get local issuer certificate)  <- 缺中间证书
# Verify return code: 21 (unable to verify the first certificate) <- 只有叶子证书

修复是把中间证书按“叶子在前、中间在后”拼进 fullchain.pem——顺序反了同样报错 20,这是手工拼接最常踩的坑:

# 顺序不可颠倒,否则 Nginx 加载后握手仍失败
cat leaf.crt intermediate.crt > fullchain.pem
# 链中证书数量,正常应为 2(叶子 + 中间)
grep -c "BEGIN CERTIFICATE" fullchain.pem

问:Nginx 直接起不来,PEM_read_bio_X509_AUX() failed 怎么办?这个错 90% 是文件问题,按三步查:

ls -l /www/server/panel/vhost/cert/example.com/
# 期望 -rw-r--r-- 1 root root ...;属主非 root 或权限 600 时 Nginx worker 读不到
head -1 /www/server/panel/vhost/cert/example.com/fullchain.pem
# 期望 -----BEGIN CERTIFICATE-----;若显示 HTML 或空行,说明上传成了 .txt 或文件为空
file /www/server/panel/vhost/cert/example.com/fullchain.pem

问:key values mismatch 是证书坏了?不是,是证书与私钥不配对。用模数(RSA)或公钥指纹(ECC)比对,两者 MD5 必须完全一致:

# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5
# ECDSA 证书(Let's Encrypt 默认仍为 RSA,但商业证书常见 ECC)
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout        -in privkey.pem   | openssl md5

不一致就回面板重新下载同一订单的 fullchain.pem 与 privkey.pem,切勿混用旧备份。

问:申请时报 404 /.well-known/acme-challenge/xxx?说明 HTTP-01 校验请求被拦在到达验证文件之前。常见于宝塔伪静态规则、强制 HTTPS 的 301、或 CDN 未回源。临时在该站点的 80 端口 server 块顶部插入放行规则,并确认返回 200 再重签:

server {
    listen 80;
    server_name example.com;
    # 必须放在所有 rewrite / return 301 之前,^~ 优先级高于正则伪静态
    location ^~ /.well-known/acme-challenge/ {
        root /www/wwwroot/example.com;
        default_type text/plain;
        try_files $uri =404;
    }
    # 其余请求再跳转 HTTPS
    location / { return 301 https://$host$request_uri; }
}
nginx -t && nginx -s reload
curl -I http://example.com/.well-known/acme-challenge/test.txt
# 期望 HTTP/1.1 200 OK;返回 301/404 说明规则仍被覆盖或 CDN 未回源

排查顺序建议固定为:文件层(存在、权限、首行)→ 密钥层(modulus 比对)→ 内容层(有效期、SAN、链)→ 通道层(ACME 404)。据 Mozilla Server Side TLS 建议,服务端应始终下发完整链,这也正是 ssl_certificate 指向 fullchain.pem 而非 cert.pem 的原因。

如何验证宝塔 SSL 配置已经生效?

证书换了、宝塔面板里也点了保存、Nginx 也 reload 过了,怎么确认配置真的生效?关键点在于:必须绕开 DNS 和 CDN 去验证。浏览器缓存、运营商 DNS 缓存、CDN 边缘节点都可能还挂着旧证书,这也是很多人误判”宝塔ssl证书无效”的直接原因——其实源站早就换好了。

第一步,用 curl 的 --resolve 把域名强制指到源站 IP,跳过本地 DNS 解析。该参数自 curl 7.21.3 起可用,宝塔自带 curl 均满足:

# --resolve 强制将 example.com:443 解析到源站 IP,绕过 DNS/CDN
curl -Iv https://example.com --resolve example.com:443:1.2.3.4 2>&1 
  | grep -E 'subject:|issuer:|expire date:|SSL certificate verify'
# 期望输出(OpenSSL 1.1.1+ 格式)
# *  subject: CN = example.com
# *  issuer: C = US; O = Let's Encrypt; CN = R10
# *  start date: Jul 14 08:00:00 2025 GMT
# *  expire date: Oct 12 08:00:00 2025 GMT
# *  SSL certificate verify ok.

必须看到 SSL certificate verify ok,且 subject 的 CN/SAN 与访问域名一致。若出现 SSL certificate verify result: unable to get local issuer certificate (20),说明证书链不完整——宝塔只写入了站点证书、漏了中间证书,需在面板”证书”里粘贴 fullchain 内容(据 Let’s Encrypt 文档,fullchain.pem 必须包含 leaf + 中间 CA)。

第二步,比对源站与 CDN 返回的证书序列号,这是判断”CDN 仍缓存旧证书”最快的手段。-servername 不可省略,否则 SNI 缺失会拿到默认站点证书:

# 分别取源站与公网入口的证书序列号
openssl s_client -connect 1.2.3.4:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -serial
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -serial
验证维度 期望结果 不符合时的典型根因
curl --resolve 校验 SSL certificate verify ok 证书链缺中间 CA、域名不匹配
源站 vs CDN serial 两行 serial 完全一致 CDN 未刷新或仍缓存旧证书
SSL Labs 评级 A / A+,Chain issues: None 协议过旧、缺 HSTS、链不全
crt.sh CT 日志 出现新证书记录,时间与签发时间吻合 签发失败或未真正签发

浏览器侧交叉确认:Chrome 开发者工具 Security 面板应显示 Certificate - valid and trusted,Issuer 为 R3/R10/R11 等受信中间 CA;Firefox 页面信息中显示 Verified by。在线工具方面,SSL Labs 目标是 Chain issues: None 且评级 A/A+,https://crt.sh/?q=example.com 应能查到本次签发记录。

第三步,确认协议与套件收敛。宝塔 Nginx 站点配置在 /www/server/panel/vhost/nginx/example.com.conf,改完先 nginx -t && nginx -s reload 再验证:

nmap --script ssl-enum-ciphers -p 443 example.com   # 应只出现 TLSv1.2 / TLSv1.3
openssl s_client -tls1_2 -connect example.com:443 -servername example.com </dev/null 2>&1 | grep -E 'Protocol|Cipher'
openssl s_client -tls1_1 -connect example.com:443 -servername example.com </dev/null   # 期望 handshake failure

注意 OpenSSL 3.x 默认 SECLEVEL=2 已禁用 TLS 1.0/1.1,若需复现旧协议问题要加 -cipher 'DEFAULT@SECLEVEL=1'。最后挂上到期监控,-checkend 参数单位为秒,604800 即 7 天:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -checkend 604800 -noout; echo $?
# 返回 0:7 天内不过期;返回 1:即将过期,立即续期并 reload

把这条命令写进宝塔”计划任务 → Shell 脚本”每日跑一次,比事后发现”宝塔ssl证书无效”再救火成本低得多。

怎样避免宝塔 SSL 证书再次失效?续期、监控与回滚

问:宝塔 SSL 证书为什么会“再次”失效? 答:绝大多数不是签发失败,而是续期任务静默失败——Let’s Encrypt 证书只有 90 天,据 Let’s Encrypt 官方文档,建议在剩余 30 天(即第 60 天左右)续期,官方会在到期前 20 天、7 天、1 天发邮件提醒。真正可靠的做法是“提前续 + 独立监控 + 可回滚”,三者缺一不可。

问:自动续期任务怎么写才不会翻车? 宝塔面板“计划任务”里选“续签 Let’s Encrypt 证书”类型即可,但建议改用 acme.sh 的 cron 并落日志,便于事后追责:

# 每天 00:30 以 root 执行;acme.sh v3.x 默认安装目录 /root/.acme.sh
30 0 * * * /root/.acme.sh/acme.sh --cron --home /root/.acme.sh >> /www/wwwlogs/acme_cron.log 2>&1

# 续期前置条件自检:80 端口公网可达(HTTP-01 校验必需)
curl -sI http://example.com/.well-known/acme-challenge/probe | head -1
# 确认 DNS API token 未过期(以阿里云为例,凭据存在 account.conf)
grep -E '^Ali_Key|^Ali_Secret' /root/.acme.sh/account.conf
# 若站点挂在 CDN 后,需保证回源可达或改用 DNS-01,否则校验必失败

问:监控怎么配才能“提前 7 天报警”? Prometheus 的 blackbox_exporter 会输出 probe_ssl_earliest_cert_expiry(Unix 时间戳),告警规则写差值即可;Zabbix 则用 openssl x509 -checkend(参数单位秒,604800 = 7 天,返回码 1 表示将过期):

# prometheus 告警规则片段
- alert: SSLCertExpiringSoon
  expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 7
  for: 1h
  labels: { severity: critical }

# Zabbix 外部检查 / 触发器命令
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null 
  | openssl x509 -noout -checkend 604800 -enddate
续期/监控路径 触发方式 适用场景 失败可见性
HTTP-01(acme.sh webroot) 80 端口回源校验 单站点、无 CDN 中,需看日志
DNS-01 DNS API 写 TXT 泛域名、CDN 后站点 高,token 过期即报错
商业证书 人工续费+替换 OV/EV、合规场景 低,依赖日历提醒

问:续期把证书写坏了怎么快速回滚? 宝塔 7.x 起证书默认存放在 /www/server/panel/vhost/cert/<站点名>/(更早版本为 /www/server/panel/vhost/ssl/)。每次续期前打时间戳备份,失败时恢复两个文件并重载:

cp -a /www/server/panel/vhost/cert/example.com 
      /www/backup/cert/example.com.$(date +%Y%m%d%H%M)
# 回滚
cp -a /www/backup/cert/example.com.202406120030/fullchain.pem 
      /www/server/panel/vhost/cert/example.com/fullchain.pem
cp -a /www/backup/cert/example.com.202406120030/privkey.pem 
      /www/server/panel/vhost/cert/example.com/privkey.pem
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem && chown root:root $_
nginx -t && nginx -s reload   # -t 不通过就不要 reload

问:还有哪些“埋雷”细节? 私钥务必 600 root:root,且绝不能落在网站根目录;启用 HSTS 前先确认全站 301 到 HTTPS,add_header Strict-Transport-Security "max-age=300" always; 观察一周后再升到 86400、最终 31536000,preload 一旦提交极难撤销。泛域名只能走 DNS-01,API token 按最小权限授予单域名解析;据 Let’s Encrypt 速率限制文档,单张证书 SAN 上限为 100 个域名,子域较多时按业务拆成多张证书,把续期失败的影响面控制在单个站点内。

先区分是源站还是 CDN:用 openssl s_client 分别直连源站 IP 和 CDN 域名,对比 serial 与 issuer。手机缓存旧证书、链不完整、系统时间偏差、Android 7 以下根证书信任问题都会导致提示无效,逐项排除即可。

不完全是一回事。过期只对应 NET::ERR_CERT_DATE_INVALID;无效还包括域名不匹配、证书链不完整、证书被吊销、Nginx 未重载等。先看浏览器错误码,再用 openssl s_client 看实际下发证书的 SAN 与有效期。

个人站、测试站用 Let's Encrypt 即可,0 元、90 天、可自动续期;企业对外服务可选商业 DV,约 10–100 元/年,或 OV 约 300–1500 元/年,获得人工审核与更长有效期。关键不是价格,而是续期是否可靠。

先确认 80 端口可访问、CDN 回源正常、伪静态没有拦截该路径。临时在 80 server 块加 location ^~ /.well-known/acme-challenge/ { root /www/wwwroot/example.com; },用 curl -I 确认返回 200 后再重新申请。

这通常不是 Nginx 版本问题,而是证书文件为空、权限不可读或格式不对。用 ls -l 看权限、head -1 看是否以 —–BEGIN CERTIFICATE—– 开头,重新上传 fullchain.pem,再执行 nginx -t。

有用。Cloudflare 代理模式下边缘证书和源站证书是两层;建议 SSL/TLS 设为 Full (strict),源站安装有效证书,避免回源明文或忽略校验。换证后刷新边缘缓存并对比 serial。

*.example.com 覆盖 www.example.com 和 a.example.com,但不覆盖 a.b.example.com;后者需要 *.b.example.com 或把域名加入 SAN。Let's Encrypt 通配符必须用 DNS-01 验证。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。