指令参考

http3_hq

在 NGINX 中启用对 HTTP/3 的支持。 — NGINX HTTP Core

http3_hq
httpserver
语法http3_hq on | off;
默认值off
上下文http, server
模块NGINX HTTP Core
参数flag

说明

`http3_hq` 指令是 NGINX 中的一个配置选项，用于启用或禁用对 HTTP/3（超文本传输协议的第三个主要版本）的支持。该指令可以放在 `http` 或 `server` 上下文中，既可用于全局配置，也可用于特定服务器级别的配置。启用后，NGINX 将监听 QUIC 连接（HTTP/3 使用其作为传输层）并通过该协议处理请求。 使用此指令可以显著改善响应时间并在丢包情况下提供更好的处理能力，因为 HTTP/3 基于 QUIC，QUIC 提供诸如多路复用和连接迁移等特性。当 `http3_hq` 指令设置为 `on` 时，NGINX 将相应地处理 HTTP/3 请求；将其设置为 `off` 则会回退到传统的 HTTP/1.1 或 HTTP/2 来提供网页内容。由于 QUIC 和 HTTP/3 通常与 HTTPS 一起使用，必须确保证书符合要求的规范。 管理上需注意，启用 HTTP/3 可能需要特定的额外配置，例如为 QUIC 流量使用 UDP 以及配置相关防火墙规则以避免阻止 HTTP/3 请求。

配置示例

server {
    listen 443 ssl http3;
    http3_hq on;
    ssl_certificate /etc/ssl/certs/example.com.crt;
    ssl_certificate_key /etc/ssl/private/example.com.key;
}
⚠

确保您的系统支持 QUIC 和 UDP；否则 HTTP/3 无法正常工作。

⚠

可能需要调整防火墙以允许 UDP 流量，这对 HTTP/3 至关重要。

⚠

证书必须正确配置以与 QUIC 配合使用；无效的证书将导致无法建立 HTTP/3 连接。

相关指令

listensslhttp2