$ssl_client_v_start

$ssl_client_v_start 返回在 SSL 握手完成并建立客户端连接时的时间戳。 — NGINX Core (HTTP)

$ssl_client_v_start NGINX Core (HTTP)

说明

变量 $ssl_client_v_start 是 NGINX 对 SSL/TLS 的支持的一部分,对于记录和调试非常有用。它捕获 SSL 握手的开始时间,更精确地说是客户端和服务器之间 SSL 连接完全建立的时间。此时间戳以自纪元(1970 年 1 月 1 日)以来的秒数表示。 该变量在请求处理期间一旦建立 SSL 连接就会变得可用。可以在请求的上下文中访问 $ssl_client_v_start 的值,从而允许 NGINX 记录该事件发生的精确时刻。了解 SSL 连接的开始时间可以帮助开发人员和系统管理员进行性能监控,因为它有助于理解 SSL 握手的持续时间并排查任何相关的延迟问题。该变量的典型值将以 UNIX 时间戳的形式出现,例如 '1672531199'。

配置示例

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/ssl/certs/example.com.crt;
    ssl_certificate_key /etc/ssl/private/example.com.key;

    access_log /var/log/nginx/access.log combined;

    location / {
        add_header X-SSL-Client-V-Start "$ssl_client_v_start";
    }
}

子系统

http

可缓存

上下文

http, server, location, if

该变量仅在启用 SSL 的请求上下文中可用。请确保在 server block 中已为 SSL 配置并启用。

如果连接在 SSL 握手完成之前失败,则该变量不会被设置。