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 及以上)。
- 确认命令行与业务进程用的是同一份库。版本不一致是“命令行验证通过、线上仍报错”的头号原因——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'
- 生成私钥与 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)不支持 |
- 自检 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
- 拉取线上证书链并核对有效期。注意
-servername必带,否则 SNI 站点会拿到默认站点的证书;日期为 UTC。
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates
- 独立验证链是否完整。把叶证书存为 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(缺中间证书)
- 测协议版本与套件。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' # 列出本机可用套件
- 纳入监控,提前 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。