sk278/iperf

iperf Docker镜像文档

镜像概述

本镜像为iperf网络性能测试工具的容器化版本，支持多架构部署，包括linux/amd64、linux/arm/v7和linux/arm64。iperf是一款开源的网络性能测试工具，主要用于测量TCP和UDP带宽性能，可帮助用户评估网络吞吐量、延迟、丢包率等关键指标。

核心功能与特性

• 多架构支持：兼容linux/amd64、linux/arm/v7和linux/arm64架构，适用于不同硬件平台
• 完整功能保留：包含iperf工具全部网络性能测试功能
• 协议支持：同时支持TCP和UDP协议测试
• 便捷部署：提供Docker容器化部署方式，简化环境配置

使用场景

• 网络带宽性能评估与测试
• 网络设备吞吐量验证
• 网络连接稳定性检测
• 不同架构设备间的网络性能对比
• 服务器网络性能基准测试

使用方法与配置说明

1. Docker Run部署

通过以下命令快速启动iperf容器：

bash
docker run --restart=unless-stopped --name=iperf -d -p 5001:5001/tcp -p 5001:5001/udp sk278/iperf:latest

参数说明：

• --restart=unless-stopped：容器退出时除非手动停止，否则自动重启
• --name=iperf：指定容器名称为iperf
• -d：后台运行容器
• -p 5001:5001/tcp：映射TCP 5001端口（iperf默认端口）
• -p 5001:5001/udp：映射UDP 5001端口

2. Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  iperf:
    container_name: iperf
    image: sk278/iperf:latest
    network_mode: bridge
    restart: unless-stopped
    ports:
      - 5001:5001/tcp
      - 5001:5001/udp

使用以下命令启动服务：

bash
docker-compose up -d

配置说明：

• container_name：容器名称
• image：指定使用的镜像
• network_mode: bridge：使用桥接网络模式
• restart: unless-stopped：重启策略
• ports：端口映射配置，同时映射TCP和UDP 5001端口

3. 测试使用

容器启动后，可通过iperf客户端连接进行测试。例如，从另一台设备运行：

bash
# TCP测试
iperf -c <容器IP地址>

# UDP测试
iperf -u -c <容器IP地址>