Nginx HTTP/3 自动化脚本：别只看版本号，四个检查点统一 QUIC 参数

把 QUIC 参数放进自动化脚本，按四个可幂等验证的环节拆开：编译模块校验、系统参数、server 块变量化、上线验证。

1. 编译模块校验：nginx -V 必须同时命中两个模块

脚本运行前需确认 Nginx 真正支持 QUIC，不能只看版本号：版本号或镜像标签只能说明预期，nginx -V 输出的是实际编译参数，缺模块时进程仍起不来 QUIC。

执行：

nginx -V 2>&1 | grep -E "(http_v3_module|stream_quic_module)"

必须同时输出两行——缺一不可。

若缺失，脚本应中止并提示：

请重编译 Nginx，添加 --with-http_v3_module --with-stream_quic_module

Docker 场景下需进入容器执行该命令，不能仅依赖镜像标签判断。

2. sysctl 系统参数：UDP 缓冲和内核版本先过

UDP 缓冲区、reuseport 支持等不属于 Nginx 配置项，但直接影响 QUIC 稳定性。

在脚本中预置 /etc/sysctl.d/99-nginx-quic.conf 模板，内容含：

net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
net.ipv4.udp_rmem_min = 8192
net.ipv4.udp_wmem_min = 8192
net.core.auto_flowcontrol = 1

执行加载：

sysctl -p /etc/sysctl.d/99-nginx-quic.conf

并用 ss -u -i | head -5 抽样验证 socket 缓冲值是否生效。

内核版本检查：脚本中加

[ $(uname -r | cut -d. -f1,2 | sed 's/.//') -ge 57 ] || exit 1

对应 ≥5.7。

3. Nginx server 块变量化：端口、超时和拥塞算法注入

避免硬编码，用模板引擎（如 envsubst 或简单 sed）动态填充端口、证书路径、超时值等。

模板中保留占位符：

listen $PORT quic reuseport;
quic_max_idle_timeout $IDLE_TIMEOUT;
quic_congestion_control $CC_ALGO;
add_header Alt-Svc 'h3=":$PORT"; ma=$MAX_AGE';

调用时传入：

PORT=443 IDLE_TIMEOUT=30s CC_ALGO=bbr MAX_AGE=86400 envsubst < quic.template > /etc/nginx/conf.d/quic.conf

确保同一 server 块中同时存在：

listen 443 ssl http2;       # TCP 兼容
listen 443 quic reuseport;  # UDP 入口

HTTP/2 与 quic 同时监听是为了让不支持 HTTP/3 的客户端继续走 TCP，Alt-Svc 也需要原有 HTTP/2 通道下发；只开 QUIC 会丢掉回退路径。

4. 上线验证：语法、重载、curl/tcpdump 和浏览器兜底

配置写完不等于生效，脚本末尾必须包含轻量验证步骤：

• 语法检查：nginx -t，失败则退出并打印错误行号
• 服务重启：systemctl reload nginx 或 nginx -s reload
• 主动探测 QUIC 可达性：使用

curl -v --http3 https://$DOMAIN 2>&1 | grep -q "HTTP/3"

需客户端支持。

或更可靠方式：用

tcpdump -i lo udp port 443 -c 2 -w /tmp/quic.pcap

抓包后检查是否有 Initial 包。

• 浏览器兼容性兜底：输出提示“请在 Chrome DevTools → Network 标签页刷新页面，Protocol 列显示 h3 即成功”