OCSP 是什么?证书吊销查询原理、openssl 手工验证与 Nginx OCSP Stapling 配置实战
OCSP(Online Certificate Status Protocol,在线证书状态协议)是 RFC 6960 定义的证书吊销状态查询协议:验证方向 CA 的 OCSP Responder 提交单张证书的序列号,返回 good、revoked、unknown 三种状态,典型响应体只有 1-2 KB。 手工验证一条命令即可:openssl ocsp -issuer issuer.pem -cert cert.pem -url http://ocsp.digicert.com -CAfile root.pem -resp_text,正常输出末尾是 Response verify OK 与 cert.pem: good。 Nginx 1.3.7 起支持 ssl_stapling,必须同时配置 ssl_stapling_verify on、ssl_trusted_certificate(含中间 CA 与根)和 resolver,缺 resolver 会在 error.log 报 no resolver defined to resolve ocsp.xxx.com。 据 Let's Encrypt 官方公告,其 OCSP 服务已于 2025 年 5 月 7 日停止,最后一张带 OCSP URL 的证书在 2025 年 5 月 6 日签发,给 LE 证书配 stapling 已不会产生响应。 方案选择上,公网 HTTPS 优先用 OCSP Stapling(握手零额外 RTT),内网自建 PKI 可用 OpenSSL 自建 Responder,对吊销时效敏感的业务可叠加 Must-Staple 或改用短期证书 + ARI。
OCSP 是什么?为什么有了 CRL 还要单独做吊销查询
ocsp 是什么?先给一句话定义
OCSP 全称 Online Certificate Status Protocol(在线证书状态协议),当前有效版本是 RFC 6960(2013 年 6 月发布,取代 1999 年的 RFC 2560)。它只干一件事:让验证方拿某张证书的序列号去问 CA 的 Responder——“这张证书现在还有效吗?”应答只有三种状态:good、revoked、unknown,典型响应体 1–2 KB。据 RFC 6960 第 2.2 节,good 仅表示“该序列号未被吊销”,并不等于证书一定在有效期内或链一定可信——那属于 RFC 5280 证书链验证的职责,两者是吊销检查与路径验证两个独立环节。
既然有 CRL,为什么还要单独做 OCSP?
因为 CRL 是“全量下载”,代价随 CA 规模线性膨胀。CA 定期签发一份包含全部已吊销序列号的签名列表,客户端要判断一张证书就得先拉整份文件。实测一个中型公共 CA 的 CRL 常见 5–20 MB,nextUpdate 周期多为 7 天——移动端每次拉全量既费流量,又天然拿不到分钟级吊销信息。OCSP 把“拉全量”换成“点查一条”,数据量从 MB 级压到 KB 级。
| 维度 | CRL(RFC 5280 §5) | OCSP(RFC 6960) |
|---|---|---|
| 数据形态 | CA 定期发布的全量签名列表 | 按序列号点查的单条状态 |
| 典型体积 | 5–20 MB | 1–2 KB |
| 时效 | 受 nextUpdate 约束,常见 7 天 |
Responder 实时/准实时,可分钟级 |
| 传输方式 | HTTP/FTP/LDAP 下载整份文件 | HTTP GET/POST 单次问答,默认端口 80,不强制 TLS |
| 隐私暴露 | 只暴露“我下载了列表” | 暴露“某 IP 正在查某张证书”,等价于泄露访问了哪些站点 |
协议栈本身很朴素:请求与响应都是 DER 编码的 ASN.1 结构,走明文 HTTP;POST 时请求 Content-Type: application/ocsp-request,响应 application/ocsp-response。下面用 OpenSSL 1.1.1 / 3.x 手工验证一次(-issuer 必须是签发该叶证书的中间 CA,不是根):
# 适用:OpenSSL 1.1.1、3.0–3.3;ocsp 子命令参数一致
# -issuer 指定签发者证书,-cert 为待查叶证书,-url 取自证书 AIA 扩展
openssl ocsp -issuer chain.pem -cert leaf.pem
-url http://ocsp.example-ca.com
-CAfile chain.pem -resp_text -noverify
# 典型输出(关键行)
# leaf.pem: good
# This Update: Jun 1 00:00:00 2024 GMT
# Next Update: Jun 8 00:00:00 2024 GMT
# 想知道 CRL 侧的 nextUpdate 有多长,可对照:
openssl crl -in ca.crl -inform DER -noout -lastupdate -nextupdate -crlnumber
为什么浏览器其实早就不做在线 OCSP 了?
两点原因:隐私与可用性。在线查询让 CA 的 Responder 记录下“某 IP 查了哪张证书”,据 Chrome 安全团队 2012 年的公告(Revocation checking and Chrome’s CRL),Chrome 已放弃在线 OCSP,改用随浏览器更新的本地 CRLSet 推送;Firefox 仍保留 OCSP,但默认采用软失败(soft-fail)——请求超时或数秒无响应就直接放行连接,Safari 同样以软失败为主。CA/Browser Forum 基线要求(Baseline Requirements §4.9.10)允许软失败,所以“OCSP 挂了网站就打不开”在公网场景并不成立,真正会硬失败的是把 ssl_stapling_verify on 配错、又没配 ssl_trusted_certificate 的自建 Nginx。
记住定位:OCSP 属于 PKI 吊销检查环节,不提升任何加密强度,只回答“证书被吊销后多久能被发现”。也正因为它暴露客户端 IP,才有了后文要讲的 OCSP Stapling——由服务器代查、把带时间戳的响应“钉”在握手过程里,客户端既不联网也不再泄露行踪。
OCSP 请求和响应里到底装了什么?
抓包时看到的 OCSPRequest 是一段 DER 二进制,但它的语义结构很固定:外层 OCSPRequest ::= SEQUENCE { tbsRequest, optionalSignature [0] EXPLICIT OPTIONAL }。绝大多数查询请求不带签名(optionalSignature 省略),因为 OCSP 请求本身不含敏感信息,CA 也不校验客户端身份。真正决定”查哪张证书”的,是 tbsRequest 里的 Request ::= SEQUENCE { reqCert CertID, singleRequestExtensions [0] OPTIONAL }。
CertID 里到底有哪四个字段?为什么 -issuer 传错就查不到?
| 字段 | 含义 | 易错点 |
|---|---|---|
| hashAlgorithm | SHA-1(RFC 6960 第 4.1.1 节要求所有实现必须支持)或 SHA-256 | CA 端普遍只实现 SHA-1 兼容路径,OpenSSL 默认 -sha1 |
| issuerNameHash | 签发者 DN 的 DER 编码做哈希 | 必须传直接签发该证书的中间 CA |
| issuerKeyHash | 签发者 subjectPublicKey BIT STRING 内容的哈希 | 同一 CA 轮换密钥后旧响应失效 |
| serialNumber | 被查证书的序列号 | 序列号不唯一是 CA 侧 bug,非协议问题 |
因为 CertID 只由签发者哈希和序列号构成,传入根 CA 或错误的中间 CA 时,Responder 无法把你的请求匹配到任何已知证书,返回 unauthorized 而不是 unknown——这是排查时最有价值的信号。
# 只打印请求结构,不发送;确认 issuerNameHash 来自哪个 CA
openssl ocsp -issuer intermediate.pem -cert leaf.pem -req_text -no_nonce
# 完整查询:-CAfile 提供信任锚,-verify_other 提供响应者证书
# 缺任何一个都只会打印 Response Verify Failure(退出码非 0)
openssl ocsp -issuer intermediate.pem -cert leaf.pem
-url http://ocsp.int-x3.letsencrypt.org
-CAfile root.pem -verify_other intermediate.pem
-resp_text -no_nonce
OCSPResponseStatus 六个取值里,生产环境最常见的是哪两个?
| 值 | 名称 | 典型触发原因 |
|---|---|---|
| 0 | successful | 正常,仍需继续校验 certStatus |
| 1 | malformedRequest | DER 损坏、GET 路径 base64 未做 URL 编码 |
| 2 | internalError | CA 后端数据库不可用 |
| 3 | tryLater | CA 限流,Nginx 日志表现为 ocsp response error: 3 |
| 5 | sigRequired | 极罕见,Responder 强制要求签名请求 |
| 6 | unauthorized | issuer 不匹配、请求者未被 CA 授权 |
状态码为 0 时,响应体是 BasicOCSPResponse,其中每个 SingleResponse 带 certStatus(good [0] / revoked [1] / unknown [2])以及 thisUpdate、nextUpdate。注意 good 不等于”未吊销”,只代表”截至 thisUpdate 时刻没有吊销记录”;客户端必须结合 nextUpdate 判断新鲜度。据 Let’s Encrypt 文档,其 OCSP 响应的 nextUpdate 曾设置为 7 天,DigiCert 常见 3–4 天。自建 Responder 时可用 OpenSSL 1.1.1 起支持的 -nmin 控制(单位为分钟,默认 5):
# 自建 Responder:nextUpdate = thisUpdate + 300 分钟
# -rsigner/-rkey 为带 id-kp-OCSPSigning 扩展的委派响应者证书
openssl ocsp -index ./index.txt -port 8888 -CA ca.pem
-rsigner responder.pem -rkey responder.key -nmin 300 -text
为什么 openssl 总报 Response Verify Failure?因为签名验证是最容易被跳过的一步:响应必须由签发该证书的 CA 本身,或带 id-kp-OCSPSigning(OID 1.3.6.1.5.5.7.48.1.5)扩展的 Delegated Responder 签名。省略 -CAfile 或 -verify_other 时,OpenSSL 仍会打印 leaf.pem: good,但在 stderr 输出 Response Verify Failure,退出码非 0——脚本里若只看 stdout 就会漏掉这个致命问题。
nonce 该不该带?nonce 扩展 OID 为 1.3.6.1.5.5.7.48.1.2(RFC 8954 将长度限制为 1–32 字节),用于防重放。但一旦请求带 nonce,响应就与单次请求绑定,无法被 CDN 或 Nginx 复用。OpenSSL 的 openssl ocsp 默认发送 nonce,需显式加 -no_nonce;OCSP Stapling 场景同样不带 nonce,这正是 Nginx 能把 stapled 响应缓存约 300 秒的前提。传输层面,GET 方式按 RFC 6960 附录 A.1 把 DER 请求 base64 后 URL 编码拼进路径,POST 直接发二进制;实际部署普遍遵循 RFC 5019 的 255 字节上限,超长时改用 POST,否则部分 CDN 会返回 414。
完整实操步骤:从证书里读出 OCSP 地址并手工验证
弄清楚 ocsp 是什么(RFC 6960 定义的在线证书状态协议)之后,最直接的验证方式就是拿真实证书跑一遍。下面 6 步在 OpenSSL 1.1.1 / 3.x 与 Nginx 1.3.7+ 上均可复现,命令可直接复制。
步骤 1:拆分证书链。Nginx 的 fullchain.pem 约定是「叶子证书在前、中间 CA 在后」,但 OpenSSL 的 OCSP 子命令要求两者分开传入,所以先拆:
# 1) 把 PEM 里所有证书块按顺序导出
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 输出里 subject/issuer 成对出现,第一段是 leaf,第二段是中间 CA
# 2) 拆成独立文件(OpenSSL 1.1.1 / 3.x 通用)
openssl crl2pkcs7 -nocrl -certfile fullchain.pem
| openssl pkcs7 -print_certs -out all.pem
awk 'BEGIN{n=0} /BEGIN CERTIFICATE/{n++} {print > ("part-" n ".pem")}' all.pem
mv part-1.pem cert.pem # 叶子证书
mv part-2.pem issuer.pem # 中间 CA(签发者)
# 根证书单独从 CA 官网下载,存为 root.pem
步骤 2:读取 OCSP URL。AIA 扩展里的 OCSP 地址决定后面查谁:
openssl x509 -in cert.pem -noout -ocsp_uri
# 例:http://ocsp.digicert.com
如果这条命令没有任何输出,说明证书的 AIA 扩展里根本没有 OCSP 地址。据 Let’s Encrypt 官方公告,自 2025 年 5 月 7 日起新签发的证书不再包含 OCSP URL,遇到这种情况不是命令用错了,而是该证书只能靠 CRL 或后续的短期证书机制吊销,直接跳到步骤 5 时 stapling 也不会生效。
步骤 3:先裸查一次看响应内容。
openssl ocsp -issuer issuer.pem -cert cert.pem
-url http://ocsp.digicert.com -resp_text -noverify
重点看两处:Cert Status: good(或 revoked / unknown)与 This Update / Next Update。响应有效期通常 1–7 天,超出 Next Update 即视为过期。-noverify 只跳过响应签名校验,不影响状态字段本身的读取,适合先确认「能不能查通」。
步骤 4:加上签名验证。裸查不能防伪造响应,必须验证签名:
openssl ocsp -issuer issuer.pem -cert cert.pem
-url http://ocsp.digicert.com -CAfile root.pem -resp_text
# 正常输出末尾:Response verify OK
# cert.pem: good
出现 Response Verify Failure 多半是 -CAfile 里只有根、缺中间 CA,导致链建不起来:cat issuer.pem root.pem > ca-bundle.pem 后改用 -CAfile ca-bundle.pem;也可追加 -verify_other issuer.pem 指定响应者证书。
步骤 5:在 Nginx 上打开 stapling。三个指令默认值均为 off,必须显式开启:
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # leaf + 中间 CA
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
ssl_stapling on; # 默认 off,Nginx 1.3.7+ 支持
ssl_stapling_verify on; # 默认 off,校验 OCSP 响应签名
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 中间 CA + 根,不能放 leaf
resolver 223.5.5.5 1.1.1.1 valid=300s; # 解析 OCSP 域名,默认无 resolver
resolver_timeout 5s;
}
ssl_trusted_certificate 放错成叶子证书是最常见的坑:Nginx 会拿它去验响应签名,缺签发者时直接静默失败,错误只写进 error.log。
步骤 6:验证 stapling 是否生效。
nginx -t && nginx -s reload
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -A2 "OCSP Response Status"
第一次握手常显示 OCSP response: no response sent,因为 Nginx 是异步向 CA 拉取并缓存的;间隔 10–30 秒重连,正常应看到 OCSP Response Status: successful (0x0) 与 Cert Status: good。把这条响应随握手下发(通常 1–2 KB),客户端就省掉了一次额外的 DNS + HTTP 往返——这正是 ocsp 是什么在性能语境下的关键答案。
| 现象 / 报错 | 原因 | 处理 |
|---|---|---|
Response Verify Failure |
-CAfile 缺中间 CA |
用 issuer.pem + root.pem 合成 ca-bundle.pem |
no response sent(重连多次仍无) |
证书无 OCSP URL(Let’s Encrypt 2025-05-07 后签发) | 换用仍支持 OCSP 的 CA,或接受无 stapling |
error.log: "ssl_stapling" ignored, issuer certificate not found |
ssl_trusted_certificate 缺失或不含签发者 |
放入中间 CA + 根,重载 Nginx |
Responder Error: unauthorized (6) |
证书与 -issuer 不匹配,或 URL 指向别的 CA |
核对 fullchain.pem 顺序与 AIA 地址 |
配置与命令示例:Nginx 1.24、Apache 2.4 与 OpenSSL 3.0 的具体参数
先给结论:OCSP(Online Certificate Status Protocol)是浏览器/客户端向 CA 的 OCSP Responder 查询“这张证书是否已吊销”的协议,取代了下载整份 CRL 的开销。要回答“ocsp是什么、怎么落地”,关键在服务端把 OCSP 响应缓存并随握手“钉”给客户端,也就是 OCSP Stapling。据 Nginx 官方 ngx_http_ssl_module 文档,ssl_stapling 与 ssl_stapling_verify 默认均为 off,必须显式开启。
Nginx 1.24 完整 server 段示例:注意 resolver 必须显式配置,Nginx 不会读 /etc/resolv.conf;未配置时 error.log 会出现 no resolver defined to resolve ocsp.xxx.com。国内机器建议同时放一个境内 DNS,避免单一境外 DNS 被劫持后拿到错误 IP。
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off,需配合可信链
# ssl_stapling_responder http://ocsp.digicert.com; # 可选:覆盖证书 AIA 里的 URL
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 含签发者中间证书
resolver 223.5.5.5 1.1.1.1 valid=300s ipv6=off; # valid 是 DNS 缓存时长,不是 OCSP 响应缓存时长
resolver_timeout 5s; # 默认 30s
}
Apache httpd 2.4:SSLStaplingCache 必须放在全局 server config,放进 <VirtualHost> 会启动失败,典型报错含 AH02217: ssl_stapling_init_cert。据 mod_ssl 2.4 文档,SSLUseStapling 默认 off,SSLStaplingResponderTimeout 默认 10 秒。
# 全局段(不能放 VirtualHost)
SSLStaplingCache shmcb:/var/run/ocsp(128000)
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
SSLUseStapling on # 默认 off
SSLStaplingResponderTimeout 5 # 默认 10 秒
SSLStaplingReturnResponderErrors off
</VirtualHost>
OpenSSL 3.0 自建测试 Responder:index.txt 必须是 CA 数据库格式(制表符分隔,含 V/R/E 状态);-nmin 5 表示响应最小有效 5 分钟,便于本地验证过期与吊销分支。据 OpenSSL ocsp 手册,1.1.1k 与 3.0.x 参数通用。
# 启动测试 Responder
openssl ocsp -index /etc/pki/CA/index.txt -port 8888
-rsigner ocsp.pem -rkey ocsp.key -CA ca.pem -text -nmin 5
# 另开终端查询
openssl ocsp -issuer ca.pem -cert server.pem
-url http://127.0.0.1:8888 -resp_text
申请 Must-Staple 证书:在 openssl.cnf 的 [req] 段加 tlsfeature = status_request(OpenSSL 1.1.1+ 支持),或签发时用 -addext。带该扩展的证书若服务端未 stapling,浏览器会直接握手失败,属于强约束,DV 场景慎用。
# 方式一:openssl.cnf
[req]
tlsfeature = status_request
# 方式二:签发时追加
openssl x509 -req -in server.csr -CA ca.pem -CAkey ca.key -CAcreateserial
-addext 'tlsfeature=status_request' -out server.pem
HAProxy 2.8+ 可一行启用自动刷新,要求 crt 文件已拼好 leaf+issuer:
frontend fe_https
bind :443 ssl crt /etc/haproxy/site.pem ocsp-update on
default_backend be_web
# 日志出现 OCSP update 相关记录即表示刷新成功;默认刷新间隔由 ocsp-update-minimal 控制
| 组件 | 关键指令 | 默认/取值 | 易错点 |
|---|---|---|---|
| Nginx 1.24 | ssl_stapling / resolver |
stapling 默认 off;resolver_timeout 默认 30s |
不读系统 resolv.conf;valid=300s 只缓存 DNS |
| Apache 2.4 | SSLStaplingCache / SSLUseStapling |
UseStapling 默认 off;ResponderTimeout 默认 10s | Cache 放 VirtualHost 报 AH02217 |
| HAProxy 2.8+ | ocsp-update on |
由 ocsp-update-minimal 控制刷新间隔 |
crt 必须含 issuer |
据 Let’s Encrypt 文档,Let’s Encrypt 已于 2025 年逐步缩减 OCSP 服务并转向 CRL,生产环境应同时保留 CRL 回退与监控;这也解释了为什么“ocsp是什么”不能只停留在协议层,还要看 CA 生命周期策略。
选型对比:CRL、在线 OCSP、OCSP Stapling、Must-Staple 该选哪个
搞清楚了 ocsp 是什么——CA 提供的一个实时接口,回答“这张证书现在还作不作废”——真正的工程问题就变成:这条查询链路放在哪一层?下表是四种主流方案加上“干脆不查”的横向对比,据 CA/Browser Forum Baseline Requirements 与 RFC 6960/5280 的语义整理:
| 方案 | 查询方式 | 隐私暴露 | 握手开销 | 时效 | 典型场景 |
|---|---|---|---|---|---|
| CRL | 客户端下载全量列表(5–20 MB) | 低,CA 只见下载 IP | 首次 +1 RTT,可本地缓存 | 约 7 天 | 内网 PKI、离线环境 |
| 在线 OCSP | 客户端直连 CA | 高,CA 知道你访问哪个站点 | 每次 +1 RTT(约 50–300 ms) | 1–7 天 | 老旧客户端兼容 |
| OCSP Stapling | 服务器代查、随握手下发 | 低 | 0,复用握手 | 受缓存影响,Nginx 约 300 s 刷新 | 公网 Web 服务首选 |
| Must-Staple | 同 Stapling 但强制 | 低 | 0 | 同上 | 高安全站点、防剥离攻击 |
| 短期证书 + ARI | 用短有效期替代吊销查询 | 低 | 0 | 6–90 天 | ACME 自动化站点 |
Stapling 的“零开销”是相对的。它不增加客户端 RTT,但服务端要多维护一份缓存:Nginx 在 resolver 的 valid 到期或响应过期后异步刷新,刷新失败会继续沿用旧响应,直到超过响应里的 nextUpdate 才丢弃。因此 resolver 必须配置,否则 stapling 会静默失效——不会报错,只是握手包里永远没有那张票据。
# /etc/nginx/conf.d/example.conf —— ssl_stapling 自 nginx 1.3.7 起可用
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# 必须含签发该证书的中间 CA,否则 stapling 校验失败、握手不带响应
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off,建议开启,校验响应签名与链
resolver 1.1.1.1 8.8.8.8 valid=300s; # 不配 resolver,stapling 静默不生效
resolver_timeout 5s; # 默认 30s
}
# 验证:-status 表示在握手中请求 OCSP Response
openssl s_client -connect example.com:443 -servername example.com -status /dev/null
| grep -E "OCSP Response Status|Cert Status"
# 期望输出:
# OCSP Response Status: successful (0x0)
# Cert Status: good
价格不是变量。DV 证书普遍免费附带 OCSP;OV/EV 证书(约 800–3000 元/年)同样附带,OCSP 本身从不单独计费。自建 Responder 只花服务器成本,OpenSSL 的 ocsp 子命令、EJBCA、step-ca 都能承担。
- 服务器维护 · 网站代维护 · 服务器托管代维
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
2025 年最大的变量是 Let’s Encrypt。据 Let’s Encrypt 官方公告,其 OCSP 服务已于 2025 年 5 月 7 日停止,最后一张带 OCSP URL 的证书在 2025 年 5 月 6 日签发,此后全面转向 CRL 与 ARI(ACME Renewal Information)。给 LE 证书配 stapling 已无意义:配置留着不报错,但永远不会有响应,openssl s_client -status 只会显示 OCSP response: no response sent。
落到选型:
- 公网 HTTPS:商业 CA 证书用 OCSP Stapling,同时保留 CRL 作为兜底;证书若来自 LE,直接跳过 stapling,靠 ARI 提前续期。
- 内网自建 CA:OCSP 或 CRL 均可,客户端可控时 CRL 更省事,注意列表体积随吊销量线性膨胀。
- 对生命周期敏感:短期证书 + ARI,把“吊销”从查询问题变成续期问题,这也是 OCSP 是什么这个问题的答案正在被重新定义的原因。
常见错误与排查:这些报错分别意味着什么
先分清两类故障:一类是根本拿不到响应(DNS、出网、CA 停服、Nginx 配置缺失),另一类是拿到了响应但内容有问题(证书真被吊销、响应签名验不过、响应过期)。前者改配置就能恢复,后者只能重签证书。下表是 nginx 1.24 / OpenSSL 3.0 环境下最常见的六种原文报错。
| 报错原文 | 最可能的根因 | 一句话验证 | 处置 |
|---|---|---|---|
ocsp: error while querying responder |
DNS/出网不通,或 CA 已停服 OCSP | curl -v <ocsp_uri> |
修网络;Let’s Encrypt 证书直接关 stapling |
"ssl_stapling" ignored, issuer certificate not found |
ssl_trusted_certificate 未配,或文件里只有 leaf |
grep -c "BEGIN CERT" 文件 |
指向含中间 CA 的链文件 |
OCSP response: no response sent |
服务端未开 stapling、缓存未建立,或客户端没发 status_request |
nginx -T | grep ssl_stapling |
开启后间隔 30 秒重试 |
verify error:num=23:certificate revoked |
证书确已被 CA 吊销 | openssl ocsp ... -resp_text |
只能重新签发 |
Response Verify Failure + unable to get local issuer certificate |
-CAfile 缺中间 CA,或 Delegated Responder 未给 -verify_other |
检查链是否完整 | 补全链,别用 -noverify |
OCSP_check_validity() failed / tryLater (2) |
响应已过 nextUpdate,或 CA 限流 |
看输出里的 Next Update |
查询间隔拉到 5 分钟以上 |
1. ocsp: error while querying responder 一定是网络问题吗?不一定,先用 responder 的真实 URL 打一发:
# 从证书里取出真实的 OCSP URL(不要凭印象手写域名)
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ocsp_uri
# 直接请求它,--max-time 防止 nginx 侧无限等待
curl -v --max-time 10 "$(openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ocsp_uri)"
超时说明 DNS 解析失败或 80 端口出网被防火墙拦;能连上却返回 4xx/5xx,则是 CA 侧的问题。据 Let’s Encrypt 官方公告 Ending OCSP Support in 2025,其 OCSP responder 已于 2025 年 5 月 7 日停止服务,因此此后对 Let’s Encrypt 证书出现这条报错属于预期行为,正确做法是直接关掉:
# 仅在确认使用 Let's Encrypt 证书后执行
ssl_stapling off;
# ssl_stapling_verify / ssl_trusted_certificate 中仅为 OCSP 服务的配置可一并移除
2. "ssl_stapling" ignored, issuer certificate not found 为什么不报错只报 warn?因为 nginx -t 只校验语法,这条 warn 出现在 error.log 里,配置会被静默跳过。Nginx 需要用签发者公钥验证 OCSP 响应的签名,只给 leaf 证书时找不到 issuer。把 ssl_trusted_certificate 指向同时包含中间 CA 与根的 PEM(ssl_stapling 自 nginx 1.3.7 起可用),并用 grep -c "BEGIN CERTIFICATE" 确认文件里至少两张证书,然后 nginx -t 看到 syntax is ok 即生效。
3. openssl s_client -status 输出 OCSP response: no response sent 怎么办?-status 是必须的——status_request 是 TLS 扩展,不带就不会请求,服务端自然不回。先确认服务端确实开了:
nginx -T 2>/dev/null | grep -E 'ssl_stapling|ssl_trusted_certificate'
# 再带 -status 复测,间隔 30 秒
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -E 'OCSP Response Status|no response sent'
若 nginx -T 有输出却仍为空,回 error.log 找前面那两条 warn。
4. 看到 certificate revoked / 浏览器 ERR_CERT_REVOKED 还有救吗?没有。用 RFC 6960 定义的状态查询确认一次即可死心:
openssl ocsp -issuer /etc/nginx/ssl/chain.pem -cert /etc/nginx/ssl/cert.pem
-url "$(openssl x509 -in /etc/nginx/ssl/cert.pem -noout -ocsp_uri)"
-CAfile /etc/nginx/ssl/fullchain.pem -resp_text
输出 Cert Status: revoked 加 Revocation Time 就是真吊销(私钥泄露后 CA 主动吊销是典型场景)。吊销状态由 CA 签名,stapling 只是搬运响应,改任何配置都改变不了结论,只能重新签发。
5. Response Verify Failure + unable to get local issuer certificate:-CAfile 里缺中间 CA 或根。部分 CA 用 Delegated Responder,签名证书由另一张 OCSP 签名证书签发,此时要额外加 -verify_other ocsp_signer.pem。补全链后重试,不要用 -noverify 掩盖——那等于放弃验证签名,问题会原样带进生产。
6. OCSP_check_validity() failed 或 tryLater (2):前者说明响应已过 nextUpdate,后者是 RFC 6960 里的临时失败状态,CA 对高频查询限流时常见。把脚本查询间隔拉到 5 分钟以上。Nginx 侧需要说明:它没有设置 OCSP 缓存秒数的指令,缓存窗口由响应里的 nextUpdate 自动决定;能调的是 resolver 8.8.8.8 valid=300s;(valid= 自 nginx 1.7.3 起支持),它控制的是 DNS 缓存而非 OCSP 缓存。必须精确控制刷新时,改用 ssl_stapling_file 配合 cron 定期重新拉取响应文件。
# 最小可用配置(nginx 1.3.7+)
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 关键:含中间 CA,非站点证书
ssl_stapling on;
ssl_stapling_verify on;
resolver 8.8.8.8 1.1.1.1 valid=300s; # DNS 缓存,非 OCSP 缓存
resolver_timeout 5s;
怎么确认 OCSP Stapling 真的生效了?四种验证手段
把 ssl_stapling on; 写进配置,只能说明 Nginx 愿意去取 OCSP 响应,并不代表握手时真的把响应发给了客户端。想搞清 OCSP 是什么、以及它是否在你的链路上真正生效,必须从客户端侧和服务端侧各验一次。下面四种手段从外到内排列,建议至少跑前两种。
一、openssl s_client:最直接的客户端视角。 -status 会让客户端在握手中携带 status_request 扩展(RFC 6066),服务端若已 stapling,就会在 CertificateStatus 消息里回送 OCSP 响应:
# OpenSSL 1.0.2+/1.1.1/3.x 通用;-servername 必给,否则可能命中默认站点证书而误判
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -A 12 'OCSP Response'
# 生效时的关键两行(OpenSSL 3.x 输出格式):
# OCSP Response Status: successful (0x0)
# Cert Status: good
# 完全没有 "OCSP Response" 段落 = 服务端未下发 stapling 响应
注意 Cert Status: good 才是终点,只有 successful (0x0) 说明响应本身解析成功但未必覆盖这张证书。缺 -servername 是最常见的假阴性来源。
二、curl –cert-status:一行命令的快速判断。 该选项自 curl 7.41.0(2015-02)引入,需 TLS 后端为 OpenSSL/GnuTLS/NSS:
# 退出码 0 = 状态 good;91 = CURLE_SSL_INVALIDCERTSTATUS(状态非 good 或校验失败)
curl -v --cert-status https://example.com -o /dev/null 2>>1 | grep -i 'certificate status'
# 正常:SSL certificate status: good (0)
# 吊销:SSL certificate status: revoked (1)
它的局限恰好是排查要点:部分版本的 OpenSSL 后端在服务端没有下发 stapling 时会自己向 CA 的 OCSP responder 发起查询,所以看到 good 不能单独证明 stapling 生效,要严格区分请回到 s_client -status。另外据 Let’s Encrypt 官方公告《Ending OCSP Support in 2025》,其 OCSP 响应服务已停止、全面转向 CRL,对这类证书做 stapling 验证时若看到 responder 超时,先确认 CA 是否还提供 OCSP。
三、服务端日志 + 配置核对:定位“为什么没生效”。
tail -f /var/log/nginx/error.log | grep -i stapling # 正常应无输出
nginx -T | grep -E 'ssl_stapling|resolver' # 确认 include 后真正加载的配置
# /etc/nginx/conf.d/tls.conf 关键四行(nginx 1.3.7+ 支持 ssl_stapling_verify)
ssl_stapling on;
ssl_stapling_verify on; # 默认 off,开启后用 trusted_certificate 校验响应签名
ssl_trusted_certificate /etc/nginx/chain.pem; # 含中间证书的完整链,缺它常报 issuer certificate not found
resolver 8.8.8.8 1.1.1.1 valid=300s; # 无 resolver 时 Nginx 无法解析 OCSP 域名
resolver_timeout 5s;
常见告警原文包括 "ssl_stapling" ignored, issuer certificate not found(链不完整)、no resolver defined to resolve ...(缺 resolver)、OCSP response not valid yet(本机时钟偏差)。
四、离线看响应有效期 + 监控化。 stapling 响应是有寿命的,缓存过期后 Nginx 会重新查询,若 CA 响应失效则握手回退为不 stapling:
openssl ocsp -issuer issuer.pem -cert cert.pem -url http://ocsp.example.com -respout resp.der
openssl ocsp -respin resp.der -resp_text -noverify | grep -E 'This Update|Next Update'
# Next Update 距今小于 1 天即应视为缓存风险;有效期由 CA 决定,Let's Encrypt 历史值约 7 天量级
#!/bin/sh
# /etc/cron.d/ocsp: */5 * * * * root /usr/local/bin/ocsp-check.sh
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -q 'OCSP Response Status: successful' || logger -t ocsp 'stapling FAILED'
| 手段 | 依赖/版本 | 能看到什么 | 主要误判风险 | 适用场景 |
|---|---|---|---|---|
openssl s_client -status |
OpenSSL 1.0.2+ | 握手内实际下发的 OCSP 响应、Cert Status、Update 时间 | 漏写 -servername 命中错误证书 |
上线验收、故障复现 |
curl --cert-status |
curl 7.41.0+ | 最终证书状态 good/revoked | 客户端可能自行查 OCSP,无法证明服务端 stapling | 快速巡检、CI 冒烟 |
error.log + nginx -T |
nginx 1.3.7+ | 配置是否加载、失败原因原文 | 日志级别非 warn 时告警被吞 | 排障定位根因 |
openssl ocsp -respin |
OpenSSL 1.1.1+ | thisUpdate / nextUpdate 精确时间 | 离线文件非线上实际缓存 | 评估缓存与时钟风险 |
要把这件事纳入监控,注意 blackbox_exporter 的 ssl 探针只输出 probe_ssl_earliest_cert_expiry、probe_tls_version_info 等指标,并不检查 stapling;正确做法是用 textfile collector 把上面那段 s_client 脚本的结果写成 ocsp_stapling_ok 0|1 暴露给 Prometheus,与证书剩余天数一起告警。
Let's Encrypt 停用 OCSP 之后,运维要做哪些调整
据 Let’s Encrypt 官方公告,OCSP 服务的时间线是:2024 年底宣布停用计划,2025 年 5 月 6 日签发最后一张带 OCSP URL 的证书,2025 年 5 月 7 日 Responder 正式下线。要理解这次调整的分量,得先回到 ocsp是什么 这个基本问题——它是客户端拿着证书序列号向 CA 实时询问“这张证书是否已吊销”的协议(RFC 6960),比下载整份 CRL 轻量,但要求 CA 长期维护高可用 Responder,且会向 CA 暴露用户正在访问哪些站点。LE 选择用短有效期证书 + CRL + ARI 替代它,本质上是把“事后吊销”换成“快速轮换”。
对存量部署,影响集中在日志层面而非可用性层面。浏览器对 stapling 失败普遍软失败(soft-fail),站点照常打开,但 Nginx 会持续刷错误。先用两条命令确认你手上的证书处于哪种状态:
# 1) 查看证书是否还带 OCSP Responder 地址
# 2025-05-06 之前签发的 LE 证书会输出类似 http://r3.o.lencr.org
# 之后的证书无任何输出,说明该证书不含 OCSP URL
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -ocsp_uri
# 2) 对旧证书手工发起一次查询,5 月 7 日后会连接失败或超时
# -noverify 跳过响应签名校验,仅用于连通性排查
openssl ocsp -issuer /etc/nginx/ssl/chain.pem
-cert /etc/nginx/ssl/cert.pem
-url http://r3.o.lencr.org
-resp_text -noverify
# 失败时典型输出:Error querying OCSP responder(伴随 OCSP routines 错误行)
Nginx 侧对应两种日志。证书已无 OCSP URL 时,ssl_stapling on 会在启动/重载时被忽略;旧证书则会持续查询已下线的 Responder 并超时:
2025-05-08 10:12:33 [warn] 3812#3812: "ssl_stapling" ignored, no OCSP responder URL in the certificate "/etc/nginx/ssl/fullchain.pem"
2025-05-08 10:12:34 [error] 3812#3812: OCSP request for "example.com" failed (SSL: ...)
处理方式按证书来源分两条路。LE 证书直接注释掉三行 stapling 指令即可(ssl_stapling 自 Nginx 1.3.7 起提供,默认 off);商业 CA 证书保持开启,并务必配合 ssl_stapling_verify on 与完整的 ssl_trusted_certificate 链:
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# Let's Encrypt 证书:2025-05-07 后 Responder 已下线,注释掉可消除日志噪音
# ssl_stapling on;
# ssl_stapling_verify on;
# ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
# 商业 CA(DigiCert/Sectigo/GlobalSign)证书:保留上面三行,Responder 仍在运行
resolver 223.5.5.5 valid=300s; # 不配 resolver 时 stapling 不会工作
resolver_timeout 5s;
}
替代路径有两条:一是 CRL,LE 的 CRL 由中间 CA 发布,nextUpdate 通常只有数天,适合客户端主动拉取;二是 ARI(ACME Renewal Information),CA 在响应里用 suggestedWindow 告诉客户端何时续期,Certbot 2.10+ 已内置支持,从机制上把“吊销”变成“提前换证”。三种方案怎么选:
| 方案 | 吊销查询机制 | 是否开 Nginx stapling | 适用场景 |
|---|---|---|---|
| Let’s Encrypt(2025-05 后) | 无 OCSP,靠 CRL + 短有效期 + ARI | 否,开了只会刷日志 | 通用公网站点 |
| 商业 CA OV/EV | OCSP Responder 持续在线 | 建议开启,可配 Must-Staple | 合规、强吊销检查要求 |
| 自建 PKI(OpenSSL / step-ca) | 自建 OCSP Responder + CRL | 内网建议开启 | 内网服务、mTLS |
自建 PKI 的用户不受影响,但要注意响应缓存与索引膨胀两个坑。OpenSSL 自带的 Responder 用 -nmin 控制响应有效期,默认 300 秒(5 分钟),内网可设 5–15 分钟以降低 CA 压力(RFC 5019 规定上限为 4 天):
# -nmin 10:响应缓存 10 分钟;默认 300 秒
openssl ocsp -index /etc/pki/CA/index.txt -port 8888
-rsigner /etc/pki/CA/ocsp.crt -rkey /etc/pki/CA/ocsp.key
-CA /etc/pki/CA/ca.crt -nmin 10 -text
# index.txt 会随签发量线性增长,定期把过期条目移出并归档
openssl ca -config /etc/pki/CA/openssl.cnf -updatedb
cp -a /etc/pki/CA/index.txt /etc/pki/CA/index.txt.$(date +%F)
内网 Nginx 开 stapling 的意义在于:让边缘节点缓存响应,避免每台客户端都回源查 CA。配置时把 resolver 的缓存时间与 -nmin 对齐,否则会出现 Nginx 缓存比 Responder 声明更久、拿旧响应的隐性错误。如果你还在纠结 ocsp是什么、该不该保留 stapling,判断标准其实只有一条——openssl x509 -noout -ocsp_uri 有没有输出。
CRL 是全量吊销列表,文件常见 5-20 MB、更新周期约 7 天;OCSP 按需查询单张证书,响应 1-2 KB、秒级返回。快慢取决于场景:首次查询 OCSP 更快,但客户端已缓存 CRL 时 CRL 不产生额外请求。
Chrome 自 2012 年起不再做在线 OCSP,改用本地 CRLSet 推送;Firefox 仍会查询但采用软失败,数秒无响应就放行。所以线上站点不能依赖浏览器主动发现吊销。
先看 nginx -T | grep ssl_stapling 确认配置加载,再看 error.log 是否有 issuer certificate not found 或 no resolver defined。ssl_trusted_certificate 要含中间 CA 与根,resolver 必须显式配置;首次握手是异步拉取,间隔 10-30 秒重试通常就有响应。
不需要。LE 已于 2025 年 5 月 7 日停止 OCSP 服务,证书里不再带 OCSP URL,stapling 不会有响应。可以把 ssl_stapling 关掉以减少无效查询,改用 CRL 与 ARI 关注续期。
不会增加客户端 RTT,响应是服务端提前拉好、随 Certificate 消息之后下发的,报文通常 1-2 KB。代价在服务端:需要缓存与异步刷新,Nginx 默认按 resolver valid=300s 的节奏更新 DNS 与响应。
不代表。good 只表示该序列号当前未被吊销,证书仍可能是钓鱼站点申请的合法 DV 证书,或私钥已泄露但 CA 尚未收到吊销请求。吊销检查与域名核验、CT 日志是互补关系。
软件成本为零,OpenSSL 的 ocsp 子命令、EJBCA、step-ca 都能跑;成本主要是服务器与高可用。测试环境一条 openssl ocsp -index index.txt -port 8888 -rsigner ocsp.pem -rkey ocsp.key -CA ca.pem 就能起服务。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。