Docker-iperf3(网络测速)

[iperf3](http://software.es.net/iperf/) 是一款带宽测试工具，它支持调节各种参数，比如通信协议，数据包个数，发送持续时间，测试完会报告网络带宽，丢包率和其他参数

相关链接：
---
- 服务器端：
	- iperf：https://iperf.fr
	- iperf3：http://software.es.net/iperf/
	- 下载链接：https://iperf.fr/iperf-download.php
	- Docker：https://registry.hub.docker.com/r/networkstatic/iperf3
	- GitHub：https://github.com/nerdalert/iperf3
- 客户端：
	- Network Tools：https://networktools.he.net/
	- 网络百宝箱(TP-Link)：https://resource.tp-link.com.cn/pc/docCenter/showDoc?id=1634202000035182

## Docker run
```bash
# Server 服务器模式
docker run -itd --name iperf3_server -p 5201:5201 -p 5201:5201/UDP networkstatic/iperf3 --server  # 部署为Server(-d 后台执行)
# TCP/UDP 都在 5201端口 上开放

# Client 客户端模式
docker run --rm -it --name iperf3_client networkstatic/iperf3 --client 192.168.100.1		# 运行简易测试
```
更加详细配置参数参考下方的 `参数解析`

## 参数解析
此类参数适用于 Docker 执行时使用的参数
```bash
# 用法:
iperf [-s|-c host] [options]
iperf [-h|--help] [-v|--version]

# 服务器或客户端：
-p, --port <port> # 监听/连接的服务器端口号
-f, --format [kmgKMG] # 报告格式：Kbits、Mbits、KBytes、MBytes
-i, --interval <间隔时间> # 周期性带宽报告的间隔时间(秒)
-F, --file name # 发送/接收指定的文件
-B, --bind <host> # 绑定到指定接口
-v, --version # 显示版本信息并退出
-h, --help # 显示此帮助消息并退出
-V, --verbose # 更详细的输出
-J, --json # 以JSON格式输出
-d, --debug # 输出调试信息
--logfile f # 将输出发送到日志文件

# 服务器特定选项：
-s, --server # 运行在服务器模式下
-D, --daemon # 将服务器作为守护进程运行
-I, --pidfile file # 写入PID文件
-1, --one-off # 处理一个客户端连接后退出

# 客户端特定选项：
-c, --client <host> # 运行在客户端模式下，连接到 <host>
-u, --udp # 使用UDP而不是TCP(如果是Docker需要端口开放UDP)
-b, --bandwidth <带宽> [KMG][/#] # 目标带宽，单位为比特/秒(0表示无限制)
								# (UDP默认为1 Mbit/sec，TCP默认为无限制)
								# (可选斜杠和包计数用于突发模式)
-t, --time <传输时间> # 传输的时间长度(默认为10秒)
-n, --bytes <传输字节> [KMG] # 传输的字节数(代替 -t)
-k, --blockcount <传输块> [KMG] # 传输的块数(数据包)(代替 -t 或 -n)
-l, --len <缓冲区长度> [KMG] # 缓冲区的长度读取或写入
							# (TCP默认为128 KB，UDP默认为8 KB)
--cport <port> # 绑定到指定的客户端端口(TCP和UDP，默认为临时端口)
-P, --parallel <并行数> # 并行的客户端流数目
-R, --reverse # 运行在反向模式下(服务器发送，客户端接收)
-w, --window <大小> [KMG] # 设置窗口大小/套接字缓冲区大小
-M, --set-mss <最大段大小> # 设置TCP/SCTP最大段大小(MTU-40字节)
-N, --no-delay # 设置TCP/SCTP无延迟，禁用Nagle算法
-4, --version4 # 仅使用IPv4
-6, --version6 # 仅使用IPv6
-S, --tos N # 设置IP的服务类型
-Z, --zerocopy # 使用"零拷贝"方法发送数据
-O, --omit <N秒> # 忽略前n秒的测试结果
-T, --title <字符串> # 在每行输出前加上此字符串
--get-server-output # 从服务器获取结果
--udp-counters-64bit # 在UDP测试包中使用64位计数器

[KMG] # 表示选项支持以K/M/G为后缀的单位：kilo-/mega-/giga-
```

### 常用 iperf 示例
```bash
# Server 服务器模式
iperf3 -s		# 运行 iperf3 服务器

# Client 客户端模式
iperf3 -c <host>		# 最简易测试，不含任何参数
iperf3 -c <host> -p <port>		# 指定特定端口
iperf3 -c <host> -u		# 使用 UDP协议 进行测试(如果是Docker需要端口开放UDP协议)
iperf3 -c <host> -b 1M		# 设置带宽限制为1Mbps
iperf3 -c <host> -t 20		# 指定测试持续时间为20秒
iperf3 -c <host> -P 4		# 并行运行多个客户端流测试
iperf3 -c <host> -J		# 以JSON格式输出结果
```

简单解析下测试输出的结果
![](/media/202307/2023-07-17_134323_5784510.8666307251375137.png)