hey命令速查
安装与基础压测、并发与速率控制、请求构造、HTTPS 与 HTTP/2、CSV 输出、报告分段解读与报错排查等 118 条命令
共 118 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey | 不带参数直接打印全部用法与默认值 | |
hey -h | 查看帮助,参数以它为准 | |
go install github.com/rakyll/hey@latest | Go 环境安装,产物在 $GOPATH/bin | |
brew install hey | macOS 安装 | |
dnf install hey | RHEL/Fedora 系安装 | |
docker run --rm ralch/hey -n 1000 -c 50 http://example.com/ | 容器方式运行,注意容器 CPU 限额 | |
hey -n 10 -c 1 http://example.com/ | 装完先跑 10 个请求,确认参数与网络通 | |
nproc | 查看核数,决定 -cpus 上限 | |
hey 是 Go 实现的多 goroutine 压测 | 比 ab 更容易跑满压测机,结果更接近真实容量 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey -n 1000 -c 50 http://example.com/ | 最常用组合:1000 次请求、50 并发 | |
hey -n 10000 -c 200 http://example.com/api/health | 提高并发与请求数,先确认目标可承受 | |
hey -z 30s -c 50 http://example.com/ | 按时长压测,此时 -n 会被忽略 | |
hey -n 100 -c 10 http://example.com/ | 小流量冒烟,验证鉴权与链路 | |
hey -n 5000 -c 100 -t 5 http://example.com/ | 单请求超时 5 秒,默认 20 秒 | |
hey -n 5000 -c 100 -cpus 4 http://example.com/ | 指定使用的 CPU 核数,默认只用 1 核 | |
hey -n 2000 -c 50 -host "example.com" http://10.0.0.5/ | 直连后端 IP 但带真实 Host,绕过 DNS 与负载均衡 | |
hey -z 60s -c 100 http://example.com/ | tee hey.log | 长时压测并归档原始输出 | |
hey -n 1000 -c 50 -disable-keepalive http://example.com/ | 关闭连接复用,测短连接与握手开销 | |
hey -n 1000 -c 50 -disable-redirects http://example.com/ | 不跟随重定向,避免跳转耗时混入业务耗时 | |
hey -n 1000 -c 50 -disable-compression http://example.com/ | 关闭压缩,测未压缩传输的真实带宽 | |
hey -n 10000 -c 200 -cpus 8 url | 高并发下务必给足核数,否则压测机先成瓶颈 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
-n 200 | 总请求数,默认 200 | |
-c 50 | 并发 worker 数,默认 50,不能大于 -n | |
-q 10 | 每个 worker 的 QPS 上限,总速率 = q × c | |
hey -n 10000 -c 20 -q 5 url | 20 个 worker 各限 5 QPS,总目标 100 QPS | |
-z 10s | 压测时长,指定后 -n 失效 | |
-t 20 | 单请求超时秒数,默认 20,0 表示不限 | |
-cpus 4 | 使用核数,默认 1;不调大会明显限制吞吐 | |
hey -z 1m -c 50 -q 20 url | 恒定速率 + 固定时长,最接近 SLA 验证场景 | |
-c 不要超过 -n | n 小于 c 会直接报错退出 | |
速率场景优先用 -q | 不加 -q 时 hey 是闭环压测,能压多快压多快 | |
并发不等于速率 | c 是同时在跑的 worker 数,实际 QPS 取决于响应时间 | |
Little 定律:c ≈ 目标 QPS × 平均延迟(秒) | 用于反推需要多少并发才能打到目标吞吐 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey -n 500 -c 20 -m POST -d '{"k":"v"}' -T "application/json" http://example.com/api | POST JSON,-T 与 body 类型必须一致 | |
hey -n 500 -c 20 -m POST -D ./body.json -T "application/json" http://example.com/api | 请求体从文件读取,适合较大 payload | |
hey -n 500 -c 20 -m PUT -D ./put.json -T "application/json" http://example.com/item/1 | PUT 请求压测 | |
hey -n 500 -c 20 -m DELETE http://example.com/item/1 | DELETE 请求压测 | |
hey -n 500 -c 20 -m HEAD http://example.com/ | 只取响应头,测首字节与静态资源探测 | |
hey -n 500 -c 20 -H "Authorization: Bearer xxx" http://example.com/api | 带鉴权头,可重复 -H 传多个 | |
hey -n 500 -c 20 -H "X-Env: test" -H "X-Trace: bench" http://example.com/ | 多个自定义头,验证网关策略 | |
hey -n 500 -c 20 -A "application/json" http://example.com/api | 设置 Accept 头 | |
hey -n 500 -c 20 -a user:pass http://example.com/admin | Basic 认证压测 | |
hey -n 500 -c 20 -x 127.0.0.1:8080 http://example.com/ | 通过 HTTP 代理发起压测 | |
hey -n 500 -c 20 -T "application/x-www-form-urlencoded" -d "a=1&b=2" url | 表单提交压测 | |
body 较大时先估算带宽 | 总上传量 ≈ body 大小 × n,别让压测机先打满网卡 | |
接口有幂等校验时用动态参数 | hey 不支持脚本,固定 body 易被业务判重复 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey -n 1000 -c 50 https://example.com/ | 目标写 https 即走 TLS | |
hey -n 1000 -c 50 -h2 https://example.com/ | 启用 HTTP/2 压测 | |
hey 没有 -insecure 参数 | 自签证书无法跳过校验,需把 CA 导入系统信任库 | |
hey -n 1000 -c 50 -disable-keepalive https://example.com/ | 关闭复用以放大 TLS 握手开销,做对照实验 | |
openssl s_client -connect example.com:443 -alpn h2 | 先确认服务端 ALPN 支持 h2,再判断 -h2 是否生效 | |
hey -n 1000 -c 50 -H "Accept-Encoding: gzip" https://example.com/ | 对比压缩前后的吞吐与带宽 | |
客户端证书场景 hey 支持有限 | mTLS 压测建议改用 vegeta 的 -cert/-key | |
HTTP/3 不支持 | QUIC 场景换其他工具 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey -n 1000 -c 50 -o csv http://example.com/ > result.csv | 导出原始请求数据,便于二次统计 | |
hey -n 1000 -c 50 url > hey.log 2>&1 | 默认汇总输出直接重定向,注意 stderr | |
grep "Requests/sec" hey.log | 提取核心 QPS | |
grep -A8 "Latency distribution" hey.log | 看分位延迟 | |
grep -A10 "Status code distribution" hey.log | 看状态码分布,确认业务是否真的成功 | |
grep -A5 "Error distribution" hey.log | 错误分类与原因,比只看失败数更有用 | |
for c in 10 50 100 200; do hey -n 2000 -c $c url | grep "Requests/sec"; done | 并发爬坡,一轮拿到 QPS 变化 | |
diff <(grep "Requests/sec" before.log) <(grep "Requests/sec" after.log) | 调优前后只比关键指标 | |
csv 用 awk 或 pandas 二次分析 | CSV 每行是一次请求的分段耗时,可自行算分位 | |
结果留档要带版本与规格 | 否则无法复现,也无法做趋势对比 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
Summary: Total | 总耗时,含压测发起与收尾 | |
Slowest / Fastest / Average | 最慢、最快与平均耗时(秒) | |
Requests/sec | 核心 QPS,与并发、延迟相互印证 | |
Total data / Size per request | 总流量与单请求平均字节数 | |
Response time histogram | 按区间统计请求数,直观看分布形态 | |
Latency distribution 50% / 90% | 中位与常规分位,反映整体水平 | |
Latency distribution 99% | 长尾指标,用户投诉往往来自这里 | |
Details: DNS+dialup | DNS 解析加建连,偏高多为网络或解析问题 | |
Details: DNS-lookup | 纯解析耗时,内网 DNS 慢时尤其明显 | |
Details: req write | 请求写出耗时,大 body 场景会升高 | |
Details: resp wait | 等待响应,最接近服务端处理时间 | |
Details: resp read | 读取响应体,大响应或慢网络会拉高 | |
Status code distribution | 按状态码计数,4xx/5xx 集中时先查业务 | |
Error distribution | 网络层错误与原因,如 connection refused、timeout | |
resp wait 高而 DNS 正常 | 瓶颈在服务端,往应用、数据库与依赖查 | |
Requests/sec 与 c/平均延迟 对不上 | 说明存在排队或客户端受限,需交叉验证 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey vs ab | hey 多 goroutine、支持 HTTP/2 与 CSV,ab 单线程且只支持 HTTP/1.1 | |
hey vs wrk | wrk 性能更高但需 Lua 脚本;hey 开箱即用、参数直观 | |
hey vs wrk2 | wrk2 主打恒定速率与延迟校正,hey 的 -q 只是限速 | |
hey vs vegeta | vegeta 有目标文件、plot 与 encode,适合流水线化 | |
hey vs k6 | k6 支持场景编排与阈值门禁,hey 适合快速冒烟 | |
hey vs h2load | h2load 专注 HTTP/2 且能压多路复用,hey 的 -h2 较基础 | |
h2load -n 10000 -c 100 -m 10 https://example.com/ | 需要压 HTTP/2 多流时用它 | |
wrk -t4 -c100 -d30s --latency url | 追求极致客户端性能时用它 | |
k6 run script.js | 需要脚本化业务链路时用它 | |
先用 hey 冒烟,再用专用工具做容量结论 | 工具定位不同,混用结论容易失真 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
hey -n 1000 -c 10 url → c 50 → c 100 → c 200 | 并发爬坡,找 QPS 不涨、延迟陡增的拐点 | |
固定 -cpus 便于横向对比 | 核数变化会直接影响客户端吞吐,结论不可比 | |
ulimit -n 65535 | 高并发下句柄不足会先报 too many open files | |
sysctl -w net.ipv4.ip_local_port_range="1024 65535" | 短连接压测时扩大可用本地端口 | |
ss -s | 观察连接数与 TIME_WAIT 堆积 | |
top -H -p $(pgrep -f nginx) | 同时看服务端线程级 CPU | |
sar -n DEV 1 | 观察网卡是否打满 | |
压测环境与生产同规格 | 否则只能当趋势参考,不能当容量结论 | |
生产默认不压测 | 必须压测时走审批、限流与回滚预案 | |
看 P95/P99 而不是平均值 | 平均值会被大量快请求稀释 | |
加随机参数绕过缓存 | hey 不支持随机路径,可用多次不同 URL 或改用脚本工具 | |
单次压测不少于 30 秒 | 太短会被冷启动与连接建立阶段主导 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
-n must be greater than or equal to -c | 总请求数不能小于并发数,先提高 -n | |
unknown flag: -xxx | 参数名写错或版本不支持,用 hey -h 核对 | |
invalid method | -m 只能是 GET/POST/PUT/DELETE/HEAD/OPTIONS | |
unable to read body file | -D 指定的文件不存在或无读权限 | |
dial tcp: lookup example.com: no such host | DNS 解析失败,换 IP 或检查 resolv.conf | |
dial tcp 10.0.0.5:80: connect: connection refused | 端口未监听或被防火墙拦截 | |
context deadline exceeded (Client.Timeout exceeded) | 请求超时,用 -t 调大并排查慢接口 | |
x509: certificate signed by unknown authority | hey 无跳过校验参数,需把 CA 导入系统信任库 | |
too many open files | 提高 ulimit -n 或降低并发 | |
Requests/sec 很低但服务端很闲 | 压测机瓶颈,提高 -cpus 或换机器 | |
大量 4xx/5xx 但无网络错误 | 业务层问题,检查鉴权、限流与参数 | |
Error distribution 全是 timeout | 并发过高或服务端排队,降并发重测 | |
结果里 Total data 异常小 | 可能命中 304 或空响应,确认压的是真实接口 | |
QPS 很高但业务监控没量 | 命中 CDN 或本地缓存,换带随机参数的 URL 复测 | |
-h2 没有明显效果 | 服务端未开启 HTTP/2,先用 openssl s_client -alpn 验证 | |
CSV 只有部分行 | 压测中途被中断或超时,检查失败原因 |
运维常用组合
hey -n 10000 -c 100 -cpus 4 url | tee base.log → 提取 Requests/sec 与 99% 分位 → 记录实例规格hey -n 2000 -c 50 -m POST -D body.json -T "application/json" -H "Authorization: Bearer x" urlhey -z 60s -c 20 -q 10 url → 总目标 200 QPS → 看 Requests/sec 是否接近 200 且 99% 稳定for c in 10 50 100 200; do hey -n 3000 -c $c url | grep -E "Requests/sec|99%"; done调优前 hey -n 10000 -c 100 url > before.log → 改配置 → 同参数 > after.log → diff 关键指标hey -n 5000 -c 100 -o csv url > r.csv → pandas/awk 自算分位与错误分布 → 出报告实战要点
1. -q 是每 worker 限速
总速率 = q × c,容易误以为是全局 QPS,配错会导致压力差一个数量级
2. 默认只用 1 核
不给 -cpus 时 hey 只跑一个核,高并发场景会先被客户端卡住
3. -z 会忽略 -n
按时长压测时总请求数由速率与时长共同决定
4. 看 resp wait
它最接近服务端处理时间,比总耗时更能定位瓶颈归属
5. 无脚本能力
hey 不支持动态参数与链路编排,复杂业务换 k6 或 vegeta
6. 先冒烟再压测
用 -n 100 -c 10 确认状态码与鉴权,再逐步提高压力
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于hey命令速查
在线 hey(rakyll/hey)命令速查手册,按安装与版本、基础压测、并发速率与时长、请求构造、HTTPS 与 HTTP/2、输出格式与采集、报告字段解读、与其他工具对比、压测方法与注意事项、常见报错与排查等 10 类场景整理 110 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 go install github.com/rakyll/hey@latest 与 brew/dnf/docker 安装、hey -n 200 -c 50 url 基础用法、-n 总请求数 与 -c 并发 worker 与 -q 每 worker 的 QPS 限速(总速率 = q × c)与 -z 时长压测(指定后 -n 失效)与 -t 单请求超时 与 -cpus 使用的核数 与 -m GET/POST/PUT/DELETE/HEAD/OPTIONS 与 -d 请求体 与 -D 从文件读请求体 与 -T Content-Type 与 -H 自定义头(可重复)与 -A Accept 与 -a Basic 认证 与 -host 指定 Host 与 -x 代理 与 -h2 启用 HTTP/2 与 -disable-compression 与 -disable-keepalive 与 -disable-redirects 与 -o csv 原始数据导出,以及 Summary 的 Total/Slowest/Fastest/Average/Requests/sec/Total data/Size per request、Response time histogram 直方图、Latency distribution 的 10%/25%/50%/75%/90%/95%/99% 分位、Details 的 DNS+dialup/DNS-lookup/req write/resp wait/resp read 分段耗时、Status code distribution 与 Error distribution 逐项解读,还有与 ab/wrk/wrk2/vegeta/k6 的能力对比,以及 -n 小于 -c、unknown flag、invalid method、unable to read body file、no such host、connection refused、context deadline exceeded、x509 certificate signed by unknown authority(hey 无 -insecure)、too many open files、CSV 字段含义 等报错排查。适用于 HTTP 接口吞吐与延迟基线测试、POST JSON 与鉴权接口压测、并发爬坡找拐点、Nginx 与网关调优前后对比、HTTPS 与 HTTP/2 场景验证、压测数据导出与报告采集,以及运维、测试与后端工程师面试复习。
核心能力
- 涵盖 go install github.com/rakyll/hey@latest 与 brew/dnf/docker 安装、hey -n 200 -c 50 url 基础用法、-n 总请求数 与 -c 并发 worker 与 -q 每 worker 的 QPS 限速(总速率 = q × c)与 -z 时长压测(指定后 -n 失效)与 -t 单请求超时 与 -cpus 使用的核数 与 -m GET/POST/PUT/DELETE/HEAD/OPTIONS 与 -d 请求体 与 -D 从文件读请求体 与 -T Content-Type 与 -H 自定义头(可重复)与 -A Accept 与 -a Basic 认证 与 -host 指定 Host 与 -x 代理 与 -h2 启用 HTTP/2 与 -disable-compression 与 -disable-keepalive 与 -disable-redirects 与 -o csv 原始数据导出,以及 Summary 的 Total/Slowest/Fastest/Average/Requests/sec/Total data/Size per request、Response time histogram 直方图、Latency distribution 的 10%/25%/50%/75%/90%/95%/99% 分位、Details 的 DNS+dialup/DNS-lookup/req write/resp wait/resp read 分段耗时、Status code distribution 与 Error distribution 逐项解读,还有与 ab/wrk/wrk2/vegeta/k6 的能力对比,以及 -n 小于 -c、unknown flag、invalid method、unable to read body file、no such host、connection refused、context deadline exceeded、x509 certificate signed by unknown authority(hey 无 -insecure)、too many open files、CSV 字段含义 等报错排查
适用场景
适用于 HTTP 接口吞吐与延迟基线测试、POST JSON 与鉴权接口压测、并发爬坡找拐点、Nginx 与网关调优前后对比、HTTPS 与 HTTP/2 场景验证、压测数据导出与报告采集,以及运维、测试与后端工程师面试复习。hey命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。
常见问题
- hey命令速查是免费的吗?需要注册或安装吗?
- hey命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
- hey命令速查支持哪些功能?
- 涵盖 go install github.com/rakyll/hey@latest 与 brew/dnf/docker 安装、hey -n 200 -c 50 url 基础用法、-n 总请求数 与 -c 并发 worker 与 -q 每 worker 的 QPS 限速(总速率 = q × c)与 -z 时长压测(指定后 -n 失效)与 -t 单请求超时 与 -cpus 使用的核数 与 -m GET/POST/PUT/DELETE/HEAD/OPTIONS 与 -d 请求体 与 -D 从文件读请求体 与 -T Content-Type 与 -H 自定义头(可重复)与 -A Accept 与 -a Basic 认证 与 -host 指定 Host 与 -x 代理 与 -h2 启用 HTTP/2 与 -disable-compression 与 -disable-keepalive 与 -disable-redirects 与 -o csv 原始数据导出,以及 Summary 的 Total/Slowest/Fastest/Average/Requests/sec/Total data/Size per request、Response time histogram 直方图、Latency distribution 的 10%/25%/50%/75%/90%/95%/99% 分位、Details 的 DNS+dialup/DNS-lookup/req write/resp wait/resp read 分段耗时、Status code distribution 与 Error distribution 逐项解读,还有与 ab/wrk/wrk2/vegeta/k6 的能力对比,以及 -n 小于 -c、unknown flag、invalid method、unable to read body file、no such host、connection refused、context deadline exceeded、x509 certificate signed by unknown authority(hey 无 -insecure)、too many open files、CSV 字段含义 等报错排查。
- hey命令速查适合哪些场景使用?
- 适用于 HTTP 接口吞吐与延迟基线测试、POST JSON 与鉴权接口压测、并发爬坡找拐点、Nginx 与网关调优前后对比、HTTPS 与 HTTP/2 场景验证、压测数据导出与报告采集,以及运维、测试与后端工程师面试复习。