怎么配置 Nginx 记录 HTTPS 连接的具体参数（SSL 日志）-Nginx-PHP中文网

nginx 可通过 $ssl_protocol、$ssl_cipher、$ssl_server_name 等变量在 access_log 中记录 tls 版本、加密套件、sni 域名等握手关键信息，需在 listen 443 ssl 的 server 块中配置自定义 log_format 并启用 access_log，且确保编译包含 ssl 模块。

怎么配置 nginx 记录 https 连接的具体参数（ssl 日志）

Nginx 本身不直接提供“SSL 握手详情日志”（比如 TLS 版本、协商的 cipher suite、SNI 域名、证书序列号等）的内置字段，但可以通过组合标准日志变量 + SSL 相关模块变量，记录 HTTPS 连接的关键安全参数。这需要启用 ngx_http_ssl_module（已默认包含），并正确配置 log_format 和 access_log。

以下是实用、可落地的配置方式：

启用 SSL 相关日志变量

Nginx 提供了多个 `$ssl_*` 变量，仅在 `listen 443 ssl;` 的 server 块中有效。常用且稳定的有：

$ssl_protocol：实际协商的 TLS 协议版本，如 TLSv1.2 或 TLSv1.3
$ssl_cipher：客户端与服务器最终选用的加密套件，如 ECDHE-ECDSA-AES128-GCM-SHA256
$ssl_session_reused：会话是否复用，值为 r（reused）或 .（未复用）
$ssl_server_name：客户端通过 SNI 发送的域名（需开启 `ssl_sni on;`，默认已开）
$ssl_client_verify：若启用了双向认证，显示 SUCCESS/FAILED（非必需）

定义带 SSL 信息的自定义日志格式

在 `http{}` 块中添加：

log_format ssl_ext '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent '  
' "$http_referer" "$http_user_agent" '  
' $ssl_protocol/$ssl_cipher "$ssl_server_name" $ssl_session_reused';

然后在 HTTPS 的 `server{}` 块中启用：

access_log /var/log/nginx/ssl_access.log ssl_ext;

注意：该日志格式只对 HTTPS 请求生效；HTTP 请求因无 SSL 上下文，对应变量值为空或“-”。