summaryrefslogtreecommitdiffhomepage
path: root/README
diff options
context:
space:
mode:
authorRoman Arutyunyan <arut@nginx.com>2023-02-27 14:00:56 +0400
committerRoman Arutyunyan <arut@nginx.com>2023-02-27 14:00:56 +0400
commit815ef96124176baef4e940c4beaec158305b368a (patch)
treeef62d1240eae60059e678eb5801caeffa8f14bba /README
parenta36ebf7e95baebf445b0973bd270bc009b0b0e9a (diff)
downloadnginx-815ef96124176baef4e940c4beaec158305b368a.tar.gz
nginx-815ef96124176baef4e940c4beaec158305b368a.tar.bz2
HTTP/3: "quic" parameter of "listen" directive.
Now "listen" directve has a new "quic" parameter which enables QUIC protocol for the address. Further, to enable HTTP/3, a new directive "http3" is introduced. The hq-interop protocol is enabled by "http3_hq" as before. Now application protocol is chosen by ALPN. Previously used "http3" parameter of "listen" is deprecated.
Diffstat (limited to 'README')
-rw-r--r--README18
1 files changed, 13 insertions, 5 deletions
diff --git a/README b/README
index 33ab94ebd..2e9eb9f0d 100644
--- a/README
+++ b/README
@@ -102,13 +102,13 @@ Experimental QUIC support for nginx
3. Configuration
- The HTTP "listen" directive got a new option "http3" which enables
- HTTP/3 over QUIC on the specified port.
+ The HTTP "listen" directive got a new option "quic" which enables
+ QUIC as client transport protocol instead of TCP.
The Stream "listen" directive got a new option "quic" which enables
QUIC as client transport protocol instead of TCP or plain UDP.
- Along with "http3" or "quic", it's also possible to specify "reuseport"
+ Along with "quic", it's also possible to specify "reuseport"
option [8] to make it work properly with multiple workers.
To enable address validation:
@@ -142,12 +142,13 @@ Experimental QUIC support for nginx
A number of directives were added that configure HTTP/3:
+ http3
+ http3_hq
http3_stream_buffer_size
http3_max_concurrent_pushes
http3_max_concurrent_streams
http3_push
http3_push_preload
- http3_hq (requires NGX_HTTP_V3_HQ macro)
In http, an additional variable is available: $http3.
The value of $http3 is "h3" for HTTP/3 connections,
@@ -169,7 +170,7 @@ Example configuration:
server {
# for better compatibility it's recommended
# to use the same port for quic and https
- listen 8443 http3 reuseport;
+ listen 8443 quic reuseport;
listen 8443 ssl;
ssl_certificate certs/example.com.crt;
@@ -299,6 +300,13 @@ Example configuration:
response header fields into push requests.
+ Syntax: http3 on | off;
+ Default: http3 on;
+ Context: http, server
+
+ Enables HTTP/3 protocol negotiation.
+
+
Syntax: http3_hq on | off;
Default: http3_hq off;
Context: http, server