sk278/iperf3

iperf3 镜像文档

镜像概述

该镜像为iperf3网络性能测试工具的多架构容器化实现，支持linux/amd64、linux/arm/v7和linux/arm64架构。iperf3是一款常用的网络性能测试工具，主要用于测量TCP和UDP带宽性能，可帮助用户评估网络连接的吞吐量、延迟等关键指标。

核心功能与特性

• 多架构支持：兼容x86_64(amd64)、ARMv7和ARM64架构，适用于多种硬件平台
• 即开即用：无需复杂配置，快速部署iperf3服务
• 持久化运行：默认配置为除非手动停止否则自动重启，确保服务持续可用
• 完整端口映射：同时支持TCP和UDP协议的5201端口映射，满足不同测试需求

使用场景

• 网络带宽性能测试与评估
• 服务器网络吞吐量验证
• 多架构环境下的网络性能对比测试
• 网络设备（如路由器、交换机）性能测试

使用方法

1. Docker命令行部署

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

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

参数说明：

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

2. Docker Compose部署

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

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

使用以下命令启动服务：

bash
docker-compose up -d

配置说明：

• container_name：容器名称设置为iperf3
• restart: unless-stopped：设置自动重启策略
• network_mode: bridge：使用桥接网络模式
• ports：同时映射TCP和UDP的5201端口到宿主机

测试使用

容器启动后，可通过其他设备上的iperf3客户端连接进行测试。例如：

• TCP测试：iperf3 -c <容器所在主机IP>
• UDP测试：iperf3 -c <容器所在主机IP> -u