Iperf3.1.3使用手册


  1. 概述iperf3是iperf的3.1.3版本,是一款网络测试工具,可以测试网络的最大 吞吐量,比特率、重发包数还有拥塞包大小等,是一款极其轻便,简单易用的一款测试工具。并且提供多平台的支持,支持Linux、Windows、Android、Mac、Iphone等平台。
    Iperf是基于命令行的,Ixchariot是图形界面。
  2. 下载https://iperf.fr/iperf-download.php#windows
  3. 命令说明解压到c:\ iperf-3.1.3-win64,有两个文件iperf3.exe、cygwin1.dll
    iperf为C/S架构,命令行中运行。

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

    参数解释

    服务端和客户端共性:
    -p 服务端口,默认端口为5201, 注意防火墙开放
    -f 测试结果的单位(kbits,Mbits,KBytes,MBytes)
    -F 指定文件来发送数据
    -i设置每次报告之间的时间间隔,单位为秒
    -B多网卡机器可指定出栈接口
    -V 更详细的输出
    查看版本信息
    -h 帮助信息

    服务端特性:
    -s 服务端
    -D后台运行

    客户端特性:
    -c 客户端模式
    -u使用UDP模式
    -b使用带宽,默认值是1 Mbit/sec
    -t设置传输的总时间,默认10s
    -p 设置端口与服务端的监听端口一致
    -P多线程
    -R反向测试,从目的端主机向本地发送数据
    -n 参数指定要传输的数据量
  4. 示例4.1示例1
    服务器端:
    iperf3 s -u -i 1 -p 2222 >log.txt
    -s服务端,-u udp模式,-i报告时间间隔,-p服务端口号
    客户端:
    iperf3 -c 192.168.0.1 -i 1 -t 4 -p 2222
    -c客户端连接服务端地址,-i报告时间间隔,-t总时长,-p设置端口与服务端的监听端口一致
    4.2示例2
    iperf3.exe -s
    iperf3.exe -c 127.0.0.1 -t 10
    4.3示例3
    iperf3.exe -c 127.0.0.1 -F d:\win7.iso -t 10

  5. 帮助

C:\iperf-3.1.3-win64>iperf3.exe /?

iperf3: parameter error - must either be a client (-c) or server (-s)


Usage: iperf [-s|-c host] [options]

iperf [-h|--help] [-v|--version]


Server or Client:

-p, --port # server port to listen on/connect to

-f, --format [kmgKMG] format to report: Kbits, Mbits, KBytes, MBytes

-i, --interval # seconds between periodic bandwidth reports

-F, --file name xmit/recv the specified file

-B, --bind <host> bind to a specific interface

-V, --verbose more detailed output

-J, --json output in JSON format

--logfile f send output to a log file

-d, --debug emit debugging output

-v, --version show version information and quit

-h, --help show this message and quit

Server specific:

-s, --server run in server mode

-D, --daemon run the server as a daemon

-I, --pidfile file write PID file

-1, --one-off handle one client connection then exit

Client specific:

-c, --client <host> run in client mode, connecting to <host>

-u, --udp use UDP rather than TCP

-b, --bandwidth #[KMG][/#] target bandwidth in bits/sec (0 for unlimited)

(default 1 Mbit/sec for UDP, unlimited for TCP)

(optional slash and packet count for burst mode)

-t, --time # time in seconds to transmit for (default 10 secs)

-n, --bytes #[KMG] number of bytes to transmit (instead of -t)

-k, --blockcount #[KMG] number of blocks (packets) to transmit (instead of -t or -n)

-l, --len #[KMG] length of buffer to read or write

(default 128 KB for TCP, 8 KB for UDP)

--cport <port> bind to a specific client port (TCP and UDP, default: ephemeral port)

-P, --parallel # number of parallel client streams to run

-R, --reverse run in reverse mode (server sends, client receives)

-w, --window #[KMG] set window size / socket buffer size

-M, --set-mss # set TCP/SCTP maximum segment size (MTU - 40 bytes)

-N, --no-delay set TCP/SCTP no delay, disabling Nagle's Algorithm

-4, --version4 only use IPv4

-6, --version6 only use IPv6

-S, --tos N set the IP 'type of service'

-Z, --zerocopy use a 'zero copy' method of sending data

-O, --omit N omit the first n seconds

-T, --title str prefix every output line with this string

--get-server-output get results from server

--udp-counters-64bit use 64-bit counters in UDP test packets


[KMG] indicates options that support a K/M/G suffix for kilo-, mega-, or giga-


iperf3 homepage at: http://software.es.net/iperf/

Report bugs to: https://github.com/esnet/iperf