指令参考

http3

http3 指令在 NGINX 中启用对 HTTP/3 协议的支持。 — NGINX HTTP Core

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

说明

`http3` 指令允许 NGINX 支持 HTTP/3 协议，HTTP/3 是超文本传输协议 (Hypertext Transfer Protocol) 的第三个主要版本。HTTP/3 构建于 QUIC 之上，QUIC 是一种由 Google 最初开发的传输层网络协议。将此指令设置为 'on' 后，服务器将能够使用 HTTP/3 处理请求，利用流复用并相较于传统的 HTTP/2 和 HTTP/1.1 提供更好的性能。启用时，NGINX 会与支持 HTTP/3 的客户端通信，为它们带来更低的延迟和更强的连接弹性，这得益于 QUIC 的独特特性，例如 0RTT 连接建立和更好的丢包处理。 该指令可以放在 `http` 和 `server` 上下文中，允许在全局或特定服务器级别进行配置。将此指令设置为 'on' 后，服务器将在支持的客户端上尝试使用 HTTP/3，同时仍能为使用旧协议的客户端提供服务。这使得向较新协议版本的过渡更加平滑，而无需完全停止对现有协议的支持。此外，HTTP/3 依赖于加密连接，因此需要正确配置 TLS/SSL，部署此指令之前务必设置好相应的证书。

配置示例

server {
    listen 443 ssl;
    http3 on;
    ssl_certificate /etc/nginx/ssl/example.crt;
    ssl_certificate_key /etc/nginx/ssl/example.key;
}
⚠

确保在服务器上正确启用 QUIC，并打开必要的端口（通常为 UDP 443）。

⚠

确保正确配置 SSL 证书，因为 HTTP/3 需要加密连接。

⚠

检查你的客户端是否支持 HTTP/3，因为较旧的客户端会回退到 HTTP/2 或 HTTP/1.1。

相关指令

listensslhttp2