1. 课程导入与开发环境搭建

OpenSSL 长期以来是 TLS、证书与通用密码运算的事实标准库。随着 NIST 后量子密码标准（FIPS 203 ML-KEM、FIPS 204 ML-DSA、FIPS 205 SLH-DSA）落地，OpenSSL 3.5 起在主干中引入了后量子算法支持，并通过编译开关控制其是否进入构建产物。本课程的目标不是泛泛介绍 PQC 理论，而是围绕 OpenSSL 的 Provider 架构与 EVP 接口，把“如何调用后量子算法、如何与现有密钥体系共存、如何验证与排障”讲透。学完后你应当能够：独立编译出带 PQC 能力的 OpenSSL；用 EVP_PKEY 接口完成 ML-KEM 密钥封装与 ML-DSA 签名验签；理解算法名、参数集与 Provider 加载之间的关系；并能定位“算法找不到”“Provider 未加载”这类典型问题。

学习路径按“环境 → 接口 → 算法 → 工程化”四段推进：先搭好可复现的构建与验证环境，再熟悉 EVP 的通用调用范式，随后分别深入 KEM 与签名两类算法，最后进入证书、TLS 集成与性能评估。本节只解决第一段——把地基打牢。需要强调的是，后量子接口在 OpenSSL 中并非独立 API，而是复用 EVP_PKEY 抽象，因此环境搭建的质量直接决定后续所有实验能否复现。

先看清整体结构：源码、构建与运行时

下图把本节涉及的关键对象串起来：左侧是获取与配置阶段，中间是编译产物，右侧是运行时通过 Provider 暴露算法能力的路径。理解这条链路，后面的命令才有归属感。

源码获取与依赖准备

建议直接使用官方 Git 仓库，便于切换分支与查看提交记录。后量子算法在 3.5 及以后版本才较完整，因此不要停留在 3.0/3.2 分支上做实验。

git clone https://github.com/openssl/openssl.git
cd openssl
git checkout openssl-3.5   # 示例分支名，实际以官方标签为准

OpenSSL 的构建系统由 Perl 驱动，因此 perl 是硬依赖；此外需要 C 编译器、make，若要用到 TLS 测试还需 python3。在 Debian/Ubuntu 上可一次性安装：

sudo apt-get update
sudo apt-get install -y build-essential perl python3 git

若计划启用 enable-fips 或做国密/硬件加速实验，还需额外准备对应模块，但本节先保持最小依赖，避免把环境问题与算法问题混在一起。

配置编译选项：enable-pqc 到底做了什么

配置阶段最关键的一步是 ./Configure。后量子算法默认可能未全部启用，需要显式打开 enable-pqc。一个可复现的示例配置如下（安装到独立前缀，避免污染系统 OpenSSL）：

./Configure --prefix=/opt/openssl-pqc \
  enable-pqc \
  no-shared \
  --openssldir=/opt/openssl-pqc/ssl
make -j$(nproc)
sudo make install

这里几个选项值得解释：--prefix 决定安装位置，后续所有命令都应指向该目录下的 bin/openssl；no-shared 生成静态库，便于在容器或隔离环境中复现，若你需要动态加载 Provider 则改用默认共享构建；--openssldir 指定配置与证书目录，运行时 openssl.cnf 从这里读取。执行 ./Configure 后终端会打印一份摘要，务必确认其中出现 PQC 相关条目，否则说明开关未生效。

验证开发环境是否真正可用

安装完成后不要急着写代码，先用命令行做三层验证。第一层看版本与 Provider：

/opt/openssl-pqc/bin/openssl version -a
/opt/openssl-pqc/bin/openssl list -providers

输出中应能看到 default Provider 处于 active 状态。第二层查算法是否注册：

/opt/openssl-pqc/bin/openssl list -kem-algorithms | grep -i mlkem
/opt/openssl-pqc/bin/openssl list -signature-algorithms | grep -i mldsa

若能看到 ML-KEM-768、ML-DSA-65 之类的名称，说明编译开关与 Provider 注册都正常。第三层做一次最小功能验证，例如生成一个 ML-DSA 密钥并签名：

/opt/openssl-pqc/bin/openssl genpkey -algorithm ML-DSA-65 -out mldsa.key
echo "pqc smoke test" > msg.txt
/opt/openssl-pqc/bin/openssl pkeyutl -sign -inkey mldsa.key \
  -in msg.txt -out msg.sig
/opt/openssl-pqc/bin/openssl pkeyutl -verify -inkey mldsa.key \
  -in msg.txt -sigfile msg.sig

最后一行输出 Signature Verified Successfully 即表示环境闭环成立。注意：以上命令与输出属于教学示例，实际算法名与可用选项请以你所构建版本的 openssl list 结果为准。

常见环境问题与判断依据

实践中最高频的失败不是编译错误，而是“命令跑的是系统旧版 OpenSSL”。判断方法很简单：用 which openssl 与 openssl version 对照，若路径不是 /opt/openssl-pqc/bin，说明 PATH 未生效。其次是“算法找不到”，此时先看 list -providers 是否加载了 default，再看 openssl.cnf 中是否误将 Provider 设为非激活。第三类是链接期问题：编译自己的 C 程序时若头文件与库来自不同前缀，会出现符号缺失，应统一使用 -I/opt/openssl-pqc/include -L/opt/openssl-pqc/lib 并配合 LD_LIBRARY_PATH。