Nginx 1.25.1无法启用HTTP3，始终以HTTP/1.1提供服务求助

• 确认Nginx编译模块
  执行nginx -V查看编译参数，必须包含--with-http_v3_module和--with-stream_quic_module。Debian官方默认包通常未包含这些模块，若缺失，需自行编译Nginx或使用第三方提供的带HTTP3支持的包。

• 检查UDP端口监听
  QUIC基于UDP协议，需确认Nginx是否监听UDP 443端口：

  ss -ulnp | grep nginx
  

  若输出中无udp ... :443 ... nginx的记录，说明listen 443 quic配置未生效，可尝试添加reuseport参数：

  listen 443 quic reuseport;
  

• 验证TLS 1.3配置
  QUIC强制依赖TLS 1.3，需确保：

  1. options-ssl-nginx.conf中包含ssl_protocols TLSv1.2 TLSv1.3;（不能仅保留TLSv1.2）；
  2. 加密套件包含QUIC支持的AEAD类型，可显式指定：

     ssl_ciphers TLS_CHACHA20_POLY1305_SHA256:TLS_AES_256_GCM_SHA384:TLS_AES_128_GCM_SHA256;
     

• 修正Alt-Svc响应头
  配置中的"是HTML转义字符，在Nginx配置中无效，需改为正确格式：

  add_header Alt-Svc 'h3=":443"; ma=86400';
  

  该头用于告知客户端支持HTTP3，格式错误会导致浏览器无法识别。

• 确保客户端支持并启用HTTP3

  • Chrome：开启chrome://flags/#enable-quic；
  • Firefox：在about:config中设置network.http.http3.enabled=true；
  • 命令行测试使用支持HTTP3的curl版本（需7.88.1+）：

    curl --http3 https://www.mywebsite.com -v
    

• 检查防火墙规则
  确认UDP 443端口未被防火墙拦截：

  • 若使用ufw：ufw allow 443/udp；
  • 若使用iptables：添加规则iptables -A INPUT -p udp --dport 443 -j ACCEPT；
    规则生效后重启防火墙服务。

• 开启调试日志排查
  在server块中添加调试日志配置，重启Nginx后用HTTP3客户端访问，查看日志细节：

  error_log /var/log/nginx/error.log debug;
  access_log /var/log/nginx/http3_access.log combined;
  

  重点查看是否有QUIC连接建立的日志，或连接失败的具体原因。

内容的提问来源于stack exchange，提问作者EmmanuelBeziat