iperf3是一款带宽测试工具，它支持调节各种参数，比如通信协议，数据包个数，发送持续时间，测试完会报告网络带宽，丢包率和其他参数。

写在前面：带宽和吞吐量

计算机网络中的"带宽"和"吞吐量"两个词容易混淆，区别如下：

• 网络带宽（bandwidth）：强调网络最大的数据传输速率，即传输数据率理论峰值。
• 网络吞吐量（throughput）：强调网络实际的数据传输速率。

安装

Ubuntu20.04 LTS：

sudo apt install iperf3

使用

假设两台电脑A和B：
A的IP地址：192.168.77.1
B的IP地址：192.168.77.2

测试TCP吞吐量

1. 先让A做server端，开启iperf服务器模式，指定TCP端口1314：

iperf3 -s -i 1 -p 1314

其中-i表示报告的时间间隔

2. 然后打开B做client端，连接服务器端1314端口:

iperf3 -c 192.168.77.1 -i 1 -t 60 -p 1314

经过60秒后，client端得到结果如下图

服务器监听1314端口得到的结果如下图:

其中：

• Interval表示时间间隔。
• Transfer表示时间间隔里面转输的数据量。
• Bandwidth是时间间隔里的传输速率。

测试UDP吞吐量

1. A做server端，开启iperf服务器模式

iperf3 -s -i 1 -p 1314

2. B做client端启动iperf的客户端模式，连接服务器端

iperf3 -u -c 192.168.77.1 -b 100m -t 60 -p 1314

其中
-u, --udp，以 UDP 协议进行测试；
-b, --bandwidth，限制测试带宽。UDP 默认为 1Mbit/秒，TCP 默认无限制。

服务器端结果：

客户端结果：

测试上下行带宽（TCP双向传输）

服务器端：

iperf3 -s

客户端：

iperf3 -c 192.168.77.1 -d -t 60

其中-d表示以debug模式输出结果

服务器端：

客户端：

测试多线程TCP吞吐量

服务器端：

iperf3 -s

客户端：

iperf3 -c 192.168.77.1 -P 30 -t 60

其中-P, --parallel，测试数据流并发数量

如果没有指定发送方式，iPerf客户端只会使用单线程。

server端：

client端：

测试上下行带宽（UDP双向传输）

服务器端：

iperf3 -s

客户端：

iperf3 -u -c 192.168.77.1 -b 100M -d -t 60

其中-d表示以debug模式输出结果

测试多线程UDP吞吐量

服务器端：

iperf3 -s

客户端：

iperf3 -u -c 192.168.77.1 -b 5M -P 30 -t 60

iperf3常用参数

执行iperf3 -h可以查看所有的命令信息

通用参数

-p, --port Server 端监听、Client 端连接的端口号；

-f, --format [kmgKMG]，报告中所用的数据单位，Kbits, Mbits, KBytes, Mbytes；

-i, --interval #，每次报告的间隔，单位为秒；

-F, --file name，测试所用文件的文件名。如果使用在 Client 端，发送该文件用作测试；如果使用在 Server 端，则是将数据写入该文件，而不是丢弃；

-A, --affinity n/n,m，设置 CPU 亲和力；

-B, --bind ，绑定指定的网卡接口；

-V, --verbose，运行时输出更多细节；

-J, --json，运行时以 JSON 格式输出结果；

--logfile f，输出到文件；

-d, --debug，以 debug 模式输出结果；

-v, --version，显示版本信息并退出；

-h, --help，显示帮助信息并退出。

server端参数

-s, --server，以 Server 模式运行；

-D, --daemon，在后台以守护进程运行；

-I, --pidfile file，指定 pid 文件；

-1, --one-off，只接受 1 次来自 Client 端的测试，然后退出。

client端参数

-c, --client ，以 Client 模式运行，并指定 Server 端的地址；

-u, --udp，以 UDP 协议进行测试；

-b, --bandwidth #[KMG][/#]，限制测试带宽。UDP 默认为 1Mbit/秒，TCP 默认无限制；

-t, --time #，以时间为测试结束条件进行测试，默认为 10 秒；

-n, --bytes #[KMG]，以数据传输大小为测试结束条件进行测试；

-k, --blockcount #[KMG]，以传输数据包数量为测试结束条件进行测试；

-l, --len #[KMG]，读写缓冲区的长度，TCP 默认为 128K，UDP 默认为 8K；

--cport ，指定 Client 端运行所使用的 TCP 或 UDP 端口，默认为临时端口；

-P, --parallel #，测试数据流并发数量；

-R, --reverse，反向模式运行（Server 端发送，Client 端接收）；

-w, --window #[KMG]，设置套接字缓冲区大小，TCP 模式下为窗口大小；

-C, --congestion ，设置 TCP 拥塞控制算法（仅支持 Linux 和 FreeBSD ）；

-M, --set-mss #，设置 TCP/SCTP 最大分段长度（MSS，MTU 减 40 字节）；

-N, --no-delay，设置 TCP/SCTP no delay，屏蔽 Nagle 算法；

-4, --version4，仅使用 IPv4；

-6, --version6，仅使用 IPv6；

-S, --tos N，设置 IP 服务类型（TOS，Type Of Service）；

-L, --flowlabel N，设置 IPv6 流标签（仅支持 Linux）；

-Z, --zerocopy，使用 “zero copy”（零拷贝）方法发送数据；

-O, --omit N，忽略前 n 秒的测试；

-T, --title str，设置每行测试结果的前缀；

--get-server-output，从 Server 端获取测试结果；

--udp-counters-64bit，在 UDP 测试包中使用 64 位计数器（防止计数器溢出）。