适用范围与准备

适用于获准诊断的HTTPS请求中,curl带--http3仍显示HTTP/2,或--http3-only直接报错。先运行curl --version确认实际构建能力;只在允许的网络路径上做协议对照,不据此绕过单位的代理要求。

先区分原因

--http3允许在HTTP/3连接失败或建立较慢时回退;--http3-only不回退。命令被接受也不证明传输最终用了HTTP/3。当前curl手册还明确指出HTTP/3不能通过显式代理使用,系统TUN与curl的--proxy是不同接管路径。

按顺序操作

  1. 记录curl版本、TLS/QUIC后端及Features是否列出HTTP3。版本号足够新仍可能没有编译对应能力;选项未支持时,应记为本机无法执行这项测试,不把它算作目标不支持HTTP/3。
  2. 核对本轮是否带--proxy/-x或继承代理环境变量。显式HTTP/SOCKS代理路径不适用于这组HTTP/3对照;若必须使用该路径,就停止在能力范围说明,不为了凑结果强行关闭组织代理。
  3. 仅在允许直连的自管环境中,选择官方说明支持HTTP/3的非敏感目标。下面的--proxy空字符串取消curl显式代理,-q忽略默认curl配置,但不会关闭系统TUN、路由或其他设备接管;目标example.com只是占位,不保证支持HTTP/3。
  4. 分别运行允许回退与禁止回退的请求,通过http_version输出实际HTTP版本,并记录退出状态和目标响应。成功的--http3请求若实际为2或1.1,只说明回退路径成功。
  5. 如果--http3-only失败,保留具体错误,检查构建、目标支持、UDP路径与网络条件;不要把原因直接缩成“节点不支持UDP”,也不要根据单次成功推导长期更快。
仅用于已获准的自管直连对照;先换成明确支持HTTP/3的目标,Windows使用curl.exe
curl -q --proxy "" --http3 --connect-timeout 5 --max-time 15 --output h3-fallback.bin --write-out "http=%{http_version} status=%{http_code}
" https://example.com/
curl -q --proxy "" --http3-only --connect-timeout 5 --max-time 15 --output h3-only.bin --write-out "http=%{http_version} status=%{http_code}
" https://example.com/
结果可以说明什么
Features不含HTTP3该构建不能完成HTTP/3验证
--http3成功且版本为2回退传输成功
--http3-only成功且版本为3这轮目标传输使用HTTP/3
--http3-only失败保留错误,不能单凭此定位责任方

怎样确认有效

只有支持该能力的构建、已知目标、明确路径、实际版本和完整传输结果同时满足,才算HTTP/3验证。本文没有执行真实QUIC传输;不能把本地检查选项或预览页面通过写成HTTP/3已实测。

无效时恢复与下一步

撤销测试参数并恢复原代理要求,按需要删除响应文件。必须走显式代理的环境继续使用其支持的协议排障,不将强制HTTP/3当成通用加速开关。