模块 ngx_http_v2_module

ngx_http_v2_module 模块 (1.9.5) 提供了对 HTTP/2 的支持。

此模块默认情况下不构建，应使用 --with-http_v2_module 配置参数启用它。

在 1.9.14 版本之前，无论 proxy_request_buffering、fastcgi_request_buffering、uwsgi_request_buffering 和 scgi_request_buffering 指令值如何，都无法禁用客户端请求正文的缓冲。

在 1.19.1 版本之前，lingering_close 机制未使用在控制关闭 HTTP/2 连接中。

server {
    listen 443 ssl;

    http2 on;

    ssl_certificate server.crt;
    ssl_certificate_key server.key;
}

请注意，通过 TLS 接受 HTTP/2 连接需要“应用程序层协议协商”(ALPN) TLS 扩展支持，该支持自 OpenSSL 1.0.2 版本起可用。

另请注意，如果 ssl_prefer_server_ciphers 指令设置为值“on”，则应配置 ciphers 以符合 RFC 9113，附录 A 黑名单，并受客户端支持。

http2 off;

启用 HTTP/2 协议。

http2_body_preread_size 64k;

设置每个请求的缓冲区大小，在开始处理请求正文之前，可以将请求正文保存在该缓冲区中。

http2_chunk_size 8k;

设置响应正文被切片后的最大块大小。值过低会导致开销过高。值过高会由于 HOL 阻塞 而损害优先级。

http2_idle_timeout 3m;

该指令自 1.19.7 版本起已过时。应改用 keepalive_timeout 指令。

设置不活动超时时间，在此时间后关闭连接。

http2_max_concurrent_pushes 10;

该指令自 1.25.1 版本起已过时。

限制连接中并发 推送 请求的最大数量。

http2_max_concurrent_streams 128;

设置连接中并发 HTTP/2 流的最大数量。

http2_max_field_size 4k;

该指令自 1.19.7 版本起已过时。应改用 large_client_header_buffers 指令。

限制 HPACK 压缩请求头字段的最大大小。该限制同时适用于名称和值。请注意，如果应用霍夫曼编码，则解压缩的名称和值字符串的实际大小可能会更大。对于大多数请求，默认限制应该足够。

http2_max_header_size 16k;

该指令自 1.19.7 版本起已过时。应改用 large_client_header_buffers 指令。

限制 HPACK 解压缩后整个请求头列表的最大大小。对于大多数请求，默认限制应该足够。

http2_max_requests 1000;

该指令自 1.19.7 版本起已过时。应改用 keepalive_requests 指令。

设置可通过一个 HTTP/2 连接处理的请求（包括 推送 请求）的最大数量，在此数量之后，下一个客户端请求将导致连接关闭，需要建立新连接。

定期关闭连接对于释放每个连接的内存分配是必要的。因此，使用过高的最大请求数量可能会导致过多的内存使用，不建议这样做。

http2_push off;

该指令自 1.25.1 版本起已过时。

预先发送 (推送) 请求到指定的 uri，同时发送对原始请求的响应。仅处理具有绝对路径的相对 URI，例如

http2_push /static/css/main.css;

uri 值可以包含变量。

可以在同一配置级别上指定多个 http2_push 指令。off 参数会取消从前一个配置级别继承的 http2_push 指令的效果。

http2_push_preload off;

该指令自 1.25.1 版本起已过时。

启用自动转换“链接”响应头字段中指定的 预加载链接 为 推送 请求。

http2_recv_buffer_size 256k;

设置每个 工作进程 输入缓冲区的大小。

http2_recv_timeout 30s;

此指令自 1.19.7 版本起已过时。应改用 client_header_timeout 指令。

设置从客户端接收更多数据的超时时间，超时后关闭连接。

ngx_http_v2_module 模块支持以下嵌入式变量

$http2

协商的协议标识符：“h2”表示通过 TLS 的 HTTP/2，“h2c”表示通过明文 TCP 的 HTTP/2，否则为空字符串。