ssl_dhparam指令必须手动生成并配置，因Nginx不内置DH参数，复用他人文件或使用1024位默认值会削弱前向保密性、易遭Logjam攻击；推荐用openssl dhparam -out dhparam.pem 3072生成PEM格式参数，并在server块中正确引用。
ssl_dhparam 是 Nginx 中启用强 Diffie-Hellman（DH）密钥交换的关键指令。它不提供加密本身，而是为 DHE 类 TLS 密码套件提供安全的参数基础——没有它，Nginx 可能退回到 1024 位甚至更弱的默认 DH 组，极易被 Logjam 等攻击破解。配置这一步看似简单，但生成方式、位长选择和加载位置稍有偏差，前向保密性就形同虚设。
为什么必须手动生成 DH 参数
Nginx 1.11.0 起不再内置 DH 参数；若未设置 ssl_dhparam，会依赖 OpenSSL 或系统提供的默认值，而这些常为 1024 位（已可被国家级算力离线分解）。即使你主要用 ECDHE，仍需提供强 DH 参数——因为旧版 Java、某些 IoT 设备、嵌入式客户端仍可能协商传统 DHE 套件。复用网上下载的 dhparam.pem 文件同样危险：所有服务器共用同一组 p/g 参数，会削弱前向保密性，相当于共享“密钥交换底座”。
生成高强度 DH 参数文件的正确方法
使用 OpenSSL 命令行生成，注意避开常见误区：
- 用 openssl dhparam -out /etc/nginx/dhparam.pem 2048 —— 推荐起点，兼顾安全性与握手性能
- 对金融、政务等高敏场景，用 openssl dhparam -out /etc/nginx/dhparam.pem 3072 —— 抵御更长期的算力进步
- 绝对不要加
-dsaparam参数（如openssl dhparam -dsaparam ...），它生成的是 DSA 兼容参数，不适用于标准 DH 密钥交换，会导致部分客户端握手失败 - 生成过程耗时（2048 位通常数秒至一分钟，3072 位可达数分钟），建议在维护窗口提前执行，或后台运行：
nohup openssl dhparam -out /etc/nginx/dhparam.pem 2048 &
Nginx 配置中正确加载 ssl_dhparam
该指令必须出现在启用 SSL 的 server 块内，且顺序和权限不可忽视：
- 放在
ssl_certificate和ssl_certificate_key之后，避免因路径错误导致启动失败 - 推荐写在 server 块内（而非 http 块），便于按域名/站点差异化管理
- 确保文件权限严格：
chmod 600 /etc/nginx/dhparam.pem，并确认 nginx worker 进程用户（如 www-data 或 nginx）可读 - 典型配置片段如下：
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_dhparam /etc/nginx/dhparam.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:...;
验证是否生效与常见问题
配置完成后，务必验证实际效果：
- 重载 Nginx：
nginx -t && systemctl reload nginx，勿仅 restart - 用在线工具如 SSL Labs Test 检查报告中的 “Key Exchange” 项，确认显示 “DHE 2048 bits” 或更高，且无 “Weak key exchange” 提示
- 命令行快速验证：
openssl s_client -connect example.com:443 -cipher 'DHE' 2>/dev/null | grep "Server Temp Key"，应输出类似Server Temp Key: DH, 2048 bits - 若出现
SSL_CTX_use_DH_PrivateKey_file failed错误，通常是路径错、权限不足，或文件内容被意外修改（如开头多了空格或 BOM）
