GeekIt

hey命令速查

安装与基础压测、并发与速率控制、请求构造、HTTPS 与 HTTP/2、CSV 输出、报告分段解读与报错排查等 118 条命令

共 118 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
hey不带参数直接打印全部用法与默认值
hey -h查看帮助,参数以它为准
go install github.com/rakyll/hey@latestGo 环境安装,产物在 $GOPATH/bin
brew install heymacOS 安装
dnf install heyRHEL/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 url20 个 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 不要超过 -nn 小于 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/apiPOST 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/1PUT 请求压测
hey -n 500 -c 20 -m DELETE http://example.com/item/1DELETE 请求压测
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/adminBasic 认证压测
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+dialupDNS 解析加建连,偏高多为网络或解析问题
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 abhey 多 goroutine、支持 HTTP/2 与 CSV,ab 单线程且只支持 HTTP/1.1
hey vs wrkwrk 性能更高但需 Lua 脚本;hey 开箱即用、参数直观
hey vs wrk2wrk2 主打恒定速率与延迟校正,hey 的 -q 只是限速
hey vs vegetavegeta 有目标文件、plot 与 encode,适合流水线化
hey vs k6k6 支持场景编排与阈值门禁,hey 适合快速冒烟
hey vs h2loadh2load 专注 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 hostDNS 解析失败,换 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 authorityhey 无跳过校验参数,需把 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% 分位 → 记录实例规格
POST JSON 压测hey -n 2000 -c 50 -m POST -D body.json -T "application/json" -H "Authorization: Bearer x" url
恒定速率验证hey -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 确认状态码与鉴权,再逐步提高压力

共 118 条 hey 命令 · 示例中的域名、并发与文件路径请替换为实际环境

关于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 场景验证、压测数据导出与报告采集,以及运维、测试与后端工程师面试复习。