LiveWrk

livewrk 是一个面向 WHIP/WHEP 端点的负载测试工具，名字源自 HTTP 压测工具 wrk。它可以对 Live777 实例发起大量并发发布或订阅会话，并输出会话、流量和 RTCP 反馈统计。

使用场景

• 用数百个并发 WHIP 发布者对 Live777 实例做压力测试。
• 用大量 WHEP 订阅者压测单条流的 SFU 扇出路径。
• 在系统承压的同时持续验证媒体仍然可解码（旋转解码验证）。

构建

# whip 子命令和 WHEP 解码验证需要 FFmpeg 开发库（rsmpeg）
cargo build --bin livewrk --features rsmpeg

不带 rsmpeg feature 构建时只有 whep 子命令可用（且不能用 --verify-window）；此时调用 whip 子命令会提示如何重新构建。

用法

发布 100 路合成流（load-0 .. load-99），运行 60 秒：

livewrk whip --whip http://localhost:7777/whip/load --sessions 100 --duration 60

向一条已发布的流发起 100 个订阅会话：

livewrk whep --whep http://localhost:7777/whep/load-0 --sessions 100 --duration 60

whip 子命令会在 URL 最后一段路径上追加 -N，因此每个会话发布独立的流。 whep 请指向其中一条流（例如 load-0）或任意其他已发布的流。

justfile 中提供了现成的配方：

just livewrk-whip 100 60
just livewrk-whep 100 60 load-0

通用选项

两个子命令共用以下选项：

选项	默认值	说明
-w, --whip / --whep	必填	WHIP/WHEP 端点 URL
-t, --token	无	认证使用的 Bearer token
--sessions	100	并发会话数
--ramp-ms	10	每个会话启动之间的间隔（毫秒，爬坡）
--duration	60	总运行时长（秒），到期后会话停止
-v, -vv, -vvv	warn	日志级别：info、debug、trace

whip 选项

whip 子命令发布进程内生成的合成测试图案（与 WhipSynth 相同的引擎），无需外部编码器。

选项	默认值	说明
--vcodec	vp8	视频编码：vp8、vp9、h264、h265、av1
--acodec	无	音频编码：opus、g722（省略表示不发送音频）
--width	640	视频宽度（像素）
--height	480	视频高度（像素）
--fps	30	视频帧率
--stun-server	stun:stun.l.google.com:19302	ICE 收集使用的 STUN 服务器（空字符串表示禁用 STUN）

whep 选项

选项	默认值	说明
--verify-window	无	启用旋转解码验证（每个窗口的秒数）
--verify-tolerant	false	只报告验证失败，不让整个运行失败

旋转解码验证

使用 --verify-window N 时，单个验证器每次只解码一个会话，持续 N 秒后轮换到 下一个活跃会话。解码开销与会话数无关，因此即使大规模运行也能验证 SFU 转发的 媒体始终可解码。被停机截断的窗口不计入统计；如果没有任何一个完整窗口，或存在 失败的窗口，运行将以非零退出码结束（除非指定 --verify-tolerant）。构建中不 支持解码的编码格式会在验证备注中说明，而不是判为失败。

输出

运行结束时 livewrk 会打印汇总：

══════════════════════════════════════════════
  whep loadtest results
  Sessions: 100 total, 100 connected, 0 failed, 0 cancelled, 0 aborted
  Packets: 152340, bytes: 52428800 (52.43 MB)
  Avg connected duration: 58.9s
══════════════════════════════════════════════

媒体写入错误和 RTCP 反馈（NACK/PLI）在非零时显示；whip 运行统计发送的包数， whep 运行统计接收的包数。

退出码

• 0：运行完成（或被第一次 Ctrl-C 中断并完成优雅停机），至少有一个会话连接 成功且验证未失败。
• 1：发生错误、全部会话失败，或解码验证失败且未指定 --verify-tolerant。
• 130：停机过程中第二次 Ctrl-C 强制立即退出。