跳到主要内容
基础知识

openssl 是什么?一文讲清 OpenSSL 版本、命令与证书链排查

openssl 是什么 — openssl 是什么?一文讲清 OpenSSL 版本、命令与证书链排查
核心结论

openssl 是一个用 C 写的开源密码学工具库与同名命令行程序,包含 libcrypto(算法)和 libssl(TLS 协议实现)两个核心库;Nginx、Apache、PHP 的 HTTPS 能力都链接它。 先用 openssl version -a 确认版本:1.1.1 系列已于 2023-09-11 结束支持,3.0 LTS 支持到 2026-09-07,3.5 LTS(2025-04-08 发布)支持到 2030-04-08。 验证证书链最快的一条命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,看结尾是否为 Verify return code: 0 (ok)。 OpenSSL 3.0 起错误串省略函数名(如 error:0A000086:SSL routines::certificate verify failed),沿用 1.1.1 的 grep 规则会漏掉日志。 3.0 引入 Provider 机制,MD4、RC4、DES 移入 legacy provider,需显式加载,否则报 unsupported algorithm。

openssl 是什么:一句话定义与它在 HTTPS 握手里的真实位置

openssl 是什么?一句话定义:它是一套用 C 语言写的开源密码学工具集,同时以两种形态存在——一是库(别的程序链接进去、在后台完成加解密和 TLS 握手),二是命令行工具(你手动调用、用来复现和排查问题)。搞清这两者的关系,是理解后面所有命令的前提。

库:libcrypto 和 libssl 的分工

  • libcrypto:纯算法层,负责 AES-GCM、RSA、ECDSA、SHA-256、随机数生成等,与网络无关。
  • libssl:协议层,实现 TLS 1.2 / TLS 1.3 握手状态机、会话恢复、SNI 处理,底层调用 libcrypto 完成具体运算。

版本与许可证(合规扫描必看)

分支 首个版本发布日 当前状态 许可证
3.5.x 2025-04-08 LTS,官方支持至 2030-04-08 Apache License 2.0
3.0.x 2021-09-07 LTS,支持至 2026-09-07 Apache License 2.0
1.1.1 2018-09-11 已于 2023-09-11 EOL,不再修 CVE OpenSSL License + SSLeay License 双许可

据 OpenSSL 官方发布说明(openssl.org/news/changelog.html),3.0.0 于 2021-09-07 发布时正式切换到 Apache-2.0,这是企业开源合规扫描结论翻转的关键分水岭:1.1.1 时代需要单独审查 SSLeay 的广告条款,3.x 则与 Apache 生态通用。截至 2025 年,稳定分支为 3.5.x。

它在 HTTPS 链路里的真实位置

以 Nginx 为例,HTTPS 并不是 Nginx 自己实现的,而是链接了 libssl:

# 1) 确认 Nginx 进程实际链接的是哪个 libssl(而不是 openssl 命令行的版本)
ldd $(which nginx) | grep ssl
# 典型输出:
#   libssl.so.3 => /lib/x86_64-linux-gnu/libssl.so.3 (0x00007f2c1a2b3000)
#   libcrypto.so.3 => /lib/x86_64-linux-gnu/libcrypto.so.3 (0x00007f2c19f11000)

# 2) 查看命令行工具自身的版本、编译日期与平台
openssl version -a
# OpenSSL 3.5.0 8 Apr 2025 (Library: OpenSSL 3.5.0 8 Apr 2025)
# built on: Tue Apr  8 12:00:00 2025 UTC
# platform: linux-x86_64

# 3) 用命令行复现一次 TLS 1.3 握手(相当于"离线的浏览器")
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

第 1 步和第 2 步的版本号经常不一致——这是运维里最常见的坑:命令行升级了,但 Nginx 仍加载旧版 libssl.so.1.1,漏洞扫描器报的却是命令行的版本。

为什么它复现的结论可信?因为 TLS 握手必须协商协议版本、密码套件(如 TLS_AES_256_GCM_SHA384)、校验证书链有效期与签名,这些逻辑全部封装在 libssl 内部。命令行只是把同一套 API 暴露出来,所以证书过期、缺中间证书、SECLEVEL 过严导致的握手失败,用 openssl 复现的结果与浏览器高度一致。

它实现的标准:RFC 8446(TLS 1.3)、RFC 5246(TLS 1.2)、RFC 5280(X.509 证书路径校验)、RFC 6960(OCSP)、RFC 2986(PKCS#10 CSR)。正因如此,openssl verify 的返回值可以直接当作证书链是否合法的判据,而不用等浏览器弹窗。

一个高频误解:openssl 不是 CA,也不是 ACME 客户端。它能生成私钥、CSR、自签证书并做验证,但公网可信证书仍须向 Let’s Encrypt、DigiCert、Sectigo 等 CA 申请——据 Let’s Encrypt 文档,签发走的是 ACME 协议,certbot 之类的客户端才会调用 openssl 生成 CSR,两者角色不能混为一谈。

openssl 是什么版本在跑:1.1.1、3.0 LTS 与 3.5 LTS 的差异决定你看到的报错

同一张证书,A 机器握手成功,B 机器报 certificate verify failed——十有八九不是证书的问题,而是两台机器跑的 OpenSSL 不是同一个版本。据 OpenSSL 官方 Release Strategy 文档,3.0 之后的每个大版本生命周期差异很大,而 3.0 起默认只加载 default provider,算法可用性和报错格式都变了。所以在排查任何 TLS 问题之前,先确认”openssl 是什么版本在跑”。

怎么一次看全版本信息?用 -a,别只用 openssl version:

# 记录全部字段,built on / platform / OPENSSLDIR 三行在排障时最有用
$ openssl version -a
OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
built on: Tue Aug 20 13:00:00 2024 UTC
platform: debian-amd64
options:  bn(64,64)
compiler: gcc -fPIC -pthread -m64 ...
OPENSSLDIR: "/usr/lib/ssl"          # 配置文件根目录,openssl.cnf 在此
ENGINESDIR: "/usr/lib/x86_64-linux-gnu/engines-3"
MODULESDIR: "/usr/lib/x86_64-linux-gnu/ossl-modules"   # provider 模块目录
Seeding source: os-specific

# 只想确认配置目录(脚本里常用)
$ openssl version -d
OPENSSLDIR: "/usr/lib/ssl"

你用的版本还在维护吗?规划升级窗口时按下面这张表核对(数据源:openssl.org 的 Release Strategy 与各版本发布公告):

分支 类型 最后版本 / EOL 日期 现状
1.1.1 LTS 1.1.1w,2023-09-11 结束支持 已停止维护,不再发安全补丁
3.0 LTS 2026-09-07 主流发行版主力版本
3.1 非 LTS 2025-03-14 已 EOL
3.2 非 LTS 2025-11-23 临近 EOL
3.3 非 LTS 2026-04-09 维护中
3.5 LTS 2030-04-08 下一个长期支持版本

仍跑 1.1.1 的机器(不少遗留 CentOS 7 / Ubuntu 18.04 镜像)建议把升级排进未来 12 个月的变更窗口,因为非 LTS 分支只有约 13 个月支持期,跳版本时不要停在 3.1/3.2 这类短命分支上。

为什么升级后 MD4、RC4 突然”不支持”了?3.0 用 Provider 架构取代了 Engine 机制,默认只加载 default provider;MD4、RC4、DES、MDC2、RIPEMD160 等被移入 legacy provider。此时命令会直接报 unsupported algorithm 或 unknown cipher。两种启用方式:

# 方式一:命令行临时启用(-provider 顺序敏感,legacy 在前)
openssl dgst -provider legacy -provider default -md4 file.bin

# 方式二:写入配置文件永久启用(路径取自 version -a 的 OPENSSLDIR)
$ sudo vi /usr/lib/ssl/openssl.cnf
# 在文件顶部、openssl_conf 之前加入:
openssl_conf = openssl_init

[openssl_init]
providers = provider_sect

[provider_sect]
default = default_sect
legacy  = legacy_sect

[default_sect]
activate = 1

[legacy_sect]
activate = 1

报错文本变了,你的监控规则会静默失效。1.1.1 里错误串带函数名,3.0 起函数名被省略,改为 8 位十六进制原因码:

# 1.1.1
error:14090086:SSL routines:ssl3_get_server_certificate:certificate verify failed
# 3.0+
error:0A000086:SSL routines::certificate verify failed

如果告警脚本里 grep ssl3_get_server_certificate,升级到 3.0 后规则永远不会命中。建议改为匹配原因码 0A000086 或直接匹配 certificate verify failed。

各发行版自带哪个版本?RHEL 9 与 Ubuntu 22.04 自带 3.0.x,Debian 12 为 3.0.11 以上,Ubuntu 24.04 为 3.0.13。macOS 要注意:系统自带的其实是 LibreSSL(openssl version 显示 LibreSSL 3.3.6),没有 -brief 参数,也不支持 provider 语法,排查证书链必须用 Homebrew 版本:

brew install openssl@3
/opt/homebrew/opt/openssl@3/bin/openssl version -a   # Apple Silicon 路径
# Intel Mac 为 /usr/local/opt/openssl@3/bin/openssl

还有一种”隐形降级”:SECLEVEL。发行版常在 /etc/ssl/openssl.cnf 里写 CipherString = DEFAULT:@SECLEVEL=2,此时 1024 位 RSA 密钥或 SHA-1 签名的证书会直接握手失败(据 Mozilla 服务器端 TLS 配置指南,SECLEVEL=2 要求至少 2048 位 RSA 与 SHA-256)。确认方法:

grep -n CipherString /etc/ssl/openssl.cnf
# 对比安全等级放开前后的套件数量差异,数量明显变多说明当前被 SECLEVEL 收紧
openssl ciphers -v 'DEFAULT'          | wc -l
openssl ciphers -v 'DEFAULT@SECLEVEL=0' | wc -l

排查顺序建议固定为:version -a 确认版本与 OPENSSLDIR → 核对 EOL 表 → grep CipherString 确认安全等级 → 再进入证书链验证(openssl verify -CAfile、s_client -showcerts)。前三步不做,后面的报错很容易被误读成”证书过期”。

搞清 openssl 是什么之后:7 步跑通一次完整的证书生成与检查

把 openssl 是什么 搞明白之后,最有效的巩固方式就是亲手跑一遍完整链路:从确认二进制版本,到生成密钥、签发 CSR、拉取线上证书链、独立验证、测试协议套件,最后接入监控。下面 7 步在 OpenSSL 3.x(Ubuntu 22.04 / Debian 12 自带 3.0.x)上可直接复制执行,1.1.1 亦可(`-addext` 需 1.1.1 及以上)。

  1. 确认命令行与业务进程用的是同一份库。版本不一致是“命令行验证通过、线上仍报错”的头号原因——Nginx 可能链接的是发行版仓库里的 libssl.so.3,而你 PATH 里的 openssl 来自 /usr/local。
openssl version -a          # 记录 OPENSSLDIR、built on、compiler,确认是 3.x 还是 1.1.1
ldd $(which openssl) | grep -E 'libssl|libcrypto'
# 对比 Nginx 加载的库,两者路径必须一致
ldd $(which nginx) | grep -E 'libssl|libcrypto'
  1. 生成私钥与 CSR。RSA 默认 `rsa_keygen_bits` 为 2048;ECDSA 用 `-algorithm EC -pkeyopt ec_paramgen_curve:P-256`,握手包更小。
# RSA 2048
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 或 ECDSA P-256
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out example.com.key

openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
维度 RSA 2048 ECDSA P-256
等效安全强度 约 112 位 约 128 位
公钥/签名长度 256 字节 / 256 字节 64 字节 / 约 70 字节
TLS 1.3 握手流量 较高 更低,移动端更省 RTT
兼容性风险 无 极老客户端(XP/Android 4.x)不支持
  1. 自检 CSR 的 SAN。据 CA/Browser Forum 基线要求与 RFC 5280,CN 已不再作为身份匹配依据,缺少 SAN 时 Chrome 直接报 NET::ERR_CERT_COMMON_NAME_INVALID。
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 期望输出:DNS:example.com, DNS:www.example.com
  1. 拉取线上证书链并核对有效期。注意 -servername 必带,否则 SNI 站点会拿到默认站点的证书;日期为 UTC。
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates
  1. 独立验证链是否完整。把叶证书存为 cert.pem、中间证书存为 chain.pem(根证书不要放进去),只信任系统根库:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem
# 成功:cert.pem: OK
# 典型失败:error 20 at 0 depth lookup: unable to get local issuer certificate(缺中间证书)
  1. 测协议版本与套件。OpenSSL 3.x 默认 MinProtocol=TLSv1.2,TLS 1.3 默认开启;若 -tls1_3 报 no protocols available,说明服务端未启用 1.3 或本地库过旧。
openssl s_client -connect example.com:443 -tls1_2 /dev/null | grep -E 'Protocol|Cipher'
openssl s_client -connect example.com:443 -tls1_3 /dev/null | grep -E 'Protocol|Cipher'
openssl ciphers -v 'ECDHE+AESGCM:ECDHE+CHACHA20'   # 列出本机可用套件
  1. 纳入监控,提前 30 天告警。据 Let’s Encrypt 文档,其证书有效期已缩短至 90 天以内,人工巡检必然漏。
openssl x509 -in cert.pem -noout -enddate      # notAfter=Jun  1 12:00:00 2025 GMT
# Prometheus 侧:blackbox_exporter 的 probe_ssl_earliest_cert_expiry(Unix 时间戳)
# 告警表达式:probe_ssl_earliest_cert_expiry - time() < 2592000   # 30 天

这 7 步覆盖了对称/非对称加密、X.509 证书链、SNI 与 TLS 握手协商这几个核心概念,也是后续排查 unable to get local issuer certificate、证书链顺序错误、TLS 版本不匹配等问题的通用骨架。

openssl 是什么在命令行里的样子:s_client、x509、req、verify 四组高频命令

当你在终端敲下 openssl 时,实际调用的是一个把 TLS 协议栈、X.509 解析器和加密算法库打包在一起的命令行前端。回答”openssl 是什么”最直观的方式,就是看它在命令行里长什么样——下面这四组命令覆盖了日常排障 90% 的场景。

s_client:握手诊断。最常用的一条:

# -brief 需 OpenSSL 3.0+;</dev/null 让 stdin 立即 EOF,避免会话挂住
openssl s_client -connect api.example.com:443 
  -servername api.example.com 
  -tls1_3 
  -brief </dev/null
# 输出仅三行:Protocol version / Ciphersuite / Verification error
# 去掉 -brief 则额外打印整条证书链(Certificate chain)与 Session-ID

-servername 决定 SNI,漏掉它常导致取回默认站点的证书——这是”证书明明换了却还是旧的”最常见原因。

x509:证书解析。

openssl x509 -in fullchain.pem -noout -text          # 全量字段
openssl x509 -in fullchain.pem -noout -dates -subject -issuer 
  -ext subjectAltName                                 # 只看关键项
openssl x509 -in cert.pem -noout -fingerprint -sha256 # SHA256 Fingerprint=3A:...

指纹可与云厂商控制台逐段核对;注意 fullchain.pem 里第一张是叶证书,用 x509 读取时只解析第一张。

req:CSR 与自签。

openssl req -in x.csr -noout -verify -text   # 校验 CSR 自签名;OpenSSL 3.x 默认 SHA256
openssl req -x509 -days 365 -newkey rsa:2048 -nodes 
  -keyout k.pem -out c.pem -subj "/CN=test.internal"  # 内网自签,-nodes 表示私钥不加密

verify 与 OCSP:链验证与吊销检查。

openssl verify -CAfile root.pem -untrusted intermediate.pem cert.pem
# cert.pem: OK 表示链完整;报 "unable to get local issuer certificate" 即缺中间证书

openssl ocsp -issuer intermediate.pem -cert cert.pem 
  -url http://ocsp.digicert.com -resp_text -no_nonce
# 关键行:Cert Status: good(未被吊销)

四组命令的分工与常见误用对比如下:

命令 作用对象 典型输出 常见坑
s_client 在线服务端 协议版本、套件、Verification 忘加 -servername 导致 SNI 缺失
x509 本地证书文件 字段、有效期、SAN、指纹 对链文件只读第一张
req CSR / 自签 签名校验结果、Subject CSR 的 CN 与 SAN 不一致
verify 证书链 OK / 具体错误串 未提供 -untrusted 中间证书

配置文件默认读 $OPENSSLDIR/openssl.cnf:Debian/Ubuntu 为 /usr/lib/ssl/openssl.cnf,RHEL 系为 /etc/pki/tls/openssl.cnf,用 openssl version -d 可确认。临时替换用 -config ./my.cnf 或环境变量 OPENSSL_CONF。容量评估则用 openssl speed -evp aes-256-gcm 看 8192 字节块吞吐,openssl s_time -connect host:443 -www / -new 估算每秒新建握手数——若该值远低于业务峰值 QPS,就该考虑把 TLS 卸载到负载均衡(参见 Mozilla Server Side TLS 指南的推荐配置)。

openssl 是什么、和谁比:OpenSSL、LibreSSL、GnuTLS、BoringSSL 选型对照

openssl 是什么?一句话概括:它既是实现 TLS/SSL 协议与全套密码学原语的 C 库(libssl + libcrypto),也是随库分发的命令行工具。 绝大多数 Linux 发行版把它作为系统默认的 TLS 实现,Nginx、Apache、PHP、PostgreSQL 在编译时都直接链接 libssl。因此,日常遇到的“证书链不完整”“握手失败”问题,根源大多出在 libssl 这一层,而不在命令行工具上。2025 年的主线版本是 OpenSSL 3.5 LTS(2025 年 4 月发布,Apache 2.0 许可,官方支持至 2030 年),完整支持 TLS 1.3,并引入 provider 架构把算法实现与协议实现解耦,这也是 FIPS 合规路径的基础。

几个主流 TLS 实现到底怎么选?

实现 2025 稳定版 许可证 TLS 1.3 ABI / 兼容性 典型使用者
OpenSSL 3.5 LTS Apache 2.0 是 3.x 起稳定 ABI;1.1.1 升级到 3.x 需重新编译 主流 Linux 发行版默认、Nginx、Apache、PHP、PostgreSQL
LibreSSL 3.9.x ISC 是 API 停留在 OpenSSL 1.0.2 分支,无 provider 机制 OpenBSD、macOS 自带
GnuTLS 3.8.x LGPL 2.1 是 独立 API,与 OpenSSL 不兼容 Debian 部分组件、wget
BoringSSL 滚动发布,无版本号 OpenSSL/ISC 混合 是 明确不承诺稳定 ABI Chrome、Android、Envoy
wolfSSL 5.x GPLv2 或商业双许可 是 独立 API,面向小体积 嵌入式、RTOS

选型时的关键判断是:如果你的代码要长期链接某个库,就不能选 BoringSSL,因为它不承诺 ABI 稳定;如果必须通过 FIPS 140-3 认证,就只能使用带 FIPS provider 的 OpenSSL 3.0.x,此时 openssl list -providers 的输出里必须出现 fips 条目;1.1.1 时代的 FIPS 2.0 模块已随 1.1.1 于 2023-09-11 结束支持而退役。

# 确认 FIPS provider 是否已加载(合规场景必查)
# 适用:OpenSSL 3.0.x + openssl-fips-provider 包,默认无 fips 条目
openssl list -providers
# Providers:
#   default
#     name: Default OpenSSL Provider
#   fips
#     name: OpenSSL FIPS Provider
#     version: 3.0.8

排查证书链,用 openssl 命令行就够了吗? 不够,不同工具覆盖的层次不同:

工具 覆盖层次 能看到 看不到
openssl s_client 单次 TLS 握手 完整证书链、协议版本、协商套件 不发 HTTP 请求,不代表真实浏览器行为
curl -vI 真实 HTTP 栈 SNI 是否正确、ALPN 是否协商到 h2 不枚举全部套件
nmap --script ssl-enum-ciphers 协议与套件枚举 每个协议支持的套件及强度评级 不做漏洞复测
testssl.sh --fast 100+ 项检查 废弃协议、已知漏洞、证书链问题 耗时较长
# 1) 离线握手:-servername 必须显式给出,否则缺失 SNI 会拿到默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts &1 | grep -E 'ALPN|subject:|SSL connection'

# 3) 枚举协议与套件(nmap 7.x 自带 ssl-enum-ciphers 脚本)
nmap --script ssl-enum-ciphers -p 443 example.com

# 4) 全量体检(testssl.sh 3.x)
./testssl.sh --fast https://example.com

什么时候不该用 openssl 命令行签发证书? 生产环境应交给 ACME 客户端(certbot 4.x、acme.sh 3.x)。据 Let’s Encrypt 文档,certbot 通过 Python cryptography 库调用 libssl,而不会调用 openssl 可执行文件,所以升级 openssl 命令行工具不影响自动续签,但升级 libssl 会影响——这也是容器里换基础镜像后续签突然失败的高频原因。成本上,Let’s Encrypt DV 证书免费、有效期 90 天;商业 OV 约 600–2000 元/年,EV 约 2000–8000 元/年;OpenSSL 本身不收授权费,企业级支持通常随发行版订阅获得,例如 Ubuntu Pro 对最多 5 台机器免费,超出后按规模年付。

openssl 是什么报错在告诉你什么:6 条真实报错与定位命令

“openssl 是什么”这个搜索词背后,往往是一个人正盯着一行看不懂的报错。OpenSSL 既是命令行工具,也是绝大多数服务端 TLS 的底层密码库;它抛出的错误码形如 error:0A000086:SSL routines::certificate verify failed,前半段是库内部的函数标识,后半段才是人能读懂的结论。读懂它,等于拿到一半排障答案。下面把 6 条高频报错对齐到定位命令,再逐条展开。

报错(OpenSSL 3.x) 1.1.1 旧写法 真实含义 首条定位命令
0A000086 certificate verify failed num=20 unable to get local issuer certificate 链不完整,缺中间证书 s_client -showcerts
0A000086(伴随 num=10) num=10 certificate has expired 证书过期或本机时钟错误 x509 -noout -dates
0A00018E ca md too weak ca md too weak SHA-1 签名或密钥 < 2048 位 x509 -text | grep Signature
0A000126 unexpected eof while reading (3.0 新增) 对端未发 close_notify 就断开 抓包 / 升级服务端
1408F10B wrong version number ssl3_get_record:wrong version number 对端根本不是 TLS curl -v http://host:443
no protocols available unsupported protocol 协议版本被 MinProtocol 禁用 s_client -tls1_1

1. 服务端没下发中间证书。这是最典型的一条:客户端只拿到叶子证书,找不到签发者。先确认服务端到底发了几段证书(正常应 ≥ 2 段),再把中间证书按”叶子在前、中间在后”的顺序拼接,并让 Nginx 指向全链文件。据 Let’s Encrypt 文档,其生成的 fullchain.pem 本身就是拼好的全链,直接引用即可,不必再手工 cat。

# 统计服务端实际下发的证书段数,输出 1 即说明缺中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

# 手工拼接全链:叶子证书在前,中间证书在后
cat cert.pem intermediate.pem > fullchain.pem

# /etc/nginx/nginx.conf 中 server 块
# ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 必须是全链,不能只写 cert.pem
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
nginx -t && nginx -s reload

2. 证书过期。先取 notAfter 再与本机时间比对。RFC 5280 规定证书时间一律为 UTC(GMT 后缀),所以用 date -u 而非 date;容器场景还要注意宿主时钟漂移——偏差一旦越过有效期边界,就会把有效证书判成过期。

openssl x509 -in cert.pem -noout -dates    # 输出 notBefore / notAfter,均为 UTC
date -u                                    # 与本机 UTC 时间直接对比

3. ca md too weak。OpenSSL 1.1.0 起默认 SECLEVEL=2,拒绝 SHA-1 签名与不足 2048 位的 RSA 密钥。确认签名算法后应重签为 SHA-256;把 openssl.cnf 降到 SECLEVEL=1 只是把问题推给下一个客户端,不建议。

openssl x509 -in cert.pem -noout -text | grep -i "Signature Algorithm"
# 输出 sha1WithRSAEncryption 即命中;应重签为 sha256WithRSAEncryption

4. unexpected eof while reading。OpenSSL 3.0 收紧了 EOF 与 close_notify 的处理,旧版 Nginx、Tomcat 未按 RFC 8446 正常关闭连接时就会报这条。Nginx 自 1.23.0 起已修复,升级即可;临时手段是设置 SSL_OP_IGNORE_UNEXPECTED_EOF,但那只是把告警静音。

5. wrong version number。含义不是”版本不对”,而是对端返回的根本不是 TLS 记录——最常见于把 HTTPS 请求打到了 80 端口,或中间有透明代理。用明文 HTTP 直连 443 端口对照即可确认。

curl -v http://host:443          # 若返回 400 Bad Request 或明文 HTTP,说明 443 上跑的是 HTTP
openssl s_client -connect host:443 -state </dev/null   # 观察协议握手阶段在哪一步停住

6. no protocols available。OpenSSL 3.0 的默认 MinProtocol = TLSv1.2,用 -tls1_1 会直接失败而非降级重试。先确认实际加载的配置路径,再检查 [system_default_sect] 下的 MinProtocol 与 CipherString 两行(默认 DEFAULT@SECLEVEL=2)。

openssl version -d                                  # 打印实际使用的 OPENSSLDIR,据此找 openssl.cnf
openssl s_client -connect host:443 -tls1_1 </dev/null   # 复现:no protocols available

# openssl.cnf 片段(3.x 默认值)
# [system_default_sect]
# MinProtocol = TLSv1.2
# CipherString = DEFAULT@SECLEVEL=2

问:我敲的 openssl 和 Nginx 实际加载的 libssl 是同一份吗?系统里同时存在发行版自带、源码编译、conda/brew 安装的多份 libssl 是证书排查翻车的头号原因——命令行验证一切正常,线上进程却用着另一份库。先记录命令行的版本与编译信息,再对照运行中的进程:

# 1) 记录版本、编译日期、库目录;built on 与 OPENSSLDIR 是排障时的基准信息
openssl version -a
# 输出示例:OpenSSL 3.0.13 30 Jan 2024 / built on: ... / OPENSSLDIR: "/usr/lib/ssl"
# OpenSSL 3.x 额外打印 Modules Directory(Provider 动态模块所在路径)

# 2) 看 Nginx worker 真正 mmap 的 libssl 路径(用 worker 而不是 master 更准确)
lsof -p $(pgrep -f 'nginx: worker' | head -1) | grep -E 'libssl|libcrypto'
# 无 lsof 时等价写法
grep -E 'libssl|libcrypto' /proc/$(pgrep -f 'nginx: worker' | head -1)/maps

两者路径不一致,说明 PATH 里的 openssl 是第三方版本(常见于 conda、Homebrew、自编译到 /usr/local),此时所有 s_client 结论都不能直接套用到服务端。用 ldd $(which openssl) | grep -E 'libssl|libcrypto' 可进一步确认命令行自身依赖。

问:改了 openssl.cnf 或 cipher 配置,怎么证明真的生效?看套件数量是最快的量化手段,改动前后各跑一次:

# DEFAULT 是默认 cipherlist 别名;数量变化即说明 cnf/编译选项被读到
openssl ciphers -v 'DEFAULT' | wc -l

# 只保留 TLS1.3 看协商集合(TLS1.3 套件不受 CipherString 控制,需 Ciphersuites 指令)
openssl ciphers -v -s -tls1_3 'DEFAULT'

# OpenSSL 3.x:确认 default 与 legacy Provider 的加载状态
openssl list -providers -verbose
# 期望看到 status: active;legacy 未在 cnf 中 activate 时不会出现

注意发行版差异:Debian/Ubuntu 在 /etc/ssl/openssl.cnf 写入 CipherString = DEFAULT@SECLEVEL=2,而 OpenSSL 库本身默认安全级别为 1(见 SSL_CTX_set_security_level(3) 文档)。升级后配置文件被覆盖回默认,套件数量会突然变多——这恰恰是握手退化的信号,别当成”支持更广”。

问:服务端实际协商出的协议和证书链怎么一眼确认?关键在 -servername(s_client 默认不发 SNI)和 -CAfile(s_client 默认不做链校验,只看 Verify return code):

echo | openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt 2>/dev/null 
  | grep -E "Verify return code|Protocol|Cipher"
# 期望:Verify return code: 0 (ok) / Protocol  : TLSv1.3 / Cipher    : TLS_AES_256_GCM_SHA384
# 常见失败:Verify return code: 20 (unable to get local issuer certificate) → 中间证书缺失
#           Verify return code: 10 (certificate has expired)

问:内部自查够了没有?不够,用三条独立通道交叉验证,全部通过才算收工:

验证层 手段 通过判据 典型失败信号
配置 openssl ciphers -v 'DEFAULT' | wc -l、openssl list -providers -verbose 数量与基线一致、default active 数量骤增/骤减
握手 s_client -servername -CAfile Verify return code: 0、TLSv1.3 code 20 / 10 / 21
外部 Qualys SSL Labs、testssl.sh、curl --tlsv1.3 -sI 评级 A 及以上、无 HIGH 告警、HTTP 200 评级 B、HIGH: CBC ciphers

问:怎么让它变成持续回归而不是一次性检查?用 blackbox_exporter 暴露 TLS 指标,Prometheus 侧写告警规则(单位是秒):

# blackbox.yml:任何带 tls_config 的探测都会输出 probe_ssl_earliest_cert_expiry
modules:
  https_2xx:
    prober: http
    http:
      preferred_ip_protocol: ip4
    tls_config:
      insecure_skip_verify: false

# Prometheus 告警规则
- alert: TLSCertExpiringIn30Days
  expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 30
  for: 10m
  labels: { severity: warning }
# 同时监控协议版本:probe_tls_version_info{version="TLS 1.3"} == 1

问:升级 OpenSSL 3.x 后怎么确认没有性能与兼容退化?跑一次基准并抽查核心域名,-seconds 默认 3 秒,建议对齐到 10 秒降低抖动:

openssl speed -seconds 10 -evp aes-256-gcm
# 关注 8192/16384 bytes 行的 k/sec,与升级前基线比对;跌幅 >10% 需排查 Provider 路径
for h in api.example.com www.example.com static.example.com; do
  echo | openssl s_client -connect $h:443 -servername $h 
    -CAfile /etc/ssl/certs/ca-certificates.crt 2>/dev/null 
    | grep -E "Verify return code|Protocol"
done

据 OpenSSL 3.0 迁移指南,legacy 算法默认移入 legacy Provider,依赖 DES/MD4/RC4 的老系统会出现握手失败,报错形如 no suitable signature algorithm 或 sslv3 alert handshake failure——先确认 openssl list -providers 是否 active,再决定是否在 cnf 中显式加载,而不是直接下调 SECLEVEL。

openssl 是什么之外:它与 ACME、OCSP Stapling、证书链的关系

如果你已经知道 openssl 是什么——一个提供 libcrypto/libssl、附带 openssl 命令行工具的通用密码学库——那么本节要回答的是它在真实运维链路中的位置:它不签发证书,但几乎参与了证书从申请、装订到校验的每一环。

ACME 客户端一定要用 openssl 吗?不一定,但完全可行。Let’s Encrypt 依据 RFC 8555 提供 ACME 接口,客户端既可以让 acme.sh/certbot 自动生成密钥对,也可以先自己出 CSR 再提交:

# 1) 生成私钥与 CSR(-nodes 不加密私钥,便于服务自动加载;CN 已废弃,用 SAN)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 2) 提交给 ACME 客户端(以 certbot 手动模式为例,此处仅走 DNS-01 验证)
certbot certonly --manual --preferred-challenges dns 
  --csr example.com.csr --cert-path ./cert.pem

据 Let’s Encrypt 官方文档,其证书有效期 90 天,官方建议在剩余 30 天时续期,也就是每 60 天左右续一次;这也是为什么生产环境几乎不手工跑上面的命令,而是交给定时任务。

OCSP Stapling 怎么确认真的生效?Nginx 侧需要三行配置,其中 ssl_trusted_certificate 必须是含中间证书的链文件(默认未开启 stapling):

ssl_stapling on;                 # 默认 off
ssl_stapling_verify on;          # 默认 off,校验 OCSP 响应签名
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 用于验证响应的信任链
openssl s_client -connect example.com:443 -status </dev/null 2>/dev/null | grep -A1 "OCSP Response Status"
# 期望输出:OCSP Response Status: successful (0x0)

证书链为什么总有人配错?因为根证书本就在系统信任库里:Debian/Ubuntu 为 /etc/ssl/certs/ca-certificates.crt,RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt。服务端只应下发「叶证书 + 中间证书」,把根证书塞进 fullchain.pem 只会让握手包变大,部分客户端还会因链过长报 unable to get local issuer certificate 之外的干扰错误。

TLS 1.3 的套件列表为什么和 TLS 1.2 对不上?RFC 8446 规定 TLS 1.3 只保留 5 个 AEAD 套件(如 TLS_AES_128_GCM_SHA256),且密钥交换与认证已从套件名中解耦。所以 openssl ciphers -v 里看到的 ECDHE-RSA-AES128-GCM-SHA256 只在 TLS 1.2 生效——排查握手失败时,先确认客户端与服务端协商的是哪一版协议,再查对应列表,否则会白查半天。

格式 典型扩展名 用途 openssl 子命令
PEM .pem/.crt/.key Nginx、Apache、Let’s Encrypt 输出 req / x509
PKCS#12 .pfx/.p12 Windows IIS、Java 应用导入 pkcs12
JKS .jks Tomcat、传统 Java 密钥库 需 keytool 转换
# PEM → PKCS#12(-certfile 附上中间证书)
openssl pkcs12 -export -out a.pfx -inkey key.pem -in cert.pem -certfile chain.pem
# PKCS#12 → PEM(-nodes 导出未加密私钥)
openssl pkcs12 -in a.pfx -nodes -out all.pem
# Java 环境再转 JKS
keytool -importkeystore -srckeystore a.pfx -srcstoretype PKCS12 
  -destkeystore a.jks -deststoretype JKS

还要不要为后量子做准备?要。OpenSSL 3.5 起支持 ML-KEM,可先自查:

openssl list -kem-algorithms | grep -i mlkem   # 3.5+ 可见 ML-KEM-512/768/1024
openssl s_client -connect example.com:443 -groups X25519MLKEM768  # 测试混合密钥交换兼容性

这一步的价值在于提前暴露中间设备不支持新组而导致的握手失败,为 PQC 迁移留出验证窗口,而不是等到浏览器默认启用时才被动响应。

不是。openssl 是密码学库加命令行工具,负责生成密钥、签发 CSR、验证证书链、测试 TLS 握手;证书是由 CA 签发的 X.509 文件。日常说的「OpenSSL 证书」多半指用 openssl 命令生成的自签证书或 CSR,仅适合内网测试,公网仍需 CA 签发。

OpenSSL 3.x 使用 Apache License 2.0,1.1.1 及更早为 OpenSSL/SSLeay 双许可,商业使用不收取授权费,但需保留版权与许可声明。需要 FIPS 140-3 合规或厂商 SLA 时,通常通过 RHEL、Ubuntu Pro 等发行版订阅获得支持,而不是向 OpenSSL 项目直接购买。

常见三种原因:一是没加 -servername,服务端返回了默认站点证书,与浏览器带 SNI 的结果不同;二是 openssl 用了 -CAfile 指定的信任库,而浏览器用系统或企业信任库;三是中间有代理或 CDN 做了证书替换。排查时加 -servername 并显式指定 -CAfile 再比对。

这是服务端没有下发中间证书导致的链不完整。把中间证书与叶证书拼接成 fullchain.pem(cat cert.pem intermediate.pem > fullchain.pem),在 Nginx 的 ssl_certificate 指向该文件后重载,再用 openssl s_client -showcerts 确认返回两段以上证书、verify 结果为 0 (ok)。

面向通用 Linux 服务器与 Nginx、Apache、PHP 生态,选 OpenSSL 3.0 LTS 或 3.5 LTS 兼容性最好、文档最多;OpenBSD 与 macOS 自带 LibreSSL,注意其 API 停留在 1.0.2 分支;GnuTLS 适合 LGPL 许可约束的项目;BoringSSL 无稳定 ABI,只在 Chromium、Envoy 等特定栈中使用。

1.1.1 系列已于 2023-09-11 结束支持,最后一个版本是 1.1.1w,此后不再有安全修复。建议规划升级到 3.0 LTS(EOL 2026-09-07)或 3.5 LTS(支持到 2030-04-08),升级前重点回归 Provider 加载、SECLEVEL、以及错误串格式变化对监控规则的影响。

本地文件用 openssl x509 -in cert.pem -noout -enddate;远程域名用 echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate。要批量监控则接入 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标,提前 30 天告警。


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

内容审核

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