已知问题
该模块为实验性的。
在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”,其他的为空。