nginx 不存在 $ssl_curves 变量,无法获取客户端支持的椭圆曲线列表;仅 $ssl_curve 提供最终协商使用的单条曲线名称,如 x25519 或 secp256r1。

Nginx 的 $ssl_curves 变量本身并不存在 —— 它不是 Nginx 官方定义的内置变量,也无法直接获取客户端支持的椭圆曲线列表。
这是常见的误解。Nginx 在 TLS 握手过程中确实会协商椭圆曲线(如 secp256r1、x25519),但它**不向日志或变量暴露客户端通告的 curves 列表**,仅在服务端配置中通过 ssl_ecdh_curve 控制服务端首选曲线。客户端发送的 supported_groups 扩展(RFC 8422)内容,Nginx 不解析也不导出为变量。
为什么 $ssl_curves 无法用于日志记录
Nginx 的 SSL 模块基于 OpenSSL(或 BoringSSL)实现,其变量体系只暴露了有限的握手结果信息,例如:
-
$ssl_protocol:协商的 TLS 版本(如 TLSv1.3) -
$ssl_cipher:最终选用的密码套件(如 ECDHE-ECDSA-AES128-GCM-SHA256) -
$ssl_curve:实际协商使用的密钥交换曲线名称(如 X25519 或 secp256r1)—— 注意是单个值,不是客户端偏好的完整列表 -
$ssl_client_fingerprint等需额外模块支持
其中 $ssl_curve 是唯一相关字段,但它反映的是**最终协商结果**,而非客户端原始支持的曲线集合。
替代方案:间接推断客户端曲线偏好
虽然无法直接记录客户端的 supported_groups,但可通过组合日志字段做合理推测:
- 结合
$ssl_protocol和$ssl_cipher判断是否启用 ECDHE 密钥交换 - 用
$ssl_curve反推客户端大概率支持该曲线(例如日志中高频出现X25519,说明大量客户端支持 Curve25519) - 配合 User-Agent 字段识别客户端类型(如 Chrome 110+ 默认优先 X25519;iOS 15+ 支持 X25519;旧 Android 可能仅支持 NIST 曲线)
真正获取客户端 supported_groups 的方法
若必须精确采集客户端通告的椭圆曲线列表,需借助外部工具:
-
抓包分析:用 tcpdump + Wireshark 解析 TLS ClientHello 中的
supported_groups扩展 - 自定义 TLS 代理:如使用 mitmproxy、Bouncy Castle 或 Rust 的 rustls 编写中间层,解析并记录原始扩展
-
OpenSSL s_server 调试模式:临时启用
openssl s_server -debug -msg查看握手细节(不可用于生产日志)
在 Nginx 日志中实用记录建议
可增强默认日志格式,捕获已有可用信息:
log_format detailed_ssl '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_user_agent" "$ssl_protocol" "$ssl_cipher" "$ssl_curve"';
access_log /var/log/nginx/access.log detailed_ssl;
后续可通过日志分析统计 $ssl_curve 分布,辅助评估客户端兼容性,比如发现大量 secp256r1 但极少 X25519,可能意味着老旧设备占比高。
不复杂但容易忽略:Nginx 没有魔法变量,理解它实际暴露什么,比尝试使用不存在的变量更有效。











