iperf Docker镜像文档

!Docker Image Size (latest semver) !User Privilege !Health Check
!Docker Pulls !Docker Stars !GitHub License

镜像概述和主要用途

本镜像基于Alpine Linux构建，用于在Docker容器中运行iperf（iPerf v2）命令行工具的服务器模式。iPerf是一款用于主动测量IP网络最大可实现带宽的工具，支持调整与 timing、缓冲区和协议（TCP、UDP，以及IPv4和IPv6）相关的各种参数，可针对每次测试报告带宽及其他关键网络性能指标。

核心功能和特性

• 非root用户运行：容器以非特权用户身份运行，提升安全性
• 轻量级设计：基于Alpine Linux，镜像体积小且层数少，资源占用低
• 多协议支持：原生支持TCP和UDP协议的带宽测试
• 健康检查：内置健康检查机制，确保服务可用性
• 标准兼容性：遵循iPerf v2标准，支持与***iPerf客户端兼容的所有核心功能

使用场景和适用范围

本镜像适用于以下网络性能测试场景：

• 局域网（LAN）带宽基准测试
• 广域网（WAN）连接性能评估
• 网络设备（如路由器、交换机）吞吐量验证
• 服务器网络接口性能测试
• 网络QoS策略有效性验证

主要用户群体包括网络工程师、系统管理员和DevOps人员，用于快速部署标准化的网络带宽测试服务。

使用方法和配置说明

拉取镜像

从Docker Hub拉取最新版本镜像：

sh
docker pull mlabbe/iperf

运行镜像

默认配置下，容器将启动iPerf服务器并监听5001端口（TCP和UDP）。使用以下命令启动容器：

sh
docker run \
  --restart=unless-stopped \
  --name=iperf \
  -d \
  -p 5001:5001/tcp \
  -p 5001:5001/udp \
  mlabbe/iperf

参数说明：

• --restart=unless-stopped：除非手动停止容器，否则Docker将在容器退出时自动重启
• --name=iperf：指定容器名称为"iperf"，便于管理
• -d：后台运行容器
• -p 5001:5001/tcp：映射主机TCP 5001端口到容器TCP 5001端口
• -p 5001:5001/udp：映射主机UDP 5001端口到容器UDP 5001端口

自定义服务器参数

如需修改iPerf服务器配置（如端口、测试时长等），可在镜像名称后追加iPerf命令参数。例如，指定服务器监听5002端口：

sh
docker run -d -p 5002:5002/tcp -p 5002:5002/udp mlabbe/iperf iperf -s -p 5002

注：iPerf服务器模式基本命令为iperf -s，支持的参数可通过iperf -h查看完整列表。

客户端连接示例

TCP带宽测试

使用iPerf客户端连接服务器，进行TCP默认参数测试：

sh
iperf -c <服务器IP或域名>

示例输出：

------------------------------------------------------------
Client connecting to speedtest.mydomain.local, TCP port 5001
TCP window size:  208 KByte (default)
------------------------------------------------------------
[  3] local 192.168.1.100 port 53912 connected with 192.168.1.50 port 5001
[ ID] Interval       Transfer     Bandwidth
[  3]  0.0-10.0 sec  1.10 GBytes   941 Mbits/sec

UDP带宽测试

指定UDP协议并设置目标带宽为50Mbits/sec：

sh
iperf -u -b 50M -c <服务器IP或域名>

示例输出：

------------------------------------------------------------
Client connecting to speedtest.mydomain.local, UDP port 5001
Sending 1470 byte datagrams, IPG target: 235.20 us (kalman adjust)
UDP buffer size:  208 KByte (default)
------------------------------------------------------------
[  3] local 192.168.1.100 port 52186 connected with 192.168.1.50 port 5001
[ ID] Interval       Transfer     Bandwidth
[  3]  0.0-10.0 sec  59.6 MBytes  49.9 Mbits/sec
[  3] Sent 42501 datagrams
[  3] WARNING: did not receive ack of last datagram after 10 tries.