iperf 命令

介绍

iperf 是一个 Linux 网络性能测试命令行工具。可用于测试 TCP 和 UDP 带宽质量,例如最大 TCP 带宽等多种参数特性,报告带宽、延迟抖动和数据包丢失。因此,我们常常利用 iperf 工具来来测试一些网络设备的性能,如路由器、防火墙、交换机等。

Linux 系统通常默认不安装 iperf 工具,在 Debian/Ubuntu 系统上可以使用如下命令进行安装。

sudo apt install iperf

另外还有一个 iperf3 工具,和 iperf 的区别是它不支持双工模式测试。

语法

iperf [-s|-c host] [options]
iperf [-h|--help] [-v|--version]

选项

  • -f, --format [abkmgBKMG]:格式化带宽数输出。每个字母分别对应:adaptive、bits、Bytes、Kbits、Mbits、Gbits、KBytes、MBytes、GBytes,默认参数是 a,即自适应。值得注意的是,在计算字节 byte 时,Kilo = 1024,Mega = 1024^2,Giga = 1024^3。通常在网络中,Kilo = 1000,Mega = 1000^2,Giga = 1000^3,所以 iperf 也按此来计算比特(位)。如果这些困扰了你,那么请使用 -f b 参数,然后亲自计算一下。
  • -i, --interval:设置每次报告之间的时间间隔,单位为秒。如果设置为非零值,就会按照此时间间隔输出测试报告。默认值为零。
  • -l, --len n[kmKM]:设置读写缓冲区的长度。TCP 方式默认为 8KB,UDP 方式默认为 1470 字节。
  • -m, --print_mss:输出 TCP 的 MSS 值(MSS 全称是 maximum segment size,通过 TCP_MAXSEG 支持)。通常情况下,MSS 值比 MTU 值小 40 字节。
  • -p, --port:设置端口,与服务器端的监听端口一致。默认使用 5001 端口。
  • -u, --udp:使用 UDP 方式而不是 TCP 方式。
  • -w, --window n[kmKM]:设置套接字缓冲区为指定大小。对于 TCP 方式,此设置为 TCP 窗口大小。对于 UDP 方式,此设置为接受 UDP 数据包的缓冲区大小,限制可以接受数据包的最大值。
  • -B, --bind host:绑定到主机的多个地址中的一个。对于客户端来说,这个参数设置了出栈接口。对于服务器端来说,这个参数设置入栈接口。这个参数只用于具有多网络接口的主机。在 iperf 的 UDP 模式下,此参数用于绑定和加入一个多播组。使用范围在 224.0.0.0 至 239.255.255.255 的多播地址。
  • -C, --compatibility:与低版本的 iperf 使用时,可以使用兼容模式。不需要两端同时使用兼容模式,但是强烈推荐两端同时使用兼容模式。某些情况下,使用某些数据流可以引起1.7版本的服务器端崩溃或引起非预期的连接尝试。
  • -M, --mss:ip 头减去 40 字节。在以太网中,MSS 值为 1460 字节(MTU 值为 1500 字节)。
  • -N, --nodelay:设置 TCP 无延迟选项,禁用 Nagle’s 运算法则。通常情况此选项对于交互程序,例如 telnet,是禁用的。
  • -V, --ipv6_domain:绑定一个 IPv6 地址。 注意,在 1.6.3 或更高版本中,指定 IPv6 地址不需要使用 -B 参数绑定,在 1.6 之前的版本则需要。在大多数操作系统中,将响应 IPv4 客户端映射的 IPv4 地址。
  • -h, --help:显示命令行参考并退出。
  • -v, --version:显示版本信息和编译信息并退出。

服务器端专用选项

  • -s, --server:iperf 服务器模式 。
  • -D:Unix 平台下 iperf 作为后台守护进程运行。在 Win32 平台下,iperf 将作为服务运行。
  • -R:卸载 iperf 服务(如果它在运行),仅用于 Windows 系统。
  • -o:重定向输出到指定文件,仅用于 Windows 系统。
  • -c, --client host:如果 iperf 运行在服务器模式,并且用 -c 参数指定一个主机,那么 iperf 将只接受指定主机的连接。此参数不能工作于 UDP 模式。
  • -P, --parallel:服务器关闭之前保持的连接数。默认是 0,这意味着永远接受连接。

客户端专用选项

  • -b, --bandwidth n[kmgKMG]:UDP 模式使用的带宽,单位 bits/sec。此选项与 -u 选项相关。默认值是 1 Mbit/sec。
  • -c, --client host:运行 iperf 的客户端模式,连接到指定的 iperf 服务器端。
  • -d, --dualtest:运行双测试模式。这将使服务器端反向连接到客户端,使用 -L 参数中指定的端口(或默认使用客户端连接到服务器端的端口)。如果你想要一个交互的测试,请尝试 -r 参数。
  • -n, --num n[kmKM]:传送的缓冲器数量。通常情况,iperf 按照 10 秒钟发送数据。-n 参数跨越此限制,按照指定次数发送指定长度的数据,而不论该操作耗费多少时间。参考 -l-t 选项。
  • -r, --tradeoff:往复测试模式。当客户端到服务器端的测试结束时,服务器端通过 -l 选项指定的端口(或默认为客户端连接到服务器端的端口),反向连接至客户端。当客户端连接终止时,反向连接随即开始。如果需要同时进行双向测试,请尝试 -d 参数。
  • -t, --time:设置传输的总时间。iperf 在指定的时间内,重复的发送指定长度的数据包。默认是 10 秒钟。参考 -l-n 选项。
  • -L, --listenport:指定服务端反向连接到客户端时使用的端口。默认使用客户端连接至服务端的端口。
  • -P, --parallel:指定客户端与服务端之间使用的线程数,默认是 1 线程。需要客户端与服务器端同时使用此参数。
  • -S, --tos:出栈数据包的服务类型,不过许多路由器都忽略 TOS 字段。你可以指定这个值,使用以 “0x” 开始的 16 进制数,或以 “0” 开始的 8 进制数或 10 进制数。例如,十六进制 ‘0x10’ = 八进制 ‘020’ = 十进制 ’16’。
  • -T, --ttl:出栈多播数据包的 TTL 值。这本质上就是数据通过路由器的跳数。默认是 1,链接本地。
  • -F:使用特定的数据流测量带宽,例如指定的文件。

示例

UDP 模式

启动 UDP 服务器端

iperf -u -s

启动 UDP 客户端,以 100Mbps 为数据发送速率,测试时间为 60 秒。

iperf -u -c 192.168.0.1 -b 100M -t 60

在 UDP 模式下,以 100M 为数据发送速率,进行上下行带宽测试。

iperf -u -c 192.168.0.1 -b 100M -d -t 60

在 UDP 模式下,客户端同时向服务器端发起 30 个连接线程,以 5Mbps 为数据发送速率。

iperf -u -c 192.168.0.1 -b 5M -P 30 -t 60

TCP 模式

启动 TCP 服务器端

iperf -s

启动 TCP 客户端,连接到 192.168.0.1 服务器,进行上传带宽测试,测试时间为 60 秒。

iperf -c 192.168.0.1 -t 60

在 TCP 模式下,进行上下行带宽测试。

iperf -c 192.168.0.1 -d -t 60

在 TCP 模式下,客户端同时向服务器端发起 30 个连接线程。

iperf -c 192.168.0.1 -P 30 -t 60