iperf3-compatible network throughput measurement tool, written in pure MoonBit
| 客户端 | 服务器 | TCP P1 | TCP P2 | TCP P3 | UDP | -J | -O | -n |
|---|---|---|---|---|---|---|---|---|
| iperf3 | mooniperf | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| mooniperf | iperf3 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 组合(发送方 → 接收方) | TCP P1 | TCP P4(每流 / 合计) |
|---|---|---|
| iperf3 → iperf3 | 11–14 Gbits/sec | 5.3 G ×4 ≈ 21 G |
| mooniperf → iperf3 | 14.6 Gbits/sec | 5.1–5.3 G ×4 ≈ 21 G |
| iperf3 → mooniperf | 19.6–21.4 Gbits/sec | 5.2 G ×4 ≈ 21 G |
| mooniperf → mooniperf | 20.2–20.8 Gbits/sec | — |
| 目标速率 | mooniperf 实测 | iperf3 实测 | 丢包 | 抖动 |
|---|---|---|---|---|
| 1 Mbit/s | 981–988 Kbits/sec | 973–979 Kbits/sec | 0 | 0.000 ms(回环) |
| 100 Mbit/s | 98.5 Mbits/sec | 102 Mbits/sec | 0 | 0.000 ms(回环) |
| 类别 | 用例 | 结果 |
|---|---|---|
| 抗异常输入 | 控制端口灌垃圾字节 ×2、无 cookie 即断开 ×3 | 服务器无崩溃,后续测试正常 |
| 极端块长 | TCP -l 64、TCP -l 1048576(1 MiB)、UDP -l 1200,双向对真实 iperf3 | 全通过 |
| 极端速率 | UDP -b 500K(低于默认)、-b 200M(成批发送),双向 | 全通过 |
| 传输上限 | -n 32M、-k 5000(TCP 双向)、UDP -n 8M 跨实现 | 全通过 |
| 报告参数 | -i 0.5 小数间隔 + -O 1 预热,自互通 | 通过 |
| CLI 误用 | 连不上端口、-b 垃圾值、-s -c 同用、缺模式、-i 0、UDP -l 4 | 均以非零退出码拒绝 |
# 从 mooncakes 安装(作为库/CLI 依赖)
moon add yiii0012/mooniperf
# 或从源码构建运行
moon run cmd/main -- -s -p 5201 # 终端 1:启动服务器
moon run cmd/main -- -c 127.0.0.1 -p 5201 -t 2 # TCP 测试
moon run cmd/main -- -c 127.0.0.1 -p 5201 -u -b 2M -t 2 # UDP 2 Mbit/s
moon run cmd/main -- -c 127.0.0.1 -p 5201 -t 2 -J # JSON 输出
# 与真实 iperf3 互操作
iperf3 -s -p 5201
moon run cmd/main -- -c <iperf3-host> -p 5201 -t 10-s, --server 服务器模式
-c, --client <host> 客户端模式,连接 <host>
-p, --port <n> 端口(默认 5201)
-t, --time <n> 测试时长/秒(默认 10)
-i, --interval <n> 报告间隔/秒(默认 1)
-P, --parallel <n> 并行数据连接数(TCP,默认 1;UDP 单流)
-u, --udp 使用 UDP
-b, --bitrate <n>[KMGT] 目标速率 bits/s(UDP 默认 1M,`-b 0` 不限速;TCP 同样生效)
-l, --len <n> 块大小(TCP 默认 131072,UDP 8192)
-n, --bytes <n> 发送 n 字节后停止
-k, --blockcount <n> 发送 n 块后停止
-O, --omit <n> 剔除前 n 秒(预热)
-w, --window <n> 窗口大小(接受但未生效,需 setsockopt FFI)
--get-server-output 回收服务器摘要(文本模式打印,-J 内嵌报告)
-J, --json JSON 输出(iperf3 报告结构)
-v, --version 版本
-h, --help 帮助moon check # 类型检查(0 警告)
moon test # 36 个单元测试(协议编解码、RFC 1889 抖动、边界与格式化)
moon build # 构建 CLIctl/ iperf3 线上协议:状态字节、JSON 封帧、参数/结果编解码、cookie、UDP 头
stats/ 吞吐区间统计、RFC 1889 抖动与丢包、UDP 步进限速
report/ iperf3 风格的人类可读输出
wire/ 控制通道 socket I/O 封装
server/ 测试服务器(接收/反向发送)
client/ 测试客户端(发送/反向接收、报告、-J JSON)
cmd/main CLI 入口Install
Download zipiperf3-compatible network throughput measurement tool, written in pure MoonBit