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

HTTPS 加密过程全解析:TLS 1.3 握手 8 步、Nginx 配置与真实报错排查

https加密过程 — HTTPS 加密过程全解析:TLS 1.3 握手 8 步、Nginx 配置与真实报错排查
核心结论

HTTPS 加密过程 = TCP 三次握手后的一次 TLS 握手(TLS 1.3 为 1-RTT),之后用协商出的对称密钥做 AEAD 加密传输;证书只负责身份认证与签名,业务数据由 AES-128-GCM 或 ChaCha20-Poly1305 加密。 TLS 1.3 比 TLS 1.2 少一个往返:用 openssl s_client -connect example.com:443 -tls1_3 -brief 可看到 Protocol version: TLSv1.3、Ciphersuite: TLS_AES_128_GCM_SHA256、Verification: OK 三行关键输出。 密钥交换默认用 ECDHE + X25519,会话密钥由 HKDF-Extract/Expand 派生,Nginx 需显式配置 ssl_ecdh_curve X25519:prime256v1:secp384r1;(1.11.0+ 支持多值)。 证书链不完整是最高频故障:openssl s_client 报 verify error:num=20:unable to get local issuer certificate 时,把中间证书按“叶子 → 中间”顺序拼进 fullchain.pem 即可。 验证生效看三条命令:openssl s_client -connect 域名:443 -tls1_3 查协议、openssl s_client -status 查 OCSP 装订、testssl.sh 3.2 --fast 查是否禁用 TLS 1.0/1.1。

HTTPS 加密过程到底加密了什么?问题背景与根本原因

先给结论:HTTPS 加密的只有 TLS Record 层里承载的应用数据,也就是 HTTP 报文本身。IP 头、TCP 头全程明文,TLS 1.2 握手里的 SNI(客户端要访问的域名)也是明文——除非你部署了 ECH(Encrypted Client Hello,需 TLS 1.3 + DNS HTTPS 记录)。据 RFC 8446 第 2 节,TLS 1.3 的握手消息从 ServerHello 之后才进入加密状态,而 ClientHello 里的 SNI 仍裸露在链路上。所以”HTTPS 隐藏了你访问哪个网站”这个说法,在传统部署下并不成立。

一次 HTTPS 请求可以拆成三段,各段耗时与加密状态如下:

阶段 典型往返 是否加密 关键点
TCP 三次握手 1 RTT 全明文 SYN/SYN-ACK/ACK,可被中间设备观测
TLS 1.3 握手 1-RTT(会话恢复可 0-RTT) ClientHello 明文,之后加密 RFC 8446 精简为单次往返
TLS 1.2 握手 2-RTT 同上 多一轮,且若用 static RSA 则无前向保密
HTTP 请求/响应 1 RTT AEAD 加密 TLS_AES_128_GCM_SHA256 等

想亲手确认 SNI 是明文?在客户端机器上抓包即可:

# 需要 root 权限;-A 以 ASCII 打印载荷,-c 20 抓 20 个包后退出
sudo tcpdump -i eth0 -n -A 'tcp port 443' -c 20 | grep -a "example.com"
# 若能看到 ClientHello 里的明文域名,说明未启用 ECH(绝大多数站点如此)

非对称算法只在握手阶段出场。ECDHE(如 X25519)负责协商出共享秘密,RSA/ECDSA 私钥只用来对 CertificateVerify 消息签名,向对端证明”我确实持有证书对应的私钥”。握手一旦完成,业务数据全部切换到 AEAD 对称加密,例如 TLS_AES_128_GCM_SHA256、TLS_CHACHA20_POLY1305_SHA256(RFC 8446 第 2 节、RFC 5116)。这就是为什么”256 位 ECC 证书”并不比”2048 位 RSA 证书”更慢——真正决定吞吐的是对称套件和是否开启硬件 AES-NI。

证书本身不加密任何数据。按 RFC 5280,X.509 证书只承担两件事:身份绑定与公钥分发。客户端验证的内容包括签名链完整性、有效期、KeyUsage/ExtendedKeyUsage、SAN 域名匹配,以及吊销状态(CRL/OCSP)。因此”换个更贵的证书加密更强”是误解:加密强度只取决于密钥长度与协商套件,与 DV/OV/EV 类型无关。

握手失败的原因高度集中,用一条命令就能分层定位:

# -showcerts 打印完整链,-servername 显式传 SNI(虚拟主机必需)
openssl s_client -connect example.com:443 -servername example.com -showcerts  数分钟即会被判未生效
# 若报 handshake failure(alert 40)或 NO_CYPHER_OVERLAP,说明协议版本/套件无交集

握手慢的原因同样可枚举:未启用 TLS 1.3、未开 ssl_session_cache 与 session tickets、仍用 TLS 1.2 的 static RSA 密钥交换(无前向保密且多一次往返)、OCSP 装订未开启导致客户端自行拉取 OCSP 增加 100–300 ms。这四项在 Nginx 上都是单行配置能解决的,后续小节会给出完整配置与验证方法。

成本参考(据 Let’s Encrypt 文档,ACME 协议见 RFC 8555):

证书类型 价格区间 有效期 验证内容
Let’s Encrypt DV 0 元 90 天,建议自动续期 域名控制权
国内付费 DV 100–500 元/年 通常 1 年 域名控制权
OV 800–3000 元/年 1 年 + 企业主体核验
EV 2000–8000 元/年 1 年 + 严格主体核验(浏览器已不再显示绿色地址栏)

从 ClientHello 到应用数据:HTTPS 加密过程的完整实操步骤

经常有人问:”浏览器地址栏出现小锁的那一刻,HTTPS 加密过程到底完成了什么?”准确地说,小锁只代表证书链验证通过;真正的对称加密密钥是在 TLS 1.3 握手的前两个往返报文(1-RTT)里由 ECDHE 协商出来的,而且每条连接、每次握手都不相同。下面按可复现的操作顺序走一遍,命令均可直接复制。

步骤 1:生成私钥与 CSR。OpenSSL 3.0 起官方推荐 ECDSA P-256(prime256v1),因为它的签名与密钥交换开销约为 RSA 2048 的 1/3,握手更快、证书更小:

# -nodes:私钥不加密(便于 Nginx 自动加载,注意文件权限 600)
# -newkey ec -pkeyopt ec_paramgen_curve:prime256v1:生成 ECDSA P-256 私钥
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 
  -nodes -keyout example.com.key -out example.com.csr 
  -subj '/CN=example.com'
# 适用版本:OpenSSL 1.1.1+(3.x 默认安全级别 SECLEVEL=2,P-256 满足要求)

步骤 2:签发证书。据 Let’s Encrypt 文档,其证书有效期固定为 90 天,官方建议在到期前 30 天续期;用 certbot 2.10 的 webroot 方式签发(不改动现有 Nginx 配置):

certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com
# 产物目录:/etc/letsencrypt/live/example.com/
#   privkey.pem  fullchain.pem  chain.pem  cert.pem
# 续期建议用 systemd timer 每日跑一次演练,提前暴露问题:
# certbot renew --dry-run --deploy-hook "nginx -s reload"

步骤 3:拼出完整证书链。顺序必须是叶子证书 → 中间证书,写反后部分客户端(尤其是 Android 与 Java 客户端)会报 verify error:num=21:unable to verify the first certificate:

cat example.com.crt intermediate.crt > fullchain.pem
# Nginx 中 ssl_certificate 必须指向 fullchain.pem,而非叶子证书
# 自检:链中证书数量应为 2 及以上
grep -c 'BEGIN CERTIFICATE' fullchain.pem

步骤 4:抓一次真实握手。用 s_client 观察报文,这是理解 HTTPS 加密过程最直接的方式:

openssl s_client -connect example.com:443 -servername example.com 
  -tls1_3 -msg -state </dev/null
# ClientHello 中可见 supported_versions(0x0304)、key_share(x25519,32 字节)、
#   signature_algorithms、supported_groups
# ServerHello 只回一个 key_share —— 这正是 TLS 1.3 只需 1-RTT 的原因:
#   客户端把自己猜测的组密钥份额一次带上,服务端选定即可立即算共享秘密

步骤 5:密钥派生。双方用 ECDHE 得到共享秘密后,按 RFC 8446 第 7.1 节,经 HKDF-Extract 得到 Early Secret,再用 HKDF-Expand-Label 依次派生 client_handshake_traffic_secret、server_handshake_traffic_secret,最后由服务端 Finished 后的主秘密派生应用流量密钥。前向安全性就来自这里:私钥泄露也无法还原历史会话密钥。

步骤 6:离线校验并平滑上线。先本地验链,再 reload,避免把错误配置推给线上:

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
nginx -t && nginx -s reload   # Nginx 1.25.4 平滑 reload,既有连接不断开
维度 ECDSA P-256 RSA 2048 RSA 4096
等价安全强度 约 128 位 约 112 位 约 140 位
签名长度 约 70–72 字节 256 字节 512 字节
握手 CPU 开销 低(约为 RSA 2048 的 1/3) 中 高
兼容性 TLS 1.2 + ECDSA 套件;老客户端(XP/Android 4.x)可能失败 最广 最广
推荐场景 现代浏览器为主的生产站点 需兼容老旧终端 合规硬性要求时

实践提示:若 reload 后访问报 SSL_CTX_use_PrivateKey_file() failed,多半是私钥与证书不匹配;用 openssl x509 -noout -pubkey -in fullchain.pem 与 openssl pkey -pubout -in privkey.pem 对比两段公钥是否完全一致即可定位。

配置与命令示例:Nginx 1.25 与 OpenSSL 3.x 逐参数说明

先给结论:Nginx 1.25.4 的 HTTPS 配置真正决定安全基线的只有三行(协议、套件、服务端偏好),其余都是性能与运维细节。下面这份配置可直接落到 /etc/nginx/conf.d/https.conf,注释标出每一行的作用与适用版本。

# 适用:Nginx 1.25.4 + OpenSSL 3.0/3.1/3.2;证书链由 fullchain.pem 提供
server {
    listen 443 ssl;
    http2 on;                          # Nginx 1.25.1 起用独立 http2 指令,替代 listen ... http2
    server_name example.com;

    ssl_certificate         /etc/nginx/fullchain.pem;
    ssl_certificate_key     /etc/nginx/privkey.pem;
    ssl_trusted_certificate /etc/nginx/chain.pem;   # 只放中间证书,供 OCSP 校验,不下发给客户端

    # ① 协议:TLS 1.0/1.1 已被 RFC 8996 正式弃用,无合规价值
    ssl_protocols TLSv1.2 TLSv1.3;

    # ② TLS 1.2 套件:全 ECDHE 前向保密 + AEAD,快的排前面
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;      # 默认即 off;现代客户端的选择通常更优,显式写出防止被模板覆盖

    # ③ TLS 1.3 套件不经 ssl_ciphers,必须走 OpenSSL 通道(Nginx 1.19.4+ 支持 ssl_conf_command)
    ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;

    # ④ 密钥交换曲线:Nginx 1.11.0+ 支持多值,按书写顺序协商
    ssl_ecdh_curve X25519:prime256v1:secp384r1;

    # ⑤ 会话复用:1 MB 约存 4000 个会话,10 MB 约 4 万
    ssl_session_cache   shared:SSL:10m;   # 默认 none
    ssl_session_timeout 1d;               # 默认 5m
    ssl_session_tickets off;              # 默认 on

    # ⑥ OCSP 装订:省掉客户端额外一次 CA 查询
    ssl_stapling        on;               # 默认 off
    ssl_stapling_verify on;               # 默认 off
    resolver 223.5.5.5 1.1.1.1 valid=300s;  # 必须配,否则装订被忽略
    resolver_timeout 5s;
}

为什么 ssl_prefer_server_ciphers off 反而更好? 因为套件列表是给 TLS 1.2 用的,而 TLS 1.3 的套件选择完全由客户端与服务端各自独立决定,服务端偏好在这代协议里没有意义。现代客户端(Chrome、curl 8.x)会优先选自己硬件加速最好的 AEAD 套件;强行让服务端拍板,只会在老旧客户端上引发多余的重协商。据 Mozilla SSL Configuration Generator 的 intermediate 配置建议,这一项同样推荐 off。

ssl_ecdh_curve 的顺序就是性能优先级。 据 OpenSSL 3.2 官方基准测试,X25519 在 x86_64 上完成一次 ECDHE 公钥计算比 prime256v1(NIST P-256)快约 2–3 倍,且实现更简单、更易做常数时间。把 X25519 放第一位,等于让绝大多数握手走快路径;保留 prime256v1 与 secp384r1 是为了兼容不支持 X25519 的老客户端和某些国密/硬件场景。

关掉 session tickets 是有代价的。 TLS 1.2 及以下可以用 Session ID 走共享缓存复用,但 TLS 1.3 的会话恢复只依赖 NewSessionTicket(PSK)。所以 ssl_session_tickets off 在 TLS 1.3 下等于放弃了恢复能力,每次连接都要完整握手;换来的是避免票据密钥轮换窗口内旧票据被解密的风险。如果你更看重握手耗时(比如移动端弱网),可以改为 on 并接受轮换周期内的前向保密折损。

指令 默认值 本节取值 生效范围
ssl_protocols TLSv1 TLSv1.1 TLSv1.2(1.23.4 起改为 TLSv1.2 TLSv1.3) TLSv1.2 TLSv1.3 TLS 1.2 / 1.3
ssl_ciphers HIGH:!aNULL:!MD5 6 个 ECDHE-AEAD 套件 仅 TLS ≤1.2
ssl_prefer_server_ciphers off off 仅 TLS ≤1.2
ssl_ecdh_curve auto X25519:prime256v1:secp384r1 ECDHE 密钥交换
ssl_session_cache none shared:SSL:10m TLS ≤1.2 Session ID
ssl_session_tickets on off TLS 1.3 恢复的唯一通道
ssl_stapling / _verify off / off on / on 证书状态装订

装订最常见的报错是“配了却没用”。 缺 resolver 时 Nginx 无法解析证书里的 OCSP Responder 域名,日志会直接给告警而不是硬失败:

# nginx -t 或 error.log 中的典型输出
nginx: [warn] "ssl_stapling" ignored, no resolver defined to resolve OCSP responder
nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate "/etc/nginx/fullchain.pem"
# 后者说明 ssl_trusted_certificate 缺失或没带中间证书

改完必须验证,别只看 nginx -t。 -t 只查语法,不查握手结果:

# 1) 强制 TLS 1.3 握手,确认协议、套件与证书链校验
openssl s_client -connect example.com:443 -tls1_3 -brief
# 期望输出含:Protocol version: TLSv1.3 / Ciphersuite: TLS_AES_128_GCM_SHA256 / Verification: OK

# 2) 确认 TLS 1.2 下服务端给的套件落在白名单里
openssl s_client -connect example.com:443 -tls1_2 -brief 2>/dev/null | grep Ciphersuite

# 3) 用 curl 8.x 量真实握手耗时(秒,含 TCP+TLS)
curl -v --tlsv1.3 --tls-max 1.3 https://example.com -o /dev/null 
     -w 'appconnect=%{time_appconnect}sn'

把 time_appconnect 与会话复用一起看才有意义:第一次连接通常是 0.10–0.25 s,命中复用后应降到 0.03–0.08 s(同城 RTT 前提下)。如果两次数值一样,说明会话复用没生效——先查 ssl_session_tickets off 是否让 TLS 1.3 无法恢复,再查是否有多台后端而缓存不是 shared。这套验证思路与前面拆解的 HTTPS 加密过程里“握手阶段决定延迟”的结论是一致的:真正拖慢首字节的是密钥交换与证书链,而不是对称加密本身。

参数对比与方案选型:协议版本、密钥算法、会话复用怎么选

选型不是”越新越好”,而是”在客户端兼容性允许的范围内取最强组合”。Nginx 默认值往往落后于安全基线——ssl_protocols 在 1.23.4 之前默认是 TLSv1 TLSv1.1 TLSv1.2,这意味着升级 Nginx 并不会自动关掉已被弃用的协议。据 RFC 8996(2021 年 3 月发布),TLS 1.0 与 TLS 1.1 被正式弃用,不应再出现在生产配置中。

协议版本怎么选?核心差异在握手往返次数与”握手消息是否加密”。TLS 1.3(RFC 8446)把完整握手压到 1-RTT,且 ServerHello 之后的所有握手消息(含证书)都受加密保护,只保留 (EC)DHE 类前向保密套件;TLS 1.2 需要 2-RTT,允许 CBC 模式和 static RSA(无前向保密)。值得注意的是:TLS 1.3 的密码套件由 OpenSSL 内部固定,ssl_ciphers 指令对它完全无效,只作用于 TLS 1.2 及以下。

协议版本 握手往返 前向保密 握手消息加密 建议
TLS 1.3 (RFC 8446) 1-RTT(PSK 恢复可 0-RTT) 强制,(EC)DHE only ServerHello 之后全部加密 首选
TLS 1.2 (RFC 5246) 2-RTT 取决于套件,static RSA 无 PFS 仅 CertificateVerify 之后 兜底保留
TLS 1.1 / 1.0 2-RTT 可 CBC / RC4 否 RFC 8996 已弃用,关闭

密钥算法与曲线怎么选?ECDSA P-256 的签名耗时约为 RSA 2048 的 1/3 到 1/5,证书体积也小近一半,直接降低握手 CPU 与首字节时间。代价是老旧客户端:Android 4.x(4.4 之前)与 Java 6 不支持 ECDSA 证书链,会直接握手失败。工程上的标准做法是双证书——同一 server 块同时挂 ECDSA 与 RSA 证书,由 Nginx 依据客户端 ClientHello 的签名算法列表自动挑选,无需额外判断逻辑。

维度 单次握手签名耗时(参考值) 证书体积 兼容性
RSA 2048 1.5–3 ms 约 1.2 KB 全覆盖,必备兜底
ECDSA P-256 0.3–0.8 ms 约 0.7 KB 不支持 Android 4.x / Java 6
曲线 X25519 密钥仅 32 字节,常量时间实现,无专利障碍 — 首选(OpenSSL 1.1.1+)
曲线 prime256v1 (P-256) 兼容性最广 — 第二优先
曲线 secp384r1 安全强度更高,约慢 3 倍 — 仅作兜底
# 适用:Nginx 1.25.1+ / OpenSSL 1.1.1+(ssl_conf_command 需 1.19.4+)
server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1 起替代 listen 443 ssl http2;

    # 双证书:ECDSA 优先,RSA 兜底老旧客户端
    ssl_certificate     /etc/nginx/ssl/example.ecdsa.crt;
    ssl_certificate_key /etc/nginx/ssl/example.ecdsa.key;
    ssl_certificate     /etc/nginx/ssl/example.rsa.crt;
    ssl_certificate_key /etc/nginx/ssl/example.rsa.key;

    ssl_protocols TLSv1.2 TLSv1.3;             # 默认值为 TLSv1 TLSv1.1 TLSv1.2,必须显式收敛
    # 以下 ssl_ciphers 只对 TLS 1.2 生效,TLS 1.3 套件由 OpenSSL 内置
    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;             # Mozilla "Intermediate" 推荐值
    ssl_conf_command Curves X25519:prime256v1:secp384r1;   # 曲线优先级,按顺序协商
}

会话复用怎么选?ssl_session_cache shared:SSL:10m 在单机多 worker 间共享,1 MB 约容纳 4000 个会话,10 MB 约 4 万,适合绝大多数单机部署;多机无共享存储时用 session ticket,但必须显式配置 ssl_session_ticket_key,否则每台机器的密钥随机生成,负载均衡后复用率接近零。据 Let’s Encrypt 与 Mozilla 运维建议,ticket key 应每 48 小时轮换,且配置文件保留”当前 + 上一把”两行以平滑过渡。TLS 1.3 的 PSK 恢复可把二次握手压到 0-RTT,但 0-RTT 数据存在重放风险,金融类接口应禁用 ssl_early_data。

复用方式 关键配置 适用场景 注意点
共享内存会话缓存 ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;(默认 5m)
单机多 worker 重启即失效
Session Ticket ssl_session_tickets on;
ssl_session_ticket_key /etc/nginx/ssl/ticket.key;
多机、无共享存储 密钥 48h 轮换,保留两把
TLS 1.3 PSK 恢复 随 ticket 自动生效 移动端高延迟链路 0-RTT 有重放风险

证书类型与 HTTP 版本的影响边界。DV / OV / EV 三者的区别只在身份核验深度与赔付条款,对 https 加密过程的算法强度没有任何影响——DV 证书同样跑 TLS 1.3 + AES-256-GCM。真正影响性能的是 HTTP 版本:HTTP/1.1 每域名开约 6 个并发连接,HTTP/2 通过 ALPN h2 在单连接上多路复用,HTTP/3 则基于 QUIC(RFC 9000)+ TLS 1.3(RFC 9001)走 UDP 443,弱网建连明显更快,但生产环境多由 CDN 卸载。

对比项 DV OV EV
签发时长 1–10 分钟(ACME 自动化) 人工审核 1–3 个工作日 3–5 个工作日
参考价格 0–500 元/年 800–3000 元/年 2000–8000 元/年
加密强度 三者完全一致,仅身份可信度与赔付额度不同

怎么验证选型是否真的生效?配置写对不等于协商成功,必须用 openssl s_client 回读实际结果:

# 1) 确认 TLS 1.3 与曲线:输出 "Protocol: TLSv1.3" 与 "Server Temp Key: X25519, 253 bits"
openssl s_client -connect example.com:443 -tls1_3 -groups X25519 -brief </dev/null

# 2) 确认会话复用:第二次连接应出现 "Reused, TLSv1.3"
openssl s_client -connect example.com:443 -sess_out /tmp/s.pem </dev/null
openssl s_client -connect example.com:443 -sess_in /tmp/s.pem </dev/null | grep -i reused

# 3) 确认双证书:应分别看到 "Server certificate" 的 EC 与 RSA 公钥
openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -text | grep "Public Key Algorithm"

两个高频真实报错:

  • 升级到 Nginx 1.25.1+ 后日志出现 nginx: [warn] the "listen ... http2" directive is deprecated, use the "http2" directive instead in /etc/nginx/conf.d/site.conf:3 —— 改为 listen 443 ssl; + 独立的 http2 on; 即可。
  • 用 openssl s_client -tls1_3 -cipher 'ECDHE-RSA-AES128-GCM-SHA256' 测试时报 no cipher match —— 这不是配置错误,而是 TLS 1.3 套件不受 -cipher/ssl_ciphers 控制,应改用 -ciphersuites TLS_AES_128_GCM_SHA256。反过来,若客户端只支持 TLS 1.2 的 CBC 套件而服务端已全部禁用,浏览器会抛 SSL_ERROR_NO_CYPHER_OVERLAP,此时需评估是否保留一条 ECDHE-RSA-AES128-SHA 作为最后兜底。

常见错误与排查:这些真实报错分别意味着什么

先看一张速查表:报错出现在哪一层,决定你从哪儿查起

报错关键词 报错层 一行定位命令
num=20 unable to get local issuer certificate 客户端校验链 openssl s_client -connect 域名:443 -showcerts
num=21 unable to verify the first certificate 客户端校验链 同上,数 BEGIN CERTIFICATE 行数
sslv3 alert handshake failure 协议/套件协商 openssl s_client -tls1
SSL_CTX_use_PrivateKey(…) key values mismatch Nginx 启动加载 比对证书与私钥公钥指纹
x509: certificate has expired 时间/有效期 date -u + chronyc tracking
ssl_stapling ignored, issuer certificate not found Nginx 配置 检查 ssl_trusted_certificate

问:客户端报 verify error:num=20:unable to get local issuer certificate,是谁的错?

九成是服务端没发送中间证书。客户端只拿到叶子证书,往上找不到签发者就断链。据 OpenSSL verify(1) 手册,-untrusted 用于提供非受信中间证书辅助建链,正好用来复验你补链后是否真的完整:

# 1) 数一下服务端实际发了几张证书;公网站点应 ≥2(叶子 + 中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 2) 拼接完整链:叶子在前、中间在后,根证书不要放(根由客户端自带)
cat example.com.crt intermediate.crt > /etc/nginx/ssl/fullchain.pem

# 3) 本地复验,期望输出 fullchain.pem: OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted /etc/nginx/ssl/intermediate.crt 
  /etc/nginx/ssl/fullchain.pem

Nginx 侧只需 ssl_certificate /etc/nginx/ssl/fullchain.pem;,该指令无默认值、必须显式配置;漏配 fullchain 只配叶子证书就是 num=20 的经典成因。

问:num=21 unable to verify the first certificate 和 num=20 有什么区别?

num=21 表示连”第一张”(叶子)都无法验,通常是链顺序写反(中间证书排在叶子前面)或整链只剩一张。仍用上面的 -showcerts 数张数确认;也可用 openssl s_client ... | openssl x509 -noout -subject -issuer 看叶子证书的 issuer 是否等于紧随其后那张证书的 subject。

问:浏览器报 SSL_ERROR_NO_CYPHER_OVERLAP,或 openssl 报 sslv3 alert handshake failure?

这是双方没有共同协议版本或密码套件,不是证书问题。典型场景:老客户端只支持 TLS 1.0,而服务端写了 ssl_protocols TLSv1.2 TLSv1.3;。注意 Nginx 默认值随版本变化——1.19.4 之前默认 TLSv1 TLSv1.1 TLSv1.2,1.19.4 起默认 TLSv1.2 TLSv1.3;ssl_ciphers 默认 HIGH:!aNULL:!MD5(仅在 TLS 1.2 及以下生效,TLS 1.3 套件由 OpenSSL 独立控制,见 RFC 8446)。复现方法:

# 用旧协议主动握手,看服务端是否拒绝
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null
# 期望:sslv3 alert handshake failure

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
# 期望:Verify return code: 0 (ok)

问:nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: error:0A080002:SSL routines::key values mismatch) 怎么修?

证书与私钥不配对。0A080002 是 OpenSSL 3.x 的新式错误码格式,含义就是公钥不匹配。按密钥类型分别比对指纹,两边一致才可用:

# RSA:比对 modulus 摘要
openssl x509 -noout -modulus -in fullchain.pem | openssl sha256
openssl rsa  -noout -modulus -in example.com.key | openssl sha256

# ECDSA(OpenSSL 1.1.1+):比对 SubjectPublicKeyInfo 摘要
openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256
openssl pkey -pubout -in example.com.key | openssl sha256

问:x509: certificate has expired or is not yet valid 但证书明明没过期?

先排除时钟漂移。”not yet valid” 几乎都是服务器时间落后。用 date -u 对比真实 UTC 时间,timedatectl status 看 System clock synchronized: yes,chronyc tracking 看 Leap status: Normal。若时间正常,就是真过期——据 Let’s Encrypt 文档,其证书有效期仅 90 天,续期任务(certbot renew / acme.sh)静默失败是最常见诱因,检查 systemctl list-timers | grep certbot 与续期日志。

问:ssl_stapling ignored, issuer certificate not found 和 curl: (60) SSL certificate problem 呢?

前者是 Nginx 的 OCSP stapling 警告:ssl_stapling 默认 off,开启后必须配 ssl_trusted_certificate(默认未配置),且该文件需包含完整链乃至根证书,否则找不到签发者来验 OCSP 响应:

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain-with-root.pem;  # 含根,区别于 fullchain.pem

后者是客户端侧 CA 库问题,不是你服务端的锅。CentOS 7 的 ca-certificates 长期停留在 2021 年版本(如 2021.2.50-72.el7),验不过新根。用 rpm -q ca-certificates 核对,然后 yum update -y ca-certificates && update-ca-trust 刷新信任库即可。Mozilla SSL Configuration Generator 生成的配置默认已包含上述 stapling 与协议项,可作为基线对照。

配置改完、Nginx reload 之后,不能只靠浏览器地址栏那把锁来判断。地址栏的锁只说明”证书链能验证通过”,既不能告诉你协商的是 TLS 1.3 还是 TLS 1.2,也不能告诉你会话复用率是多少。下面是一套从单点探测到全量扫描、再到线上埋点的验证流程,每步都能给出可对照的期望值。

第一步:确认协议版本与加密套件。用 OpenSSL 客户端强制走 TLS 1.3,只看关键三行:

# -brief 只输出摘要;-tls1_3 强制 TLS 1.3(OpenSSL 1.1.1+ 支持)
# 2>/dev/null 屏蔽自签/握手噪声,grep 只留三行结论
openssl s_client -connect example.com:443 -tls1_3 -brief 2>/dev/null 
  | grep -E 'Protocol|Ciphersuite|Verification'
# 期望输出(OpenSSL 3.x):
# Protocol version: TLSv1.3
# Ciphersuite: TLS_AES_128_GCM_SHA256
# Verification: OK

三项都有明确含义。据 RFC 8446(TLS 1.3)附录 B.4,TLS 1.3 的套件只保留 AEAD 算法,TLS_AES_128_GCM_SHA256 是多数服务端的首选,若你看到的是 TLS_AES_256_GCM_SHA384 也正常,取决于 ssl_ciphers/ssl_conf_command Ciphersuites 的配置顺序。Verification: OK 表示客户端用系统 CA 库验证整条链成功;如果出现 Verification error: unable to get local issuer certificate,八成是服务端漏配了中间证书——这是最常见的线上故障之一。

第二步:数一数证书链里有几张证书。

# -showcerts 打印服务端发送的全部证书;统计 BEGIN CERTIFICATE 出现次数
openssl s_client -connect example.com:443 -showcerts 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 公网站点期望 >= 2(叶子证书 + 至少一张中间证书)
# 输出 1 说明只发了叶子证书,Android 7 之前/部分 Java 客户端会直接报错

只返回 1 是典型的”电脑能开、手机打不开”。原因是桌面浏览器有 AIA 抓取(自动补全中间证书)能力,而很多移动端和 Java 客户端没有。Nginx 的正确做法是把 fullchain.pem(叶子+中间)配给 ssl_certificate,只把叶子配给 ssl_certificate_key 对应的私钥即可,切勿把根证书也拼进去——那会增加握手字节数且无收益。

第三步:检查 OCSP 装订是否生效。

# -status 请求服务端装订的 OCSP 响应
openssl s_client -connect example.com:443 -status 2>/dev/null 
  | grep -A1 'OCSP Response Status'
# 期望:OCSP Response Status: successful (0x0)
# 若为 "no response sent",说明未开启 ssl_stapling 或未配 ssl_trusted_certificate

Let’s Encrypt 自 2025 年起逐步弱化 OCSP,转而主推 CRL 与短周期证书(6 天有效期已在推进中),因此这一项要结合证书签发方判断:DigiCert、Sectigo 等商业 CA 仍建议开启装订,可省掉客户端一次外连查询,显著降低首包延迟。响应里的 This Update 时间戳应在 3–7 天内,超出说明装订缓存失效。

第四步:全量扫描,确认老协议确实关了。

# testssl.sh 3.2+,--fast 跳过部分慢速检查
./testssl.sh --fast example.com
# 关注输出中:
#   TLS 1.0  offered? 期望 not offered
#   TLS 1.1  offered? 期望 not offered
#   TLS 1.3  offered? 期望 offered
# 备选:nmap 快速枚举服务端套件(无需额外脚本)
nmap --script ssl-enum-ciphers -p 443 example.com

Nginx 侧对应配置是 ssl_protocols TLSv1.2 TLSv1.3;(该指令默认值随版本变化:1.23.4 之前默认 TLSv1 TLSv1.1 TLSv1.2,务必显式声明)。据 Mozilla SSL Configuration Generator 的 intermediate 配置,禁用 TLS 1.0/1.1 已是基线要求。

第五步:线上埋点,看真实流量而不是抽样探测。

# 在 http {} 块中定义,$ssl_session_reused 为 r 表示新会话、. 表示复用
log_format ssl_info '$remote_addr $ssl_protocol $ssl_cipher '
                    '$ssl_session_reused $request_time';
access_log /var/log/nginx/ssl.log ssl_info;
# 统计 TLS 1.3 占比与复用率(目标复用率 > 60%)
awk '{p[$2]++; if($4==".") r++} END{for(k in p) print k, p[k]; print "reused", r, "of", NR}' 
  /var/log/nginx/ssl.log

第六步:量化握手性能与会话复用的收益。

# -new 强制每次新建会话,-time 10 表示测 10 秒
openssl s_time -connect example.com:443 -new -time 10
# 同机房内 ECDSA P-256 + TLS 1.3 通常每核 800–2000 次/秒
openssl s_time -connect example.com:443 -time 10
# 去掉 -new 即走会话复用,两次差值就是复用带来的吞吐提升
检查项 命令 期望值 异常含义
协议/套件 s_client -tls1_3 -brief TLSv1.3 + AEAD 套件 + Verification OK 回退到 TLSv1.2 说明客户端或服务端未开 1.3
证书链 s_client -showcerts | grep -c ≥ 2 =1 缺中间证书,移动端易失败
OCSP 装订 s_client -status successful no response sent = 未装订
老协议 testssl.sh –fast TLS 1.0/1.1 not offered offered = 存在降级风险
会话复用 awk 统计 $ssl_session_reused > 60% 偏低说明超时或 ticket key 轮换过频

复用率偏低时,先查 ssl_session_timeout(默认 5m)是否被改小,再确认多台后端是否共享 ssl_session_ticket_key——不共享 ticket key 时,请求打到另一台机器就无法复用,这正是很多人 HTTPS 加密过程看似正常、性能却上不去的隐蔽原因。

进阶:会话复用、OCSP 装订与 0-RTT 在加密过程中的作用

第一次访问要 1 个 RTT 才能完成完整握手,第二次为什么可以“边握手边发数据”?关键在会话复用。据 RFC 8446 §4.6.1,服务器在握手结束时通过 NewSessionTicket 下发一个 PSK(pre-shared key),客户端下次把它放进 ClientHello 的 pre_shared_key 扩展,直接跳过证书交换与密钥协商;若再附带 early_data 扩展,应用数据随第一个 flight 一起发出,整个 HTTPS 加密过程就被压缩到 0-RTT。Nginx 里对应三组指令:

# 适用 Nginx ≥ 1.15.3(TLS 1.3 自 1.13.0 起支持,0-RTT 需 1.15.3+ 且 OpenSSL 1.1.1+)
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;   # 默认 off;10m 约可缓存 4 万个会话
ssl_session_timeout 1d;             # 默认 5m,太短会抬高完整握手比例
ssl_session_tickets on;             # 默认 on
ssl_session_ticket_key /etc/nginx/ticket/current.key;   # 48 或 80 字节
ssl_session_ticket_key /etc/nginx/ticket/previous.key;  # 保留上一把,防止 reload 后票据全废
ssl_early_data on;                  # 默认 off,务必只对幂等请求开放

# 在 log_format 中量化复用率,便于验证优化是否生效
log_format main '$remote_addr "$request" reused=$ssl_session_reused early=$ssl_early_data';

0-RTT 的代价是可重放:RFC 8446 §8 明确要求应用层自行做防重放,攻击者截获 Early Data 后可以原样重放。因此只应对幂等 GET 开放 ssl_early_data,下单、支付类接口必须在应用层校验一次性 token,或直接返回 425 Too Early 让客户端重试。三种握手路径的差异如下:

模式 建立连接往返 是否发送证书 重放风险
TLS 1.3 完整握手 1-RTT 是 无
PSK 恢复(无 Early Data) 1-RTT 否 无
PSK + Early Data 0-RTT 否 有,需应用层兜底

票据密钥轮换是多机部署最容易踩的坑:ssl_session_ticket_key 文件长度必须为 48 或 80 字节,否则 reload 会直接失败,报 nginx: [emerg] invalid session ticket key length in "/etc/nginx/ticket/current.key"。建议每 48 小时轮换一次、始终保留当前 + 上一把,否则 reload 瞬间全部票据失效,流量会集中回落到完整握手。多台机器必须分发同一份密钥文件,否则负载均衡漂移会让客户端反复全握手。

mkdir -p /etc/nginx/ticket
openssl rand 80 > /etc/nginx/ticket/current.key   # 80 字节:TLS 1.3 所需
chmod 600 /etc/nginx/ticket/*.key
# 轮换:先把 current 备份成 previous,再生成新的 current,然后 nginx -t && nginx -s reload

OCSP 装订把吊销状态查询从客户端挪到服务端,省去客户端单独访问 OCSP 响应器的 100–300 ms,并规避 OCSP 服务器不可用导致的连接失败。启用时若缺中间证书,会看到 nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate,需补 ssl_trusted_certificate。值得注意的是,据 Let’s Encrypt 2025 年公告,其已停止在新证书中写入 OCSP URL 并计划关停 OCSP 响应器,长期方向是 CRLite 与更短有效期的证书——装订仍是过渡期的性能优化,而非永久方案。

Must-Staple(RFC 7633 定义的 TLS Feature 扩展,值 5)让证书声明“必须装订 OCSP”,可防剥离攻击,但配置失误会导致整站不可访问(Firefox 直接报 SEC_ERROR_OCSP_MUST_STAPLE),生产环境应先灰度再全量。ECH(Encrypted Client Hello)把 SNI 也纳入加密,Cloudflare 与 Firefox 已部分支持,Nginx 侧需基于 BoringSSL 或支持 ECH 的 OpenSSL 分支重新编译,截至 2025 年仍属可选优化项。

HTTPS 加密过程与 HTTP/2、HTTP/3 的关系

很多人把 HTTPS 加密过程和 HTTP/2、HTTP/3 当成两件独立的事,其实它们是同一个连接建立流程里的两个阶段:先由 TLS 握手谈好”用什么加密”,再由 ALPN 决定”握手完成后跑哪个版本的 HTTP”。理解这条链路,才能解释为什么升级 HTTP 版本会顺带改变握手次数和首字节时间。

ALPN 是怎么决定用 h2 还是 http/1.1 的?

据 RFC 7301(TLS ALPN 扩展),客户端在 ClientHello 里带上 application_layer_protocol_negotiation 扩展,按偏好顺序列出 h2、http/1.1;服务端在 EncryptedExtensions(TLS 1.3)中回选一个。协商一旦完成,TLS 记录层之上直接承载 HTTP/2 帧,不需要额外的 Upgrade 请求——这也是 HTTPS 站点开 HTTP/2 比明文 HTTP 升级更干净的原因。验证方式如下:

# curl 需由 nghttp2 支持编译;输出中关注 ALPN 行
curl --http2 -v https://example.com 2>&1 | grep -Ei 'ALPN|HTTP/2'

# 期望输出示例
# * ALPN: server accepted h2
# < HTTP/2 200

Nginx 的 http2 配置从 1.25.1 起变了,旧写法还能用吗?

能,但会告警。Nginx 1.25.1 起(据 Nginx CHANGES)推荐独立的 http2 on; 指令,旧的 listen 443 ssl http2; 仍兼容,日志里会出现 the "listen ... http2" directive is deprecated, use the "http2" directive instead。1.25.0 则引入了实验性的 QUIC/HTTP/3 支持:

# Nginx 1.25.1+ 推荐写法
server {
    listen 443 ssl;              # 默认 ssl 参数不变
    http2 on;                    # 替代旧的 listen ... http2
    server_name example.com;

    ssl_protocols TLSv1.2 TLSv1.3;          # 默认 TLSv1.2 TLSv1.3
    ssl_session_cache shared:SSL:10m;       # 默认 none;10m 约缓存 4 万会话
    ssl_session_timeout 1d;                 # 默认 5m

    # HTTP/3 实验性(Nginx 1.25.0+,需 --with-http_v3_module 编译)
    listen 443 quic reuseport;
    add_header Alt-Svc 'h3=":443"; ma=86400';
}

HTTP/3 为什么能省掉握手?

据 RFC 9001,HTTP/3 把 TLS 1.3 作为 QUIC 的握手协议内建进去,QUIC 自己完成传输层参数协商,不再有”TCP 三次握手 + TLS 握手”两层串行结构,首次连接 1-RTT、会话恢复可 0-RTT。代价是 UDP 443 必须放行,且生产环境多用 CDN 卸载而非源站直开。

维度 HTTP/1.1 over TLS HTTP/2 over TLS HTTP/3 over QUIC
传输层 TCP TCP UDP(QUIC)
握手层次 TCP + TLS 串行 TCP + TLS 串行 TLS 1.3 内建于 QUIC
首次连接 2-RTT 起 2-RTT 起 1-RTT
恢复连接 1-RTT(会话复用) 1-RTT 0-RTT
多路复用 无(队头阻塞) 有(TCP 层仍阻塞) 有(流级独立)
Nginx 最低版本 — 1.9.5 1.25.0(实验)

加密过程对性能的影响到底落在哪?

落在握手,不在对称加密。AES-NI 加持下 AES-GCM 吞吐可达数 GB/s,而一次完整 TLS 1.3 握手在移动网络下要花掉 1 个 RTT。采用 TLS 1.3 + ECDSA 证书 + X25519 密钥交换 + 会话复用的组合,可把移动网络首字节时间降低 100–300 ms,本质就是省掉这 1 个 RTT。同时,HTTP/2 多路复用虽不改变加密方式,却把单页面的连接数从 6–10 条压到 1 条——配合 ssl_session_cache shared:SSL:10m,整页 TLS 握手次数通常从 6–10 次降到 1 次。这就是为什么”HTTPS 加密过程”的性能账,最终要算到连接数和 RTT 上,而不是算到加密算法本身。

怎么验证站点跑的是 h2 还是 h3?

HTTP/2 用上面的 curl --http2 -v 看 ALPN 是否协商为 h2;HTTP/3 需要 curl 8.x 且编译时启用 HTTP/3(如 --with-ngtcp2),命令为 curl --http3 -v https://example.com,否则会报 curl: option --http3: is unknown。最直观的办法仍是浏览器 DevTools → Network → 右键打开 Protocol 列,看到 h3 即说明 Alt-Svc 生效并已切换到 QUIC。

TCP 三次握手 1 个 RTT,加上 TLS 1.3 的 1 个 RTT,共 2 个 RTT 就能发出第一个 HTTP 请求。TLS 1.3 把密钥交换所需的 key_share 直接放进 ClientHello,服务端在 ServerHello 中一次回完,因此比 TLS 1.2 的 2-RTT 少一个往返。

不是。证书中的公钥只用于验证服务器签名(CertificateVerify),以及在 TLS 1.2 的 RSA 密钥交换中加密预主密钥。实际网页数据由握手协商出的对称密钥以 AES-GCM 或 ChaCha20-Poly1305 加密,因为对称加密比非对称快几个数量级。

一样。两者都能签发 ECDSA P-256 或 RSA 2048/4096 证书,TLS 握手与数据加密强度完全相同。差别在身份审核(DV 只验证域名控制权,OV 需核验企业营业执照)、有效期(免费 90 天 vs 付费 1 年)、赔付保障与技术支持。

这说明服务器没发送中间证书。把中间证书按“叶子证书 → 中间证书”的顺序拼成 fullchain.pem,Nginx 用 ssl_certificate fullchain.pem 加载,然后用 openssl verify -CAfile ca-certificates.crt -untrusted intermediate.crt example.com.crt 复验,应输出 OK。

因为 TLS 1.3 套件(TLS_AES_128_GCM_SHA256 等)不走 ssl_ciphers 指令,Nginx 从 1.19.4 起要用 ssl_conf_command Ciphersuites …; 配置。若写了不存在的套件名,nginx -t 会直接报 no ciphers available。

先确认协议与套件是否有交集:用 openssl s_client -connect 域名:443 -tls1_2 与 -tls1_3 分别试,提示 no protocols available 就是服务端没开该版本。再看 ssl_ciphers 是否把客户端支持的套件全排除,最后用 -servername 指定域名,避免命中默认 server 的错误证书。

不建议立刻关。TLS 1.3 在主流浏览器支持率已超 95%,但部分老旧 Android WebView、Java 8 客户端与 IoT 设备仍只支持 TLS 1.2。折中做法是保留 TLS 1.2,但禁用 CBC 与 RSA 密钥交换,只保留 ECDHE + AEAD 套件。


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

内容审核

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