网络测试工具——iperf3使用说明
iperf3是一款带宽测试工具，它支持调节各种参数，比如通信协议，数据包个数，发送持续时间，测试完会报告网络带宽，丢包率和其它参数。
环境
| 角色 | IPv4地址 |
|---|---|
| 服务器 | 192.168.3.250 |
| 客户端 | 192.168.3.95 |
TCP测试
在服务器设备启动shell窗口，输入指令
# iperf -s -i 1
# 作为服务端运行，报告回显间隔时间1s
效果如下
-----------------------------------------------------------
Server listening on 5201
-----------------------------------------------------------
TCP上行测试
在客户端启动shell窗口，输入指令
# iperf3 -c 192.168.3.250 -i 1 -t 10 -b 7M
作为客户端，连接服务端ip地址192.168.3.250，报告回显间隔1s，测试时间10s,带宽限制为7M。
测试效果如下：
此处吞吐量的测试结果为receiver 7.02M左右，是因为限制测试数据的带宽是7M，说明实际的吞吐量应该是比这个大，测试过程中，如果发现测试的带宽与限制带宽接近，说明限制设置的太小，需要适当调整-b参数，或者参考硬件厂家给的指标测试。
那么调整-b参数到70M，测试结果如下：
可以看出来实际TCP上行的速度测试为19.1M/sec，还可以增加测试时间来提高测试准确性。
这里还有一点是sender结果为0bits/sec，是因为我们只测试了上行数据，那么如何测试下行通信速度呢？
TCP下行测试
在客户端启动shell窗口，输入指令
# iperf3 -c 192.168.3.250 -i 1 -t 10 -b 7M -R
作为客户端，连接服务端ip地址192.168.3.250，报告回显间隔1s，测试时间10s,带宽限制为7M,-R为反向测试，该参数也是iperf3的主要亮点，支持直接转换数据发送方向。
测试效果如下：
此处TCP下行吞吐量的测试结果为2.4M左右。
UDP测试
可继续使用TCP测试的服务器，如果未打开，参考TCP测试的服务器打开方式
在服务器启动shell窗口，输入指令
# iperf -s -i 1
作为服务端运行，报告回显间隔时间1s，服务端不区分tcp或udp
效果如下：
-----------------------------------------------------------
Server listening on 5201
-----------------------------------------------------------
UDP上行测试
在客户端启动shell窗口，输入指令
# iperf3 -u -c 192.168.3.250 -b 70M -i 1 -t 10
作为客户端运行，限制带宽70M，报告回显间隔1s，测试时间10s
测试效果如下：
此处发现测试的数据吞吐量结果为0，应该是只显示了下行结果，所以查看客户端的结果
此处测试出UDP上行吞吐量的结果为35.4M/s，延迟抖动（Jitter）为0.36ms，丢包率为12%。
测试过程中，如果发现测试的带宽与限制带宽接近，说明限制设置的太小，需要适当调整-b参数，或者参考硬件厂家给的指标测试。
UDP下行测试
在客户端启动shell窗口，输入指令
# iperf3 -u -c 192.168.3.250 -b 70M -i 1 -t 10 -R
作为客户端运行，限制带宽70M，报告回显间隔1s，测试时间10s
测试效果如下：
此处测试出UDP上行吞吐量的结果为47M/s，延迟抖动（Jitter）为0.347ms，丢包率为32%。
这里要注意，-R是翻转发送者和接收者，所以统计结果都要从接收者这边来统计，否则延迟和丢包统计将没有意义。
详细解读
可以直接参考系统自带的帮助文档，如下：
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
-A, --affinity n/n,m set CPU affinity
-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
-C, --congestion <algo> set TCP congestion control algorithm (Linux and FreeBSD only)
-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'
-L, --flowlabel N set the IPv6 flow label (only supported on Linux)
-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
--no-fq-socket-pacing disable fair-queuing based socket pacing
(Linux only)
[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
抽取在测试过程中用到的一些参数做一些翻译和解读
客户端和服务端公有参数
| 参数名称 | 描述 |
|---|---|
| -p, --port | 指定端口号，默认为5201 |
| -i, --interval | 回显报告的间隔时间 |
| -h, --help | 显示帮助菜单 |
| -v, --version | 显示版本 |
服务器特有参数
| 参数名称 | 描述 |
|---|---|
| -s, --server | 指定以服务器模式运行 |
客户端特有参数
| 参数名称 | 描述 |
|---|---|
| -b, --bandwidth | 带宽参数，单位：字节每秒：KMG，为2的n次方，比如1K=1024,； 设置为0代表无限制，此参数UDP默认1M/s，TCP无限制 |
| -c, --client | 指定以客户端运行，后面要带服务器的IP地址 |
| -u, --udp | udp模式，不带-u默认为tcp模式 |
| -t, --time | 指定测试时间，不带参数默认测试10s |
| -R, --reverse | 翻转测试，这是iperf3比iperf2方便的主要亮点，iperf2不支持此功能，无法使用 |
| -w, --window | tcp窗口大小，默认无上限，可以不设此参数，作为udp模式测试时也不需要此参数 ，单位：KM，1K=1024 |