nginx中文文档-ngx_http_v2_module

此页面版本:2016-06-08
ngx_http_v2_module模块(1.9.5+)提供了HTTP2协议的支持,并取代ngx_http_spdy_module模块。该模块默认不会构建,需要通过–with-http_v2_module参数启用。

已知问题
该模块为实验性的。
在1.9.14版本以前,客户端请求体的缓冲区不能够禁用,不管proxy_request_buffering, fastcgi_request_buffering, uwsgi_request_buffering 和 scgi_request_buffering指令的值。

示例配置

server {
    listen 443 ssl http2;

    ssl_certificate server.crt;
    ssl_certificate_key server.key;
}

注意接受TLS上的HTTP2连接需要“Application-Layer Protocol Negotiation”(ALPN)TLS扩展支持,仅从OpenSSL1.0.2版本开始可用。使用“Next Protocol Negotiation”(NPN)TLS扩展(从OpenSSL1.0.1版本可用)的不能保证。
还要注意,如果ssl_prefer_server_ciphers指令设置的值为“on”,加密算法需要遵从RFC7540 附录A黑名单,并受客户端支持。

http2_chunk_size

语法:http2_chunk_size size
默认:http2_chunk_size 8k
上下文:http, server, location

设置响应体被分割的最大块大小。过小的值会导致更高的负荷。太高的值由于排头阻塞对优化有害。

http2_body_preread_size

语法:http2_body_preread_size size
默认:http2_body_preread_size 64k;
上下文:http, server
版本:1.11.0+

设置每一个请求的缓冲区大小,请求体在开始处理前可以保存到缓冲区中

http2_idle_timeout

语法:http2_idle_timeout time
默认:http2_idle_timeout 3m
上下文:http, server

设置非活跃的超时时间,过了这个时间后连接将被关闭。

http2_max_concurrent_streams

语法:http2_max_concurrent_streams number
默认:http2_max_concurrent_streams 128
上下文:http, server

设置一个连接中同时传输HTTP2流的最大数。

http2_max_field_size

语法:http2_max_field_size size
默认:http2_max_field_size 4k
上下文:http, server

限制HPACK压缩请求头域的最大大小。限制应用于名字和值。注意如果使用哈夫曼编码,实际的解压的名字和值的字符串大小可能更大。对于大多数请求,默认的限制是足够的。

http2_max_header_size

语法:http2_max_header_size size
默认:http2_max_header_size 16k
上下文:http, server

限制在HPACK解压后完整的请求头列表的最大大小。对于大多数请求来说,默认的限制是足够的。

http2_recv_buffer_size

语法:http2_recv_buffer_size size
默认:http2_recv_buffer_size 256k
上下文:http

设置接收缓冲区的大小。

http2_recv_timeout

语法:http2_recv_timeout time
默认:http2_recv_timeout 30s
上下文:http, server

为希望从客户端收到更多数据设置超时时间,超过这个时间之后连接将关闭。

内嵌变量
ngx_http_v2_module模块支持以下内嵌变量:

$http2
协商协议标识符:TLS上的HTTP2为“h2”,明文TCP的HTTP2为“h2c”,其他的为空。