GeekIt

wrk命令速查

安装与基础压测、Lua 脚本动态请求、结果字段解读、POST 与鉴权、进阶用法、系统调优、工具对比与报错排查等 121 条命令

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

命令 / 片段说明复制
wrk -v查看版本与编译特性,确认是否带 SSL
wrk不带参数输出 usage,是最快的参数速览
apt install wrkDebian/Ubuntu 安装
yum install wrk需先启用 EPEL 源
brew install wrkmacOS 安装
docker run --rm williamyeh/wrk -t4 -c100 -d30s http://example.com/容器方式运行,注意容器网络与 CPU 限制
git clone https://github.com/wg/wrk && cd wrk && make源码编译,可控特性与版本
apt install build-essential libssl-dev && make编译失败缺 openSSL 头文件时先装依赖
nproc查看 CPU 核数,决定 -t 的上限
which wrk && wrk -v确认实际执行的是哪个版本
命令 / 片段说明复制
wrk -t4 -c100 -d30s http://example.com/最常用组合:4 线程、100 连接、30 秒
wrk -t4 -c100 -d30s --latency http://example.com/加上延迟分布,压测几乎必带
wrk -t2 -c50 -d10s http://example.com/api/health短时冒烟,先确认链路与鉴权
wrk -t4 -c100 -d30s --timeout 5s http://example.com/把请求超时调到 5 秒,避免慢接口被判失败
wrk -t8 -c400 -d60s --latency http://example.com/高并发长时压测,需先确认压测机不吃紧
wrk -t4 -c100 -d1m http://example.com/时间支持 s/m/h 单位
wrk -t4 -c1k -d30s http://example.com/数值支持 SI 单位,1k 即 1000
wrk -t4 -c100 -d30s -H "Host: example.com" http://10.0.0.5/直连后端 IP 带真实 Host,绕过 DNS 与负载均衡
wrk -t4 -c100 -d30s -H "Accept-Encoding: gzip" http://example.com/验证压缩对吞吐与带宽的影响
wrk -t4 -c100 -d30s -H "Connection: close" http://example.com/强制短连接,用于对照长连接结果
wrk -t4 -c100 -d30s "http://example.com/?r=$RANDOM"加随机参数绕过缓存,测真实回源能力
线程数建议等于 CPU 核数再多的线程只会增加上下文切换,不会提升 QPS
-c 是总连接数平均分配到各线程,-t4 -c100 表示每线程 25 个连接
命令 / 片段说明复制
wrk -t4 -c100 -d30s -s script.lua http://example.com/加载 Lua 脚本,实现动态请求与统计
wrk.method = "POST"脚本内设置请求方法
wrk.path = "/api/order"覆盖请求路径,URL 只作为 base
wrk.body = '{"k":"v"}'设置请求体,JSON 场景必须配 Content-Type
wrk.headers["Content-Type"] = "application/json"设置请求头,也可用 -H 在命令行追加
wrk.headers["Authorization"] = "Bearer " .. token动态拼接鉴权头
function request() wrk.path = "/api/item/" .. math.random(1, 1000) return wrk.format() end每次请求动态生成路径,模拟真实流量分布
return wrk.format("POST", wrk.path, wrk.headers, wrk.body)手动构造请求,等价于默认行为
function init(args) print("args:", args[1]) endinit 在每个线程启动时执行,可读环境变量与文件
function setup(thread) thread:set("id", tid) endsetup 在创建线程后执行,用于分发参数
function done(summary, latency, requests) print(latency:percentile(99)) enddone 在主线程结束前执行,可自定义输出报表
local f = io.open("body.json") local body = f:read("*a") f:close()init 中读取请求体文件,避免长字符串难维护
math.randomseed(os.time() + tid)按线程播种随机数,保证结果可复现又不重复
latency:percentile(99)取 P99 延迟,脚本里做自定义阈值判断
summary.errors.connect / read / write / timeout / status分类错误计数,定位是网络问题还是业务返回码
thread:stop()在 request 中主动停止某线程,做异常熔断实验
wrk.format(method, path, headers, body)构造请求字符串,返回 nil 表示跳过本次请求
script 里 print 输出走 stderr重定向时不要只重定向 stdout
命令 / 片段说明复制
Running 30s test @ http://example.com/确认压测时长与目标 URL 是否符合预期
4 threads and 100 connections确认线程与连接数已生效,容器内常被 CPU 限制削弱
Latency Avg / Stdev / Max / +/- Stdev单请求耗时统计,Stdev 大说明抖动明显
Req/Sec(Thread Stats)单线程每秒请求数,乘以线程数约等于总 QPS
Socket errors: connect 0, read 0, write 0, timeout 0任何一项非 0 都要先排查,结果不可直接用
Requests/sec: 12345.67核心指标:整体 QPS
Transfer/sec: 12.34MB实际吞吐带宽,判断是否撞到网卡上限
Latency Distribution 50% / 75% / 90% / 99%需加 --latency,长尾问题只看 99% 分位
Non-2xx or 3xx responses: 1024业务层失败,wrk 仍计入 QPS,必须单独看
+/- Stdev 接近 50% 以上延迟分布分散,说明存在队列堆积或 GC 抖动
QPS 高但 Latency 也高并发推高吞吐的同时在排队,逼近容量上限
P99 是 P50 的 5 倍以上典型的慢查询、锁竞争或限流触发特征
命令 / 片段说明复制
wrk -t4 -c100 -d30s -s post.lua http://example.com/apiPOST 建议用脚本方式,参数更可控
wrk -t4 -c100 -d30s -H "Content-Type: application/json" -s post.lua http://example.com/api头信息留在命令行,脚本只管 body
wrk -t4 -c50 -d30s -H "Authorization: Bearer xxx" -H "X-Env: test" http://example.com/api多请求头组合,模拟网关灰度与鉴权
wrk -t4 -c50 -d30s -H "Cookie: session=abc; lang=zh" http://example.com/带 Cookie 模拟登录态
local token = os.getenv("TOKEN")脚本读取环境变量,避免 token 写进文件
body = string.format('{"id":%d,"ts":%d}', id, os.time())参数化请求体,避免重复命中同一份缓存
wrk -t4 -c100 -d30s -s upload.lua http://example.com/upload大 body 上传压测,先算带宽再定并发
Content-Length 由 wrk 自动计算手工改 wrk.headers 里的长度会导致请求被截断
接口有幂等校验时加唯一 id否则业务侧直接返回重复错误,压不出真实吞吐
命令 / 片段说明复制
wrk -t4 -c100 -d30s https://example.com/HTTPS 直接压,wrk 默认不校验证书,自签也能跑
wrk2 -t4 -c100 -d30s -R 2000 --latency http://example.com/wrk2 支持恒定 RPS,更适合容量评估与延迟测量
wrk -t4 -c100 -d30s -s multi.lua http://example.com/wrk 单 URL,多接口需在脚本里改 wrk.path
wrk -t4 -c100 -d30s --latency -s rand.lua http://example.com/随机路径 + 延迟分布,最接近真实业务形态
wrk 不支持 HTTP/2HTTP/2 与 HTTP/3 场景改用 h2load
wrk 不支持多机分布式大规模压测用 k6 cloud、Locust 或自建多压测机
wrk 默认复用连接与 ab 不加 -k 的结果不可直接比较
wrk -t4 -c100 -d30s --latency http://example.com/ > run1.log归档原始输出,做调优前后对比
wrk -t4 -c100 -d30s -H "User-Agent: wrk-bench" http://example.com/打自定义 UA,便于在服务端日志里区分压测流量
压测流量要能被监控识别加标记头或独立路径,避免污染生产指标
命令 / 片段说明复制
wrk -t4 -c100 -d30s --latency url | tee -a bench.log追加写入,多轮结果留档
grep "Requests/sec" bench.log提取 QPS 做横向对比
grep -E "Latency Distribution|99%" bench.log提取 P99 观察长尾变化
for c in 50 100 200 400; do wrk -t4 -c$c -d20s --latency url | grep -E "Requests/sec|99%"; done并发爬坡,一轮拿到 QPS 与 P99 曲线
wrk -t4 -c100 -d30s --latency url > before.log调优前基线
diff <(grep -E "Requests/sec|99%" before.log) <(grep -E "Requests/sec|99%" after.log)调优前后只对比关键指标
2>&1 | tee脚本 print 走 stderr,需要一并捕获
WRK_OUT=$(mktemp) && wrk ... > "$WRK_OUT"CI 中临时文件方式采集结果
把 QPS、P95/P99、错误数写进报告模板单看 QPS 无法说明系统健康度
命令 / 片段说明复制
ulimit -n 65535高并发压测先提高句柄上限
sysctl -w net.ipv4.ip_local_port_range="1024 65535"扩大可用本地端口,避免 connect 失败
sysctl -w net.ipv4.tcp_tw_reuse=1短连接压测时缓解 TIME_WAIT 堆积
sysctl -w net.core.somaxconn=4096配合服务端 backlog 一起调
ss -s观察连接总数、TIME_WAIT 与内存占用
ss -tn state established | wc -l确认实际建立的长连接数是否达到 -c
sar -n DEV 1观察压测机与目标机网卡带宽是否打满
top -H -p $(pgrep -f nginx)看服务端线程级 CPU,识别单核跑满
vmstat 1观察上下文切换与中断,判断是否被压测机限制
perf top服务端 CPU 热点定位,找出压测暴露的瓶颈函数
压测机与服务端分开部署同机压测会互相抢 CPU 与带宽,结论不可信
压测期间固定其他变量版本、规格、缓存状态都要记录,否则无法复现
命令 / 片段说明复制
wrk vs abwrk 多线程更能跑满压测机,ab 单线程且默认不复用连接
h2load -n 10000 -c 100 -m 10 https://example.com/需要 HTTP/2 时用 h2load,-m 控制每连接并发流
hey -n 10000 -c 100 -m POST -T application/json -d body.json urlGo 实现,参数直观,输出分位清晰
vegeta attack -rate=200 -duration=30s -targets=t.txt | vegeta report恒定速率压测,适合做容量与 SLA 验证
k6 run script.js现代脚本化压测,支持场景编排与阈值断言
locust -f locustfile.py --headless -u 200 -r 20Python 场景编排,可分布式的 Web 压测
siege -c100 -t30s -f urls.txt多 URL 轮询压测,配置简单
jmeter -n -t plan.jmx -l result.jtl复杂业务链路与报表需求用 JMeter
curl -w "@fmt.txt" -o /dev/null -s url单次请求分段耗时,压测前先确认慢在哪
先用 wrk 摸吞吐,再用 k6/JMeter 编排链路工具互补,别指望一个工具覆盖所有场景
命令 / 片段说明复制
unable to connect to example.com: Connection refused端口未监听或防火墙拦截
Socket errors: connect 12本地端口耗尽或服务端 backlog 满,扩端口范围并检查 somaxconn
Socket errors: read / write 非 0连接被中途重置,多为限流、连接池耗尽或超时
Socket errors: timeout 非 0请求超时,用 --timeout 调大并排查慢接口
Non-2xx or 3xx responses 大量出现业务报错,检查鉴权、限流、参数与上游依赖
error loading script: script.lua: ...Lua 语法错误,按行号修正
error loading script: No such file or directory脚本路径错误,用绝对路径或确认工作目录
attempt to index a nil valuewrk.headers 未初始化就赋值,或用了不存在的字段
request() 返回 nil所有请求被跳过,表现为 0 requests,检查分支逻辑
undefined symbol: SSL_new编译缺 OpenSSL,装 libssl-dev 后 make clean && make
wrk: command not found未安装或不在 PATH,确认二进制位置
QPS 上不去而服务端很闲压测机瓶颈:CPU、句柄、端口或网卡,换 wrk2/多机复测
threads 超过核数后无提升正常现象,线程数就该约等于核数
Latency 高但服务端 CPU 低网络 RTT、DNS 或上游依赖慢,用直连 IP 与 Host 头验证
压测结果每轮差异很大缓存、GC、邻居干扰,固定环境并延长时长取稳定段
wrk 在容器内性能明显偏低CPU 限额、cgroup 与网络栈差异,改用 host 网络或物理机
高并发下大量 TIME_WAIT开了短连接,调 tcp_tw_reuse 或改回复用连接
结果与网关侧统计不一致中间有 CDN、限流或采样,核对统计口径与时间段

运维常用组合

接口吞吐基线wrk -t4 -c100 -d30s --latency http://example.com/api → 记录 Requests/sec 与 99% 分位 → 归档原始输出
并发爬坡找拐点for c in 50 100 200 400 800; do wrk -t4 -c$c -d20s --latency url | grep -E "Requests/sec|99%"; done
POST JSON 压测post.lua 设 wrk.method/wrk.body/wrk.headers → wrk -t4 -c100 -d30s -s post.lua -H "Authorization: Bearer x" url
调优前后对比调优前 wrk -t4 -c100 -d30s --latency url > before.log → 改配置 → 同参数 > after.log → diff 关键指标
恒定速率验证 SLAwrk2 -t4 -c100 -d60s -R 2000 --latency url → 看 99% 是否稳定在阈值内,而不是只看最大吞吐
压测报告采集多轮 wrk 输出 tee 到 bench.log → grep 提取 QPS/P99/错误数 → 附上实例规格、版本与压测时间

实战要点

1. 线程数≈CPU 核数

超过核数只会增加调度开销,QPS 不会涨,反而抬高延迟

2. 一定加 --latency

不加只看到平均值,长尾问题会被完全掩盖

3. 默认长连接

wrk 复用连接,与 ab 不加 -k 的结果没有可比性,对比时要说明

4. 脚本化才真实

固定 URL 容易命中缓存,用 Lua 随机路径与参数化 body 才有参考价值

5. 先看错误数再看 QPS

Socket errors 与 Non-2xx 非 0 时,QPS 数字没有意义

6. 压测机也要监控

客户端 CPU、句柄、端口、带宽任一瓶颈都会让结论失真

共 121 条 wrk 命令 · 示例中的域名、并发与脚本路径请替换为实际环境

关于wrk命令速查

在线 wrk 命令速查手册,按安装与版本、基础压测、Lua 脚本与动态请求、结果字段解读、POST 与鉴权场景、进阶用法、输出采集与对比、系统调优与观测、与其他压测工具对比、常见报错与排查等 10 类场景整理 110 余条常用命令、脚本片段与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 wrk -v 与 apt/yum/brew/docker 安装与源码编译、-t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 延迟分布 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M 与时间单位 2s/1m、Lua 脚本的 wrk.method/wrk.body/wrk.headers/wrk.path 与 request() 动态生成与 init(args)/setup(thread)/done(summary, latency, requests) 钩子 与 wrk.format() 与 thread:set/thread:get 与 math.random 参数化 与 latency:percentile(99) 与 summary.errors.connect/read/write/status/timeout 与 io.open 读取请求体,以及 Latency/Req/Sec/Socket errors/Requests/sec/Transfer/sec/Latency Distribution 的 50%/75%/90%/99% 分位与 Non-2xx or 3xx responses 逐项解读、keep-alive 默认行为的说明、https 与自签证书、随机参数绕过缓存、多接口链路用 k6/JMeter 补充,还有 ulimit -n 与 tcp_tw_reuse 与 ss -s 与 sar -n DEV 1 与 top -H 的压测机观测方法,以及 Connection refused、connect 大量错误(本地端口耗尽)、read/write/timeout 错误、error loading script、attempt to index a nil value、undefined symbol SSL、command not found、QPS 上不去、threads 超核数无收益 等报错排查。适用于 HTTP 接口吞吐与延迟基线测试、Nginx 与网关调优前后对比、多线程高并发压测、POST JSON 与鉴权接口压测、P99 长尾分析、容量评估与压测报告采集,以及运维、测试与后端工程师面试复习。

核心能力

  • 涵盖 wrk -v 与 apt/yum/brew/docker 安装与源码编译、-t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 延迟分布 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M 与时间单位 2s/1m、Lua 脚本的 wrk.method/wrk.body/wrk.headers/wrk.path 与 request() 动态生成与 init(args)/setup(thread)/done(summary, latency, requests) 钩子 与 wrk.format() 与 thread:set/thread:get 与 math.random 参数化 与 latency:percentile(99) 与 summary.errors.connect/read/write/status/timeout 与 io.open 读取请求体,以及 Latency/Req/Sec/Socket errors/Requests/sec/Transfer/sec/Latency Distribution 的 50%/75%/90%/99% 分位与 Non-2xx or 3xx responses 逐项解读、keep-alive 默认行为的说明、https 与自签证书、随机参数绕过缓存、多接口链路用 k6/JMeter 补充,还有 ulimit -n 与 tcp_tw_reuse 与 ss -s 与 sar -n DEV 1 与 top -H 的压测机观测方法,以及 Connection refused、connect 大量错误(本地端口耗尽)、read/write/timeout 错误、error loading script、attempt to index a nil value、undefined symbol SSL、command not found、QPS 上不去、threads 超核数无收益 等报错排查

适用场景

适用于 HTTP 接口吞吐与延迟基线测试、Nginx 与网关调优前后对比、多线程高并发压测、POST JSON 与鉴权接口压测、P99 长尾分析、容量评估与压测报告采集,以及运维、测试与后端工程师面试复习。wrk命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

wrk命令速查是免费的吗?需要注册或安装吗?
wrk命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
wrk命令速查支持哪些功能?
涵盖 wrk -v 与 apt/yum/brew/docker 安装与源码编译、-t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 延迟分布 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M 与时间单位 2s/1m、Lua 脚本的 wrk.method/wrk.body/wrk.headers/wrk.path 与 request() 动态生成与 init(args)/setup(thread)/done(summary, latency, requests) 钩子 与 wrk.format() 与 thread:set/thread:get 与 math.random 参数化 与 latency:percentile(99) 与 summary.errors.connect/read/write/status/timeout 与 io.open 读取请求体,以及 Latency/Req/Sec/Socket errors/Requests/sec/Transfer/sec/Latency Distribution 的 50%/75%/90%/99% 分位与 Non-2xx or 3xx responses 逐项解读、keep-alive 默认行为的说明、https 与自签证书、随机参数绕过缓存、多接口链路用 k6/JMeter 补充,还有 ulimit -n 与 tcp_tw_reuse 与 ss -s 与 sar -n DEV 1 与 top -H 的压测机观测方法,以及 Connection refused、connect 大量错误(本地端口耗尽)、read/write/timeout 错误、error loading script、attempt to index a nil value、undefined symbol SSL、command not found、QPS 上不去、threads 超核数无收益 等报错排查。
wrk命令速查适合哪些场景使用?
适用于 HTTP 接口吞吐与延迟基线测试、Nginx 与网关调优前后对比、多线程高并发压测、POST JSON 与鉴权接口压测、P99 长尾分析、容量评估与压测报告采集,以及运维、测试与后端工程师面试复习。