2024年4月14日发(作者：布如雪)
iperf2 参数详解
一、概述
iperf2是一个网络性能测试工具，用于测量TCP和UDP带宽性能。通过调整不
同的参数，可以模拟不同的网络环境，以测试网络的性能。本文档将详细介绍
iperf2的参数及其使用方法。
二、iperf2参数分类
iperf2的参数可以分为以下几类：
1. 通用参数
2. 服务器端参数
3. 客户端参数
4. 报告参数
5. 其他参数
三、通用参数
-h, --help
显示帮助信息。
-v, --version
显示版本信息。
-i interval
设置报告间隔时间，单位为秒。默认值为1秒。
-f, --file filename
使用指定的文件作为测试数据。默认情况下，iperf2会生成随机数据。
-l, --len length
设置测试数据的长度，单位为字节。默认值为8KB。
-n, --no-delay
禁用Nagle算法。
-t, --time time
设置测试持续时间，单位为秒。默认值为10秒。
-w, --window size
设置TCP窗口大小，单位为字节。默认值为8KB。
四、服务器端参数
-s, --server
以服务器模式运行iperf2。
-p, --port port
设置服务器监听端口。默认值为5201。
-u, --udp
使用UDP协议进行测试。
-B, --bind host
绑定服务器到指定的IP地址或主机名。
-R, --reverse
允许双向测试。服务器会自动转换为客户端，并与原始客户端建立连接。
五、客户端参数
-c, --client server
以客户端模式运行iperf2，并连接到指定的服务器。
-P, --parallel num
设置并行连接数。默认值为1。
-N, --congestion algorithm
设置拥塞控制算法。可选值有："reno", "cubic", "bbr", "vegas"等。默认值为"cubic"。
-b, --bandwidth bandwidth
设置带宽限制，单位为Mbps。默认值为无限制。
-L, --set-load load
设置网络负载百分比。默认值为0（无限制）。
六、报告参数
-j, --json
以JSON格式输出报告。
-J, --json-file filename
将JSON格式的报告保存到指定的文件中。
-T, --testname name
设置测试名称。
-S, --subreport testname
设置子报告名称。
七、其他参数
-M, --msg message
在报告中添加自定义消息。
-D, --debug
启用调试模式。
八、示例
以下是一些使用iperf2进行网络性能测试的示例：
1. 服务器端运行：
iperf2 -s -p 5201 -u -B [ip-address]
2. 客户端运行：
iperf2 -c [ip-address] -p 5201 -t 30 -i 1 -f testfile -N reno -w 16K -P 4 -b 100M
-L 50 -T Test1 -S SubTest1 -M "Custom message" -D
3. 客户端运行，并以JSON格式输出报告：
iperf2 -c [ip-address] -p 5201 -t 30 -i 1 -f testfile -N reno -w 16K -P 4 -b 100M
-L 50 -T Test1 -S SubTest1 -M "Custom message" -D -j -J
2024年4月14日发(作者：布如雪)
iperf2 参数详解
一、概述
iperf2是一个网络性能测试工具，用于测量TCP和UDP带宽性能。通过调整不
同的参数，可以模拟不同的网络环境，以测试网络的性能。本文档将详细介绍
iperf2的参数及其使用方法。
二、iperf2参数分类
iperf2的参数可以分为以下几类：
1. 通用参数
2. 服务器端参数
3. 客户端参数
4. 报告参数
5. 其他参数
三、通用参数
-h, --help
显示帮助信息。
-v, --version
显示版本信息。
-i interval
设置报告间隔时间，单位为秒。默认值为1秒。
-f, --file filename
使用指定的文件作为测试数据。默认情况下，iperf2会生成随机数据。
-l, --len length
设置测试数据的长度，单位为字节。默认值为8KB。
-n, --no-delay
禁用Nagle算法。
-t, --time time
设置测试持续时间，单位为秒。默认值为10秒。
-w, --window size
设置TCP窗口大小，单位为字节。默认值为8KB。
四、服务器端参数
-s, --server
以服务器模式运行iperf2。
-p, --port port
设置服务器监听端口。默认值为5201。
-u, --udp
使用UDP协议进行测试。
-B, --bind host
绑定服务器到指定的IP地址或主机名。
-R, --reverse
允许双向测试。服务器会自动转换为客户端，并与原始客户端建立连接。
五、客户端参数
-c, --client server
以客户端模式运行iperf2，并连接到指定的服务器。
-P, --parallel num
设置并行连接数。默认值为1。
-N, --congestion algorithm
设置拥塞控制算法。可选值有："reno", "cubic", "bbr", "vegas"等。默认值为"cubic"。
-b, --bandwidth bandwidth
设置带宽限制，单位为Mbps。默认值为无限制。
-L, --set-load load
设置网络负载百分比。默认值为0（无限制）。
六、报告参数
-j, --json
以JSON格式输出报告。
-J, --json-file filename
将JSON格式的报告保存到指定的文件中。
-T, --testname name
设置测试名称。
-S, --subreport testname
设置子报告名称。
七、其他参数
-M, --msg message
在报告中添加自定义消息。
-D, --debug
启用调试模式。
八、示例
以下是一些使用iperf2进行网络性能测试的示例：
1. 服务器端运行：
iperf2 -s -p 5201 -u -B [ip-address]
2. 客户端运行：
iperf2 -c [ip-address] -p 5201 -t 30 -i 1 -f testfile -N reno -w 16K -P 4 -b 100M
-L 50 -T Test1 -S SubTest1 -M "Custom message" -D
3. 客户端运行，并以JSON格式输出报告：
iperf2 -c [ip-address] -p 5201 -t 30 -i 1 -f testfile -N reno -w 16K -P 4 -b 100M
-L 50 -T Test1 -S SubTest1 -M "Custom message" -D -j -J