模块 ngx_http_v3_module

这ngx_http_v3_modulemodule （1.25.0） 提供 对 HTTP/3 的实验性支持。

这个模块不是默认构建的，它应该使用--with-http_v3_moduleconfiguration 参数。

提供 QUIC 支持的 SSL 库 例如 BoringSSL、LibreSSL 或 QuicTLS 来构建和运行此模块。 否则 使用 OpenSSL 库时， 将使用不支持早期数据的 OpenSSL 兼容层。

该模块是实验性的，需要注意购买者。

http {
    log_format quic '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent" "$http3"';

    access_log logs/access.log quic;

    server {
        # for better compatibility it's recommended
        # to use the same port for http/3 and https
        listen 8443 quic reuseport;
        listen 8443 ssl;

        ssl_certificate     certs/example.com.crt;
        ssl_certificate_key certs/example.com.key;

        location / {
            # used to advertise the availability of HTTP/3
            add_header Alt-Svc 'h3=":8443"; ma=86400';
        }
    }
}

请注意，通过 TLS 接受 HTTP/3 连接需要 TLSv1.3 协议支持，自 OpenSSL 版本 1.1.1 起提供。

http3 on;

启用 HTTP/3 协议协商。

http3_hq off;

启用 HTTP/0.9 协议协商 用于 QUIC 互作性测试。

http3_max_concurrent_streams 128;

设置并发 HTTP/3 请求流的最大数量 在连接中。

http3_stream_buffer_size 64k;

设置用于读取和写入 QUIC 流。

quic_active_connection_id_limit 2;

设置 QUICactive_connection_id_limittransport 参数值。 这是客户端连接 ID 的最大数量 可以存储在服务器上。

quic_bpf off;

启用使用 eBPF 的 QUIC 数据包路由。 启用后，这将允许支持 QUIC 连接迁移。

该Directives仅在 Linux 5.7+ 上受支持。

quic_gso off;

支持以优化的批处理模式发送 使用分段卸载。

仅在 Linux 上支持优化发送 具有UDP_SEGMENT.

将file使用用于加密的密钥 无状态重置和地址验证令牌。 默认情况下，每次重新加载时都会生成一个随机键。 不接受使用旧密钥生成的令牌。

quic_retry off;

启用 QUIC 地址验证功能。 这包括在Retry包 或NEW_TOKEN框架 和 验证在Initial包。

这ngx_http_v3_module模块 支持以下嵌入变量：

$http3

协商协议标识符： “h3“ 对于 HTTP/3 连接， “hq“ 对于 HQ 连接， 否则为空字符串。