SSL证书无效怎么解决?从根因到排查的运维实操指南
SSL证书无效通常不是单一原因,优先用 `openssl s_client -connect 域名:443 -servername 域名 -showcerts` 检查证书链,若出现 `Verify return code: 20` 或 `21`,多数是服务器未发送中间证书。 Nginx 1.24/1.26 应配置 `ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;`,只配 `cert.pem` 会缺中间证书,curl 常报 `(60) unable to get local issuer certificate`。 证书有效期检查用 `openssl x509 -in cert.pem -noout -dates -subject -ext subjectAltName`,当前公有 TLS 证书最长有效期受 CA/B Forum 基准要求约束为 398 天,Let's Encrypt 默认 90 天。 验证修复结果以 `Verify return code: 0 (ok)`、`curl -vI https://example.com` 返回 `SSL certificate verify ok` 和浏览器 Security 面板显示证书有效为准。 续期用 `certbot renew --dry-run` 验证,配合 `systemctl list-timers | grep certbot` 与到期前 30/14/7 天告警,避免再次出现 SSL证书无效。
为什么浏览器会提示“SSL证书无效”?常见根因有哪些?
浏览器提示“SSL证书无效”时,证书本身未必是假的,更常见的情况是链、域名、时间、信任库、SNI 这五个校验环节中某一个没通过。下面按实际运维中出现频率排序,给出可直接复现的命令。
1. 证书链不完整(最常见)
服务器只发送了叶子证书,没发中间证书,客户端无法把链搭到本地根库,OpenSSL 会报 error 20 unable to get local issuer certificate 或 error 21 unable to verify the first certificate。据 RFC 5280 第 3.2 节,服务端应发送除根证书外的完整链(叶子 + 全部中间证书),根证书由客户端本地信任库提供。Let’s Encrypt 文档明确要求 Nginx 使用 fullchain.pem(含中间证书)而非 cert.pem。
# 复现:不带 CA 包验证,模拟浏览器
openssl s_client -connect example.com:443 -servername example.com </dev/null
# 正常输出应包含:Verify return code: 0 (ok)
# 若链缺失会看到 verify error:num=21:unable to verify the first certificate
# 看服务器到底发了几张证书(-showcerts 列出全部)
openssl s_client -connect example.com:443 -showcerts </dev/null | grep -c "BEGIN CERTIFICATE"
# 公有 CA 正常应为 2 或 3;返回 1 基本可判定缺中间证书
# 用完整 CA 包验证,区分“链缺失”与“根不受信”
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
Nginx 正确写法(ssl_certificate 指向 fullchain):
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须是 fullchain
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
}
2. 域名不匹配
浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,curl 报 SSL: no alternative certificate subject name matches target host name。现代客户端只认 SAN 扩展(RFC 6125 第 6.4 节规定通配符只匹配最左一级标签),CN 字段已被忽略。通配符 *.example.com 覆盖 a.example.com,但不覆盖 a.b.example.com,也不覆盖裸域 example.com。
openssl x509 -in cert.pem -noout -ext subjectAltName
# 输出示例:X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
3. 过期或未生效
报 NET::ERR_CERT_DATE_INVALID。除查看证书有效期,必须核对服务器时钟——偏差超过 5 分钟即可导致 OCSP 响应被判为过期,进而整链校验失败。
openssl x509 -in cert.pem -noout -dates
# notBefore=Mar 1 00:00:00 2024 GMT
# notAfter=May 30 23:59:59 2024 GMT
date -u # 与 notBefore/notAfter 同为 UTC,直接对比
4. 根证书不受信任
自签名证书、私有 CA 未导入客户端、Java 8 早期版本 cacerts 不含 ISRG Root X1 均属此类。浏览器报 ERR_CERT_AUTHORITY_INVALID,Java 报 PKIX path building failed: unable to find valid certification path。注意 Let’s Encrypt 的 DST Root CA X3 已于 2021-09-30 到期,老 Android 与旧 JDK 会因此报错。
5. SNI 与多证书错配
同一 IP 承载多域名时,若 443 虚拟主机缺 server_name 或没有默认 server,不支持 SNI 的老客户端会拿到默认证书。用 -servername 可复现 SNI 生效后的结果:
openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -subject
# 与下面不带 SNI 的结果对比,可暴露默认证书错配
openssl s_client -connect example.com:443 </dev/null | openssl x509 -noout -subject
6. 吊销、OCSP 与 CT
openssl ocsp -issuer chain.pem -cert cert.pem
-url http://ocsp.example.com -resp_text
# 关注响应中的 Cert Status: good / revoked / unknown
Chrome 120+ 仍校验证书透明度(CT)日志,私有 CA 签发、未提交 SCT 的证书在 Chrome 中可能被标记为无效,而 Firefox 与 curl 不强制 CT。
| 根因 | 典型报错 | 一条命令定位 |
|---|---|---|
| 链不完整 | error 20 / error 21 | s_client -showcerts 计数 |
| 域名不匹配 | ERR_CERT_COMMON_NAME_INVALID | x509 -ext subjectAltName |
| 过期/时钟偏差 | ERR_CERT_DATE_INVALID | x509 -dates + date -u |
| 根不受信 | ERR_CERT_AUTHORITY_INVALID | openssl verify -CAfile |
| SNI 错配 | 证书主体与访问域名不符 | s_client -servername |
| 已吊销 | ERR_CERT_REVOKED | openssl ocsp |
排查顺序建议:先跑 openssl s_client 看 Verify return code,非 0 时按错误码直接对应上表;为 0 却仍报 ssl证书无效,则问题在客户端信任库(Java cacerts、系统 CA 包)或 CT 策略,而非服务端配置。
SSL证书无效的完整排查步骤:从 0 到恢复需要做哪几步?
证书无效报错先别急着重签。按下面 6 步走,多数现场能在 10 分钟内定位到根因——据 Let’s Encrypt 文档,最常见的失效原因是中间证书未下发和 SAN 缺域名,而不是证书文件本身损坏。
步骤 1:固定复现入口并记录报错。用 Chrome 120+ 打开开发者工具 → Security 面板,记下错误码(NET::ERR_CERT_AUTHORITY_INVALID、NET::ERR_CERT_COMMON_NAME_INVALID、NET::ERR_CERT_DATE_INVALID),再用命令行双通道取证:
# -vI:只取响应头 + 详细握手日志;tee 落盘,方便修复前后对比
curl -vI https://example.com 2>&1 | tee curl.log
# -servername 模拟 SNI(多域名/虚拟主机必须带),-showcerts 打印服务端下发的整条链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | tee sclient.log
# 关键行:Verify return code: 0 (ok);非 0 即证书无效
抄下三样东西:Verify return code、叶子证书 Subject/SAN、notAfter。后面每一步都靠它们交叉验证。
步骤 2:检查证书文件本身。在服务器上对证书文件直接验证,排除「装错文件」:
openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
# 要确认三点:
# 1) subjectAltName 同时含 example.com 与 www.example.com(Chrome 58 起只看 SAN,不看 CN)
# 2) notAfter 未过期
# 3) issuer 是预期 CA(如 Let's Encrypt R11、DigiCert),不是自签或测试 CA
步骤 3:检查证书链。浏览器和 curl 默认不信任「只发叶子证书」的服务器:
openssl verify -untrusted chain.pem cert.pem
# 返回 cert.pem: OK 说明叶子 + 中间证书能组链
# 返回 error 20 at 0 depth lookup: unable to get local issuer certificate
# → 服务端没发中间证书,或 Nginx 的 ssl_certificate 只配了 cert.pem 而非 fullchain.pem
典型报错与处理方式对照如下:
| Verify return code / 浏览器错误 | 根因 | 处理 |
| 20 / unable to get local issuer certificate | 中间证书缺失 | 改用 fullchain.pem,见步骤 4 |
| 62 / ERR_CERT_COMMON_NAME_INVALID | SAN 未覆盖当前域名 | 重签时补 -d www.example.com |
| 10 / ERR_CERT_DATE_INVALID | notAfter 已过期 | 续期并修复自动续期 |
| 18 / ERR_CERT_AUTHORITY_INVALID | 自签或测试 CA | 换正式 CA 证书 |
| 0 (ok) 但浏览器仍报错 | 客户端或 CDN 缓存旧证书 | 见步骤 5 |
步骤 4:修复服务端配置并重载。Nginx 1.24 与 Apache 2.4.58 的正确写法:
# Nginx 1.24(/etc/nginx/conf.d/site.conf)
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 必须 fullchain,不能 cert.pem
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 默认值随版本变化,1.24 建议显式声明
nginx -t && systemctl reload nginx
# Apache 2.4.58(/etc/apache2/sites-enabled/000-default.conf)
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
apachectl configtest && systemctl reload apache2
步骤 5:清理客户端与中间层缓存。证书换了但报错照旧,通常是缓存:Windows 执行 certutil -urlcache * delete;浏览器重启或清除 SSL 状态;Java 应用需重启 JVM 才让 truststore 生效;走 CDN 的场景必须在控制台重新上传证书,生效一般 5–30 分钟。
步骤 6:验证并建立续期监控。据 Let’s Encrypt 文档,续期失败是过期类无效的头号来源,所以修完要验证自动化链路:
certbot renew --dry-run # 演练续期,不真正签发,验证钩子与权限
# 检查剩余有效期是否不足 30 天(2592000 秒),退出码 0 表示仍有效
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -checkend 2592000 -noout
配合到期前 30/14/7 天三级告警,把「ssl证书无效」从被动救火变成可观测项。
配置与命令示例:Nginx、Apache、OpenSSL 应该怎么写?
Nginx 1.24 / 1.26 的 443 配置到底该怎么写?
关键点只有一个:ssl_certificate 指向 fullchain.pem(叶子证书 + 中间证书),而不是 cert.pem。只发叶子证书是”ssl证书无效”在浏览器里最常见的一种表现,桌面浏览器有时会靠 AIA 自动补链,手机 App、curl、Java 客户端则直接握手失败。
server {
listen 443 ssl;
http2 on; # 独立 http2 指令自 nginx 1.25.1 起提供;1.24 必须写成 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3; # 显式声明,别依赖旧版本默认值
ssl_session_cache shared:SSL:10m; # 10MB 约可缓存 40000 个会话
add_header Strict-Transport-Security 'max-age=31536000' always;
}
改完先验证再 reload,顺序错了会把线上打挂:
$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ sudo systemctl reload nginx # 用 reload 而非 restart,避免中断现有连接
Apache 2.4.58 又该怎么配?
据 Apache mod_ssl 官方文档,自 2.4.8 起 SSLCertificateFile 已可直接加载中间证书,SSLCertificateChainFile 被标记为过时,所以把中间证书拼进 fullchain.pem 就行,别再单独写一条链文件指令(写了容易和 SSLCertificateFile 的内容重复,产生重复链)。
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
Protocols h2 http/1.1 # 需要 mod_http2;不支持时降级为 http/1.1
SSLProtocol -all +TLSv1.2 +TLSv1.3
</VirtualHost>
# 校验:apachectl configtest 输出 "Syntax OK" 后再 systemctl reload apache2
怎么用 OpenSSL 判断到底是”缺中间证书”还是”证书过期”?
openssl s_client -connect example.com:443 -servername example.com
-showcerts -verify_hostname example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null | grep 'Verify return code'
正常输出为 Verify return code: 0 (ok)。返回码直接指向根因:
| 返回码 | 含义 | 优先动作 |
|---|---|---|
| 0 | ok | 链与主机名均正确 |
| 10 | certificate has expired | 检查续期任务是否静默失败 |
| 20 | unable to get local issuer certificate | 补中间证书到 fullchain.pem |
| 21 | unable to verify the first certificate | 服务器只发了叶子证书 |
| 62 | hostname mismatch | SAN 未覆盖当前域名 |
签发前的 CSR 和链文件怎么准备?
OpenSSL 1.1.1+ 与 3.x 都支持 -addext;注意现代 CA 已忽略 CN,域名必须写进 SAN,否则又是一次”ssl证书无效”。
openssl req -new -newkey rsa:2048 -nodes -keyout example.key -out example.csr
-subj '/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.csr -noout -text | grep -A2 'Subject Alternative Name' # 提交前核对
cat cert.pem chain.pem > fullchain.pem # 顺序不能反:先叶子后中间
openssl verify -untrusted chain.pem cert.pem # 期望输出:cert.pem: OK
不要把手上的根证书塞进服务器链文件——根证书应由客户端信任库提供,多发的根证书既增加握手体积,也可能造成重复链校验失败。
Let’s Encrypt 续期怎么配才不会再出问题?
据 Let’s Encrypt 文档,证书有效期默认 90 天,官方建议每天运行两次续期任务并在成功后重载服务,否则”到期未续”就是下一次故障。
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--deploy-hook 'systemctl reload nginx' # 仅在真正续期成功时触发
certbot renew --dry-run # 演练,不改动现有证书
证书类型与部署方案怎么选?DV、OV、通配符与私有 CA 对比
公网站点到底该买 DV 还是 OV?内网自签为什么浏览器照样报错?
先把结论说清楚:面向公众的站点,一律选公有 CA 签发的 DV 或 OV 证书,因为浏览器只信任预置在根证书库(Mozilla CCADB、Chrome Root Store、Windows Trusted Root)里的 CA;纯内网系统可以用私有 CA 或内部 ACME 服务,但根证书必须导入每一台客户端的信任库,否则客户端会判定证书链不可信,用户看到的依然是“SSL证书无效”或 ERR_CERT_AUTHORITY_INVALID。
| 方案 | 适用场景 | 验证方式 | 典型价格区间(人民币/年) | 有效期 | 注意点 |
|---|---|---|---|---|---|
| DV 单域名 | 个人站、测试环境 | 域名控制验证 | 0-300 元 | 90-398 天 | 自动化程度高,Let’s Encrypt 为 90 天 |
| DV 通配符 | 多子域统一入口 | DNS-01 | 300-1500 元 | 90 天或 1 年 | 只覆盖一级子域,不覆盖 a.b.example.com |
| OV 单域名 | 企业对外服务 | 组织验证 | 800-3000 元 | 1 年 | 需营业执照,审核约 1-3 个工作日 |
| EV 证书 | 高信任展示场景 | 扩展验证 | 1500-6000 元 | 1 年 | Chrome 77+ 已移除绿色地址栏,仍做组织校验 |
| 私有 CA/自签 | 内网、开发测试 | 自建根证书 | 0 元 | 自定义 | 必须导入客户端信任库,否则报 ERR_CERT_AUTHORITY_INVALID |
通配符证书能覆盖裸域和多级子域吗?不能。*.example.com 按 RFC 6125 只匹配 一级 标签,example.com 本身和 a.b.example.com 都不在覆盖范围内。上线前用 OpenSSL 核对实际 SAN 列表(Chrome 58 起已忽略 CN 字段,只看 SAN):
# 查看证书真正覆盖的域名列表;只信任 SAN 扩展,CN 已不再参与匹配
openssl x509 -in fullchain.pem -noout -text
| grep -A1 "Subject Alternative Name"
# 端到端验证:同时校验证书链、主机名与有效期
openssl s_client -connect example.com:443 -servername example.com
-verify_hostname example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
若裸域与多级子域都要覆盖,正确做法是签一张 SAN 多域名证书(如 example.com + *.example.com + *.api.example.com),而不是硬套通配符。
内网私有 CA 怎么部署才不触发证书告警?以 mkcert(v1.4.x 及以上)为例,关键是分发根证书,而不是只分发叶子证书:
mkcert -install # 生成根 CA 并写入本机信任库
mkcert "*.corp.example.com" # 签发内网通配符证书,输出 .pem + -key.pem
mkcert -CAROOT # 打印根证书所在目录,取 rootCA.pem 分发
# Linux 客户端(Debian/Ubuntu):文件名后缀必须为 .crt,否则不被扫描
sudo cp rootCA.pem /usr/local/share/ca-certificates/corp-root-ca.crt
sudo update-ca-certificates # RHEL 系改用 update-ca-trust
# Java 客户端不读系统信任库,必须单独导入(cacerts 默认口令 changeit)
keytool -importcert -alias corp-root -file rootCA.pem
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit -noprompt
Let’s Encrypt 免费证书和商业 DV 差在哪?差在运维成本。Let’s Encrypt 有效期 90 天,官方推荐用 systemd timer 而非 cron 续期;certbot 安装包自带的 certbot.timer 每天运行两次并带随机延迟,剩余有效期不足 30 天(--days 默认值 30)才真正续签:
systemctl list-timers | grep certbot # 确认 certbot.timer 处于 active 状态
sudo certbot renew --dry-run # 演练续期,不消耗速率限制配额
OV/EV 会让“证书无效”的提示消失吗?不会。据 CA/Browser Forum 基线要求,公有 TLS 证书最长有效期目前为 398 天(并计划在 2026-2029 年间逐步缩短至 200/100/47 天),而 OV/EV 增加的只是组织身份审核,浏览器判断证书是否可信仍取决于证书链完整性、域名匹配与时间有效性这三件事。所以买了 OV 却忘了部署中间证书,浏览器给出的仍是 SSL证书无效——排查顺序应当永远是“链 → 域名 → 时间 → 吊销状态”,而不是先怀疑证书等级不够。
常见错误与排查:看到这些报错应该查什么?
浏览器或命令行报错其实已经指明了根因方向。先按报错分诊,再逐条验证,比盲目重签证书快得多。
1. NET::ERR_CERT_AUTHORITY_INVALID / curl (60) unable to get local issuer certificate
九成是服务器没发中间证书。据 Let’s Encrypt 文档,证书链必须包含中间证书,否则部分客户端无法构建到根的路径。先确认 Nginx 用的是 fullchain.pem 而非 cert.pem:
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- Wildcard 通配符 SSL 证书安装部署续费申请
# nginx.conf(适用 nginx 1.x 全版本,默认 ssl_certificate 无默认值,必须显式指定)
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 含叶证书+中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# 验证服务器实际发送的链(应看到 2 段以上 BEGIN CERTIFICATE)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 客户端侧用系统信任库正常校验,不要用 -k 绕过
curl --cacert /etc/ssl/certs/ca-certificates.crt -I https://example.com
2. NET::ERR_CERT_COMMON_NAME_INVALID / Hostname mismatch
现代浏览器只认 SAN,CN 已不作为唯一依据(RFC 6125 起即如此)。核对:
openssl x509 -in cert.pem -noout -ext subjectAltName
# 期望输出含 DNS:example.com, DNS:*.example.com
访问 www.example.com 时证书必须含该名字或匹配 *.example.com(通配符只覆盖一级)。
3. NET::ERR_CERT_DATE_INVALID
证书过期或本机时间错。分别查两头:
openssl x509 -in cert.pem -noout -dates # notBefore / notAfter
timedatectl # 看 System clock synchronized: yes
chronyc tracking # Leap status / System time 偏移量
容器里常见宿主机时间漂移传染给容器;启用 systemd-timesyncd 或 chronyd,注意时区不影响 UTC 时间本身。
4. ERR_SSL_VERSION_OR_CIPHER_MISMATCH
协议或套件不匹配。Nginx 默认 ssl_protocols TLSv1 TLSv1.1 TLSv1.2(1.23.4 起默认改为 TLSv1.2 TLSv1.3)。若只开 1.2/1.3,仅支持 TLSv1.0 的老客户端必然握手失败。用 nmap --script ssl-enum-ciphers -p 443 example.com 或 testssl.sh --fast example.com 枚举实际协议与套件。
5. Java:PKIX path building failed ... SunCertPathBuilderException
keytool -list -cacerts | grep -i isrg # 查 JVM 信任库是否含根证书
keytool -importcert -alias isrgrootx1 -file isrgrootx1.pem -cacerts
java -Djavax.net.ssl.trustStore=/opt/truststore.jks -jar app.jar # 或指定独立 truststore
6. Node.js / 老 curl:unable to verify the first certificate
同样是服务端缺中间证书。修复 fullchain 后,客户端可 apt update && apt install --reinstall ca-certificates,私有根则用 NODE_EXTRA_CA_CERTS=/path/root.pem node app.js 追加。
7. 同 IP 多站点串证书
SNI 未命中时 Nginx 回落到 default_server,返回别的站点证书,这是”ssl证书无效”报错的典型来源。对比验证:
openssl s_client -connect 1.2.3.4:443 -servername example.com </dev/null | openssl x509 -noout -subject
openssl s_client -connect 1.2.3.4:443 </dev/null | openssl x509 -noout -subject # 不带 SNI
两者 subject 不同即说明默认 server 配错,应为 443 显式设置 listen 443 ssl default_server; 并避免空 server_name。
| 报错 | 首要排查点 | 验证命令 |
|---|---|---|
| AUTHORITY_INVALID | 中间证书缺失 | openssl s_client -showcerts |
| COMMON_NAME_INVALID | SAN 不含该域名 | openssl x509 -ext subjectAltName |
| DATE_INVALID | 证书过期/系统时间 | -dates + timedatectl |
| VERSION_OR_CIPHER_MISMATCH | 协议套件不兼容 | testssl.sh --fast |
| PKIX path building failed | JVM truststore 缺根 | keytool -list -cacerts |
如何验证SSL证书无效问题已修复?
改完配置别急着收工——“看起来有效”和”验证通过”是两件不同的事。浏览器地址栏出现小锁,只能说明当前这台机器、这个浏览器信任它;运维要的是”链完整、域名匹配、信任库覆盖”三件事同时成立。下面这套验证序列按”从服务端到客户端、从手动到自动”的顺序排列,每一步都有明确的通过标准。
第一步:服务端链验证。这是最权威的判定,因为它直接复现客户端握手时的证书链构建过程。据 OpenSSL 官方文档,-verify_hostname 需 OpenSSL 1.1.0+ 才支持,而 Verify return code 的取值来自 X509_V_ERR_* 错误码表:
openssl s_client -connect example.com:443 -servername example.com
-showcerts -verify_hostname example.com </dev/null
# 通过标准:Verify return code: 0 (ok) ← 链完整且 SAN 匹配
# 常见失败:20 (unable to get local issuer certificate) ← 缺中间证书
# 62 (hostname mismatch) ← SAN 不含该域名
# 脚本化时务必加 -verify_return_error,否则验证失败 s_client 仍返回退出码 0
openssl s_client -connect example.com:443 -servername example.com
-verify_hostname example.com -verify_return_error </dev/null >/dev/null
&& echo "链与域名均通过" || echo "仍无效,继续排查"
若仍是 20,说明中间证书没下发全——按 Mozilla SSL Configuration Generator 的推荐,用 SSLCertificateChainFile(Apache 2.4.8 起也可直接拼接到 SSLCertificateFile)或 nginx 的 ssl_certificate 按”服务器证书 → 中间证书”顺序拼接补齐。
第二步:HTTP 客户端验证。换一个客户端复验,能排除”OpenSSL 命令行信任库和服务端链恰好匹配”的假阳性:
curl -vI https://example.com 2>&1 | grep -E "SSL certificate verify|HTTP/"
# 期望两行:SSL certificate verify ok. + HTTP/2 200
# 私有 CA / 自签场景不要用 -k 关校验,而是显式信任根证书:
curl -vI --cacert /etc/ssl/certs/internal-root.crt https://internal.example.com
第三步:浏览器与在线扫描。Chrome 120+ 打开开发者工具 → Security 面板,展开证书详情核对 SAN、notAfter、签发者与链层级;Firefox 若使用私有 CA,需在 about:config 确认 security.enterprise_roots.enabled 是否启用(Windows 域环境下它会自动导入企业根,是”命令行 OK 但浏览器报错”的典型原因)。命令行侧用 testssl.sh 3.2:
./testssl.sh --fast example.com
# 重点看 Chain of Trust 段与 "certificate expires" 行
# SSL Labs 评分仅作参考:A+ 也可能因客户端信任库过旧而失败
第四步:多客户端矩阵。同一张证书在不同信任库里的结果可能完全不同,据 Let’s Encrypt 文档,Android 7.1.1 起系统信任库内置 ISRG Root X1,而 7.0 及更早依赖已停用的 DST Root CA X3 交叉签名,所以”安卓用户报证书无效”往往不是服务端配置问题:
| 客户端 | 验证命令 / 方式 | 失败时的典型报错 |
|---|---|---|
| curl 8.x + OpenSSL 3.x | curl -vI https://example.com |
SSL certificate problem: unable to get local issuer certificate |
| Java 17 | keytool -printcert -sslserver example.com:443 |
PKIX path building failed |
| Android 7.1.1+ | 系统浏览器访问 | 7.0 及以下:证书不受信任(缺 ISRG Root X1) |
| Windows 10 | certutil -verify -urlfetch cert.cer |
0x800B0109 CERT_E_UNTRUSTEDROOT |
第五步:把验证自动化。手动过一遍只解决”这一次”,到期静默失效才是运维事故的主因:
# 30 天到期检查(2592000 秒),返回非零即告警
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -checkend 2592000 -noout || echo "证书将在 30 天内过期"
# blackbox_exporter 0.24+ 采集 probe_ssl_earliest_cert_expiry(Unix 时间戳)
modules:
https_2xx:
prober: http
http:
tls_config:
ca_file: /etc/ssl/certs/internal-root.crt # 私有 CA 场景必填
# 告警规则:30/14/7 天三档
- alert: SSLCertExpiring30d
expr: probe_ssl_earliest_cert_expiry - time() < 30*86400
把这五步当成一次”回归测试”:Verify return code: 0 (ok) + SSL certificate verify ok + 多客户端矩阵全绿 + 巡检告警已接入,才能判定 ssl证书无效 的问题真正闭环。
如何预防再次出现SSL证书无效?续期与监控清单
问:已经配了自动续期,为什么还会出现 ssl 证书无效?
最常见的原因不是“没续”,而是“续了没生效”。certbot 或 acme.sh 只负责把新证书写到磁盘,Nginx/Apache 的 worker 进程仍持有启动时加载的旧 SSL_CTX,握手继续下发旧证书,客户端就报 certificate has expired。所以第一步是确认定时任务真的在跑,第二步是确认 reload 钩子存在。
# certbot 2.x(apt/dnf 安装):确认 timer 处于 ACTIVE 且 NEXT 在未来
systemctl list-timers | grep certbot
# 输出示例:certbot.timer Wed 2025-06-11 03:14:00 CST 8h left ...
# 若为 snap 安装,timer 名字是 snap.certbot.renew.timer
# 查看下一次续期是否会真的执行(不写盘)
certbot renew --dry-run
# 关键:部署钩子,续期成功后 reload,否则新证书不加载
cat >/etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh <<'EOF'
#!/bin/sh
systemctl reload nginx # reload 而非 restart,避免连接中断
EOF
chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
# acme.sh 3.x:确认 cron 条目存在并手动跑一次续期流程
crontab -l | grep acme.sh
acme.sh --cron --home ~/.acme.sh
# 签发时就要带上 reload 命令,否则同样只落盘不生效
acme.sh --issue -d example.com -w /var/www/html
--reloadcmd "systemctl reload nginx"
两种工具的差异如下,选型时按运维习惯决定,但 reload 机制必须二选一落实:
| 维度 | certbot 2.x | acme.sh 3.x |
|---|---|---|
| 调度方式 | systemd timer(默认随机延迟,含 RandomizedDelaySec) |
crontab 条目,默认每天 00:00 检查 |
| 续期阈值 | 剩余 30 天(--days 可调) |
剩余 60 天(--days 30 可调) |
| reload 配置 | renewal-hooks/deploy/ 目录脚本 |
--reloadcmd 写入 conf |
| 依赖 | 较重,官方推荐 snap 安装 | 纯 shell,无 Python 依赖 |
问:告警只盯到期时间够吗?
不够。据 Let’s Encrypt 文档,证书有效期已缩短至 90 天并计划进一步缩短,单纯看天数会掩盖链不完整、SAN 漏域名、OCSP 响应失败等问题——这些都会让浏览器直接判定 ssl 证书无效,而到期时间还显示“正常”。建议按 30/14/7 天三级升级通知,并同时采集下列指标:
| 监控项 | 采集方式 | 告警阈值 |
|---|---|---|
| 剩余有效期 | openssl x509 -enddate -noout -in cert.pem |
30 天提醒 / 14 天升级 / 7 天强提醒 |
| 链完整性 | openssl verify -CAfile chain.pem cert.pem |
非 OK 立即告警 |
| 域名 SAN | openssl x509 -text | grep DNS: |
缺少预期域名即告警 |
| OCSP 状态 | openssl ocsp -issuer chain.pem -cert cert.pem -url <OCSP地址> |
revoked / unknown |
| 握手协议版本 | openssl s_client -connect host:443 -tls1_1 |
能协商成功即告警 |
问:变更记录和权限要怎么管?
每次签发记录五项:签发时间、CA 名称、SAN 列表、部署节点、reload 时间与验证结果。私钥权限固定为 600 且属主为 root:chmod 600 /etc/letsencrypt/live/example.com/privkey.pem;确认 git check-ignore privkey.pem 有输出,避免误提交。更新后旧证书文件保留 7 天用于回滚,过期再清理。
问:配置基线怎么定?
按 Mozilla SSL Configuration Generator(Intermediate 档)生成,服务端启用 ssl_protocols TLSv1.2 TLSv1.3;,禁用 TLSv1.0/1.1。HSTS 先用小 max-age 试点:add_header Strict-Transport-Security "max-age=300" always;,确认全站(含子域)HTTPS 可用后再逐步提高到 31536000,否则子域不可用会被浏览器硬编码锁死。
问:如何验证整套机制没退化?
每季度演练一次:执行 certbot renew --dry-run、跑一遍上面的链验证命令、用多客户端矩阵(Chrome、Safari、curl、Java 8)测试握手。同时用 crt.sh 查询证书透明度日志:curl -s "https://crt.sh/?q=example.com&output=json" | jq '.[].issuer_name',确认没有未知 CA 为该域名签发过证书,发现异常立即吊销并排查 DNS/ACME 挑战配置。
不是。过期只是 SSL证书无效 的原因之一,其他常见原因还包括证书链缺失、域名不匹配、根证书不受信任、系统时间偏差、SNI 错配与证书被吊销。先用 `openssl s_client -connect 域名:443 -servername 域名 -showcerts` 看 `Verify return code`,再分别检查有效期与 SAN。
不同客户端的信任库、SNI 支持和缓存状态不同。旧 Android 可能不信任 ISRG Root X1,桌面浏览器可能缓存了旧链,CDN 节点也可能尚未同步新证书。用 `openssl s_client -servername 域名` 对比不同网络下的证书链,并检查中间证书是否完整。
信任链机制相同,浏览器判断标准也相同:链完整、域名匹配、时间有效、根受信任。Let's Encrypt 默认 90 天,更依赖自动化续期;商业 DV 常见 1 年,但同样需要到期续期。OV/EV 增加组织审核,不会绕过链或域名校验。
多数是服务器未发送中间证书。Nginx 改用 `fullchain.pem`,Apache 使用包含中间证书的 `SSLCertificateFile`,再用 `openssl verify -untrusted chain.pem cert.pem` 验证。客户端侧可更新 `ca-certificates` 或用 `–cacert` 指定 CA 包,不建议长期用 `-k` 跳过校验。
建立私有 CA,把根证书导入客户端信任库:Windows 用 `certlm.msc` 导入“受信任的根证书颁发机构”,macOS 用钥匙串,Linux 放到 `/usr/local/share/ca-certificates/` 后执行 `update-ca-certificates`。也可以部署内部 ACME 服务,让内网证书自动签发和续期。
通常不要。服务器应发送叶子证书和中间证书,根证书由客户端信任库提供;把根证书放进链文件会增加握手体积,并可能造成重复链或验证歧义。据 RFC 5280 与 CA/B Forum 实践,`fullchain.pem` 一般只包含叶子证书与中间证书。
SSL Labs 评分侧重协议版本、套件、密钥交换与部分链信息,浏览器还会检查域名 SAN、系统时间、证书吊销、CT 日志与混合内容。评分 A 不代表域名一定匹配,执行 `openssl x509 -noout -ext subjectAltName` 和 `timedatectl` 仍应作为必查项。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。