密码学与证书 / 知识点

OpenSSL 证书操作手册

手册条目

确认当前 OpenSSL 版本、构建参数、配置目录和可用能力。

检查 OpenSSL 版本

用于确认当前命令行实际调用的 OpenSSL、命令与库版本是否一致,以及编译平台、默认配置目录和模块目录。排查“本机支持、目标机不支持”、配置未生效或同名命令冲突时,先执行本条目。

命令定位

先确认 PATH 中命中的可执行文件,再查看完整构建信息。command -v 适用于常见 POSIX Shell;脚本中不要只记录版本号,否则容易漏掉多版本并存问题。

bash
command -v openssl
openssl version -a

预期输出

text
/usr/bin/openssl
OpenSSL <VERSION> <DATE> (Library: OpenSSL <VERSION> <DATE>)
built on: <BUILD_TIME>
platform: <PLATFORM>
options: <BUILD_OPTIONS>
OPENSSLDIR: "<OPENSSL_CONFIG_DIR>"
ENGINESDIR: "<ENGINE_DIR>"
MODULESDIR: "<MODULE_DIR>"
Seeding source: os-specific

第一行是实际执行路径;首行中的 OpenSSL 表示命令版本,括号内 Library 表示运行时库版本。两者不一致时,优先怀疑 PATH、动态库搜索路径或容器挂载导致混用。不同发行版可能省略部分字段。

高频用法

只看简短版本、默认配置目录,以及 OpenSSL 3.x 已加载的 provider,可使用:

bash
openssl version
openssl version -d
openssl list -providers

预期输出

text
OpenSSL <VERSION> <DATE>
OPENSSLDIR: "<OPENSSL_CONFIG_DIR>"
Providers:
  default
    name: OpenSSL Default Provider
    version: <VERSION>
    status: active

openssl version -d 输出的目录通常包含或指向 openssl.cnf。openssl list -providers 主要用于 OpenSSL 3.x;若返回未知选项,说明当前版本较旧,应改查版本和发行版文档,不要据此判断安装损坏。

常用参数

-a 显示版本、构建时间、平台、编译选项和目录;-v 仅显示版本;-d 显示默认配置目录;-e 显示 engines 目录;-m 显示 provider modules 目录。部分目录参数仅在相应版本或构建中可用。

风险与边界

版本输出只能证明当前进程加载到的 OpenSSL,不能证明应用程序一定使用同一套库。触发条件是应用静态链接、使用语言运行时自带 TLS 库,或服务进程拥有不同环境变量;后果是命令行测试正常而应用仍失败。安全替代方案是同时检查应用依赖、服务环境和实际握手日志。

不要把“版本较新”直接等同于“算法可用”。OpenSSL 3.x 的旧算法可能位于 legacy provider,FIPS 环境还会进一步限制能力。应通过 openssl list 查询算法,并在目标服务相同配置下验证。

排障清单

  • openssl: command not found:检查软件包是否安装,并确认 PATH;不要随意创建指向未知二进制的软链接。
  • 路径与预期不符:使用 type -a openssl 枚举同名命令,清理 Shell 缓存后重试。
  • 命令版与 Library 版不一致:检查 LD_LIBRARY_PATH、DYLD_LIBRARY_PATH、容器挂载和自定义安装目录。
  • 配置疑似未加载:核对 OPENSSL_CONF 与 OPENSSLDIR,再用目标命令验证 provider 或算法是否可见。

兼容性

Linux、macOS 和类 Unix 系统可直接使用以上命令。Windows PowerShell 用 Get-Command openssl 定位程序;系统自带的 LibreSSL、BoringSSL 工具或厂商裁剪版本,其字段和子命令可能与 OpenSSL 不完全一致。

目录与阅读设置

记录一个想法

OpenSSL 证书操作手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通