必须手动配置 ssl_dhparam,否则 Nginx 会使用不安全的默认 DH 参数(多为1024位),导致前向保密失效;自1.11.0起已移除内置参数,且复用他人 dhparam.pem 会削弱整体安全性;推荐生成3072位参数,避免4096位和-dsaparam;需正确加载并严格权限控制,最后通过命令和SSL Labs验证。

必须手动配置 ssl_dhparam,否则 Nginx 会回退到系统或 OpenSSL 提供的默认 DH 参数——多数仍是不安全的 1024 位,已可被离线分解,前向保密形同虚设。即使你主用 ECDHE,旧版 Java、Android、IoT 设备等仍可能协商 DHE 套件,此时若无强 DH 参数,整条链路暴露于 Logjam 类降级攻击之下。
为什么不能跳过 ssl_dhparam 配置
自 Nginx 1.11.0 起已移除内置 DH 参数。未显式设置时,实际加载的是系统级默认值,而非“无参数”。这些默认值往往来自老旧 OpenSSL 版本,长期未更新,存在已知弱参数风险。更关键的是:复用他人生成的 dhparam.pem(比如网上下载的固定 2048 位文件)等于共享密钥交换的“地基”——所有使用同一组素数 p 和生成元 g 的服务器,前向保密性被整体削弱,攻击者一次预计算即可批量破解。
生成安全可用的 DH 参数文件
- 推荐执行:
openssl dhparam -out /etc/nginx/ssl/dhparam.pem 3072——3072 位是当前安全与性能的最优平衡点,抗算力升级能力更强,生成耗时通常在 1–3 分钟 - 资源受限环境可用 2048 位:
openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048,仍满足 PCI DSS、等保 2.0 等主流合规要求 - 绝对避免 4096 位:生成时间极长(数小时),Nginx 加载时易触发超时,且安全增益微乎其微
- 严禁加
-dsaparam参数:它生成的是 DSA 兼容参数,不适用于标准 DH 密钥交换,会导致部分客户端(如 Android 4.x、OpenSSL 1.0.x)握手失败
Nginx 中正确加载与权限控制
- 将
dhparam.pem放入 Nginx 可读目录(如/etc/nginx/ssl/),并设严格权限:chmod 600 /etc/nginx/ssl/dhparam.pem - 指令必须放在启用 SSL 的
server块内,且位于ssl_certificate和ssl_certificate_key之后 - 典型位置示例:
server { listen 443 ssl http2; ssl_certificate /etc/nginx/ssl/example.com.crt; ssl_certificate_key /etc/nginx/ssl/example.com.key; ssl_dhparam /etc/nginx/ssl/dhparam.pem; # 就放这里 ... } - 不建议统一写在
http块顶层,除非所有 HTTPS 站点共用同一份参数;按域名差异化管理更稳妥
验证是否生效及参数强度
- 检查文件格式与长度:
openssl dhparam -in /etc/nginx/ssl/dhparam.pem -text -noout | grep "Prime:",确认输出中P:后为 3072 或 2048 位 - 终端直连测试:
openssl s_client -connect example.com:443 -cipher 'EDH' 2>/dev/null | grep "Server Temp Key",应显示类似Server Temp Key: DH, 3072 bits - 用 SSL Labs(ssllabs.com)扫描域名,在 “Key Exchange” 栏确认显示 “DH 3072” 且标注 “Forward Secrecy: Yes”
- 配置后务必执行
nginx -t测试语法,再nginx -s reload生效


















