wrk命令速查
安装与基础压测、Lua 脚本动态请求、结果字段解读、POST 与鉴权、进阶用法、系统调优、工具对比与报错排查等 121 条命令
共 121 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk -v | 查看版本与编译特性,确认是否带 SSL | |
wrk | 不带参数输出 usage,是最快的参数速览 | |
apt install wrk | Debian/Ubuntu 安装 | |
yum install wrk | 需先启用 EPEL 源 | |
brew install wrk | macOS 安装 | |
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])
end | init 在每个线程启动时执行,可读环境变量与文件 | |
function setup(thread)
thread:set("id", tid)
end | setup 在创建线程后执行,用于分发参数 | |
function done(summary, latency, requests)
print(latency:percentile(99))
end | done 在主线程结束前执行,可自定义输出报表 | |
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/api | POST 建议用脚本方式,参数更可控 | |
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/2 | HTTP/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 ab | wrk 多线程更能跑满压测机,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 url | Go 实现,参数直观,输出分位清晰 | |
vegeta attack -rate=200 -duration=30s -targets=t.txt | vegeta report | 恒定速率压测,适合做容量与 SLA 验证 | |
k6 run script.js | 现代脚本化压测,支持场景编排与阈值断言 | |
locust -f locustfile.py --headless -u 200 -r 20 | Python 场景编排,可分布式的 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 value | wrk.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%"; donepost.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 关键指标wrk2 -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、句柄、端口、带宽任一瓶颈都会让结论失真
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 长尾分析、容量评估与压测报告采集,以及运维、测试与后端工程师面试复习。