知识库 → 在 nginx 中启用 http/3 支持

从 nginx 版本 1.25.0 开始支持 QUIC 和 HTTP/3 协议。

您可以使用以下命令检查当前版本：

nginx -v

基本配置文件中需添加以下参数：

listen 443 quic reuseport;    
...
# 启用http3支持
http3 on;
# 启用 GSO
quic_gso on;
# 允许地址验证
quic_retry on;

...
# 将浏览器重定向到 quic 端口
add_header Alt-Svc 'h3=":443";max=86400';
...

最终的配置文件将如下所示：

server
{
    # 为了更好的兼容性，建议 quic 和 https 使用相同的端口
    # 指定 quic 协议和reuseport 参数以便与多个工作进程正常工作
    listen 443 quic reuseport;    
    listen 443 ssl;

    # 启用http2支持
    http2 on;    
    # 启用http3支持
    http3 on;
    # 启用 GSO
    quic_gso on;
    # 允许地址验证
    quic_retry on;

    # QUIC 需要 TLSv1.3 协议版本。
    ssl_protocols TLSv1.2 TLSv1.3;

    ssl_certificate /path_certs/fullchain-ssl.pem;
    ssl_certificate_key /path_certs/key.pem;

    # 将浏览器重定向到 quic 端口
    add_header Alt-Svc 'h3=":443";max=86400';

    ...

}

要应用设置，请重新启动服务，并使用以下命令检查配置文件是否有错误：

nginx -t
service nginx restart

您可以使用以下在线服务检查该站点的可用性以及您的互联网提供商对 http/3 协议的支持：

• https://quic.nginx.org/
• https://http3.is/
• https://http3check.net/