Iperf使用方法与参数说明

Iperf是一个网络性能测试工具。可以测试TCP和UDP带宽质量，可以测量最大TCP带宽，具有多种参数和UDP特性，可以报告带宽，延迟抖动和数据包丢失。Iperf在linux和windows平台均有二进制版本供自由使用。



Iperf was developed by NLANRDAST as a modern alternative for measuring maximum TCP and UDP bandwidth performance. Iperf allows the tuning of various parameters and UDP characteristics. Iperf reports bandwidth, delay jitter, datagram loss.



Iperf使用方法与参数说明



参数说明

-s 以server模式启动，eg：iperf -s

-c host以client模式启动，host是server端地址，eg：iperf -c 222.35.11.23



通用参数

-f [kmKM] 分别表示以Kbits, Mbits, KBytes, MBytes显示报告，默认以Mbits为单位,eg：iperf -c 222.35.11.23 -f K

-i sec 以秒为单位显示报告间隔，eg：iperf -c 222.35.11.23 -i 2

-l 缓冲区大小，默认是8KB,eg：iperf -c 222.35.11.23 -l 16

-m 显示tcp最大mtu值

-o 将报告和错误信息输出到文件eg：iperf -c 222.35.11.23 -o ciperflog.txt

-p 指定服务器端使用的端口或客户端所连接的端口eg：iperf -s -p 9999;iperf -c 222.35.11.23 -p 9999

-u 使用udp协议

-w 指定TCP窗口大小，默认是8KB

-B 绑定一个主机地址或接口（当主机有多个地址或接口时使用该参数）

-C 兼容旧版本（当server端和client端版本不一样时使用）

-M 设定TCP数据包的最大mtu值

-N 设定TCP不延时

-V 传输ipv6数据包



server专用参数

-D 以服务方式运行iperf，eg：iperf -s -D

-R 停止iperf服务，针对-D，eg：iperf -s -R



client端专用参数

-d 同时进行双向传输测试

-n 指定传输的字节数，eg：iperf -c 222.35.11.23 -n 100000

-r 单独进行双向传输测试

-t 测试时间，默认10秒,eg：iperf -c 222.35.11.23 -t 5

-F 指定需要传输的文件

-T 指定ttl值



应用实例

使用 iperf -s 命令将 Iperf 启动为 server 模式，在客户机上使用 iperf -c启动client模式。

iperf –s

------------------------------------------------------------

Server listening on TCP port 5001

TCP window size: 8.00 KByte (default)

------------------------------------------------------------



iperf -c 59.128.103.56

上面使用服务端和客户端的默认设置进行测试



iperf -s -w 300K

------------------------------------------------------------

Server listening on TCP port 5001

TCP window size:  300 KByte

------------------------------------------------------------



iperf -c 59.128.103.56 -f K -i 2 -w 300K

       设定报告间隔为2秒，服务器端和客户端的TCP窗口都开到300KB



iperf -c 59.128.103.56 -f K -i 2 -w 300K –n 1000000

测试传输约1MB数据



iperf -c 59.128.103.56 -f K -i 2 -w 300K –t 36

测试持续36秒



iperf -c 59.128.103.56 -f K -i 2 -w 300K -n 10400000 –d

测试双向的传输



iperf -c 59.128.103.56 -f K -i 2 -w 300K –u

UDP测试



其中 -i 参数的含义是周期性报告的时间间隔（interval），单位为秒；在上面的例子中，表示每隔2秒报告一次带宽等信息。



启动一个iperf服务器进程

　　首先要介绍的命令用来启动iperf服务器监听进程以便监听客户端连接的。命令如下：

　　iperf.exe -s -P 2 -i 5 -p 5999 -f k

　　这个命令会启动iperf，后续参数用来设定监听5999 端口(默认端口是5001), 限定iperf只允许两个连接，每5秒汇报一次连接情况。连接限制参数(-P参数)非常重要，当两个连接建立后，服务器进程就会退出。如果这个参数设定为0，那么iperf 进程将持续监听端口，并且不限制连接数量。在 Windows主机上键入该命令，会显示出如图A所示界面

　　图 A

　　
简单的iperf命令 实现快速网络检测



　　启动一个iperf 客户端连接

　　iperf 的另一半就是客户端，用来连接到服务器监听端口。比如我们要连接到一台叫做 s-network1.amcs.tld 的服务器，端口为5999，连接60 秒并且每5秒显示一次状态，命令行如下：

　　iperf.exe -c s-network1.amcs.tld -P 1 -i 5 -p 5999 -f B -t 60 -T 1

　　命令启动后，s-network1 主机被用来进行网络性能检测。与Jperf GUI 界面提供的漂亮图形不同， iperf只会根据测量参数简单的报告网络带宽状况，在本例中是以 比特为单位(-f 参数)进行带宽表示的。图B显示了远程客户端与s-network1主机间的带宽性能。

　　图 B

　　
简单的iperf命令 实现快速网络检测



　　为了应对日常便捷应用的需求，我们可以建立一个 .bat批处理文件，届时填入服务器名称即可实现快速检测。以下为实际使用的拷屏：

C:\jperf\jperf\bin>iperf
Usage: iperf [-s|-c host] [options]
Try `iperf --help' for more information.

C:\jperf\jperf\bin>iperf --help
Usage: iperf [-s|-c host] [options]
       iperf [-h|--help] [-v|--version]

Client/Server:
  -f, --format    [kmKM]   format to report: Kbits, Mbits, KBytes, MBytes
  -i, --interval  #        seconds between periodic bandwidth reports
  -l, --len       #[KM]    length of buffer to read or write (default 8 KB)
  -m, --print_mss          print TCP maximum segment size (MTU - TCP/IP header)
  -o, --output    <filename> output the report or error message to this specified file
  -p, --port      #        server port to listen on/connect to
  -u, --udp                use UDP rather than TCP
  -w, --window    #[KM]    TCP window size (socket buffer size)
  -B, --bind      <host>   bind to <host>, an interface or multicast address
  -C, --compatibility      for use with older versions does not sent extra msgs
  -M, --mss       #        set TCP maximum segment size (MTU - 40 bytes)
  -N, --nodelay            set TCP no delay, disabling Nagle's Algorithm
  -V, --IPv6Version        Set the domain to IPv6

Server specific:
  -s, --server             run in server mode
  -D, --daemon             run the server as a daemon
  -R, --remove             remove service in win32

Client specific:
  -b, --bandwidth #[KM]    for UDP, bandwidth to send at in bits/sec
                           (default 1 Mbit/sec, implies -u)
  -c, --client    <host>   run in client mode, connecting to <host>
  -d, --dualtest           Do a bidirectional test simultaneously
  -n, --num       #[KM]    number of bytes to transmit (instead of -t)
  -r, --tradeoff           Do a bidirectional test individually
  -t, --time      #        time in seconds to transmit for (default 10 secs)
  -F, --fileinput <name>   input the data to be transmitted from a file
  -I, --stdin              input the data to be transmitted from stdin
  -L, --listenport #       port to recieve bidirectional tests back on
  -P, --parallel  #        number of parallel client threads to run
  -T, --ttl       #        time-to-live, for multicast (default 1)

Miscellaneous:
  -h, --help               print this message and quit
  -v, --version            print version information and quit

[KM] Indicates options that support a K or M suffix for kilo- or mega-

The TCP window size option can be set by the environment variable
TCP_WINDOW_SIZE. Most other options can be set by an environment variable
IPERF_<long option name>, such as IPERF_BANDWIDTH.