HTTP3 插件配置说明

功能简介

curlquic 插件基于 libcurl + ngtcp2 + nghttp3 实现，用于测试 HTTP/3 (QUIC)、HTTP/2 及 HTTP/1.x 的性能。支持自定义 HTTP 版本、TLS 版本、DNS、请求方法、POST 数据、响应校验等，不支持压缩头。

参数名	是否必填	默认值	说明
`host`	是	-	测试目标 URL
`ipVer`	否	0	IP 版本：0=自动，1=IPv6，2=IPv4；`如果选择IPv6，需要指定使用 IPv6 节点！！！`
`httpVersion`	否	3	HTTP 版本：1=HTTP/1.0, 1.1=HTTP/1.1, 2=HTTP/2, 3=HTTP/3
`sslVersion`	否	0	SSL / TLS 版本：0=默认, 1=TLSv1, 1.1=TLSv1.1, 1.2=TLSv1.2, 1.3=TLSv1.3
`insecure`	否	1	忽略证书错误，默认忽略
`dns`	否	空	自定义 DNS 服务器 IP
`hosts`	否	空	自定义 host 列表（类似 / etc / hosts）
`headers`	否	空	自定义 HTTP 请求头，可配置多行，格式 `Name: Value`
`method`	否	GET	HTTP 方法：GET、POST、PUT、OPTIONS、HEAD
`ieAgent`	否	1	是否使用 IE User-Agent：1=使用，0=不使用
`redirect`	否	1	是否允许重定向：1=允许，0=不允许
`username`	否	空	HTTP Basic 认证用户名
`password`	否	空	HTTP Basic 认证密码
`data`	否	空	请求体数据，可配置多行。支持 `hex:` 十六进制、`multipart-data:` 表单、`multipart-file:` 文件上传；不支持多格式混用
`ignoreStatus`	否	空	忽略指定的 HTTP 状态码错误，如 `400,403`
`checkData`	否	空	响应校验规则，可配置多行。格式：`类型:值`，类型 1=内容包含，2=MD5 相等，3=正则匹配，4=响应头包含，5=响应头 MD5 相等，6=响应头正则

指标索引	指标名称	单位	计算方式
0	总耗时	毫秒	性能 / 总耗时
1	DNS 时间	毫秒	域名解析耗时
2	连接时间	毫秒	TCP / QUIC 连接建立耗时
3	SSL 时间	毫秒	TLS / QUIC 握手耗时
4	请求时间	毫秒	发送 HTTP 请求的耗时
5	首包时间	毫秒	从发送请求到收到首字节响应的耗时
6	剩余包时间	毫秒	从首字节到响应完成的耗时
7	下载速度	KB / s	总下载字节数 / （首包时间 + 剩余包时间），再除以 1024
8	下载字节数	KB	响应体总字节数 / 1024
9	重定向时间	毫秒	发生重定向响应的所有网络消耗的和（不包括最后的响应的网络消耗）
10	重定向次数	次	重定向次数

httpVersion：

3（默认）：使用 HTTP/3 over QUIC。连接阶段会包含 QUIC 握手，不走传统 TCP 三次握手，连接时间（指标 1）和 SSL 时间（指标 2）会与 TCP+TLS 有显著差异。

2：HTTP/2 over TCP+TLS。

1 / 1.1：HTTP/1.x over TCP（可能无 TLS）。

sslVersion：强制指定 TLS 版本。若服务器不支持该版本，握手失败，SSL 指标记录失败前耗时。

dns / hosts：自定义 DNS 解析行为。配置 hosts 可直接绕过 DNS，使 DNS 时间（指标 0）为 0。

redirect：为 1 时跟随 3xx 重定向，总耗时包含所有跳转请求之和；为 0 时一次请求后停止。

data：POST / PUT 请求时配置。multipart 文件上传会增加请求时间和总耗时。

ignoreStatus：配置后，遇到对应状态码不会设置错误码，但指标仍正常计算。

checkData：用于响应验证。验证失败设置错误码，不影响已计算的性能指标。

错误码	含义
699000	初始化失败
699001	未知错误
612xxx	其它标准错误
600xxx	HTTP 状态码错误，如 400、500 系列，可被 ignoreStatus 忽略