iitgdocker/iperf-server

iperf-server Docker镜像文档

镜像概述与主要用途

iperf-server是一个基于Alpine Linux的轻量级Docker容器，用于快速部署iperf网络性能测试服务器。该镜像集成了iperf（v2.x）和iperf3（v3.x）的所有版本，支持TCP/UDP协议的网络带宽、延迟等性能指标测试。镜像体积小于4MB，具备多架构兼容性，可在无需安装额外依赖的情况下，仅通过Docker环境快速部署，适用于组织内部网络性能评估场景。

核心功能与特性

• 多架构支持：兼容amd64（x86_64）、arm64（ARMv8）、arm/v7（ARMv7）架构，适配服务器、嵌入式设备（如树莓派）等多种硬件环境。
• 轻量级设计：基于Alpine构建，镜像体积小于4MB，资源占用低，启动速度快。
• 全版本覆盖：包含iperf和iperf3的所有历史版本，满足不同测试工具兼容性需求。
• 双协议支持：默认监听TCP 5201端口，同时支持TCP流测试和UDP带宽测试。
• 灵活配置：通过环境变量自定义iperf命令参数，支持日志持久化、TCP窗口大小调整等高级功能。

支持版本

使用场景与适用范围

• 组织内网络性能测试：快速在多节点部署iperf服务器，测试跨网段、跨设备的网络带宽、吞吐量及稳定性。
• 多架构环境适配：在x86服务器、ARM嵌入式设备（如边缘计算节点）等混合架构环境中统一部署，简化测试流程。
• 轻量级资源需求场景：在资源受限的环境（如低配置虚拟机、IoT设备）中运行，避免占用过多系统资源。
• 自动化测试集成：作为CI/CD或监控系统的组件，定期执行网络性能检测并输出日志。

使用方法与部署示例

快速启动（Docker Run）

通过以下命令启动默认配置的iperf3服务器（使用latest标签，对应最新版iperf3）：

bash
docker run -d \
  --restart=always \
  --name iperf-server_5201 \
  -p 5201:5201 \  # TCP端口映射
  -p 5201:5201/udp \  # UDP端口映射（需同时映射以支持UDP测试）
  iitgdocker/iperf-server:latest

参数说明：

• -d：后台运行容器；
• --restart=always：容器退出时自动重启；
• --name：指定容器名称（如iperf-server_5201）；
• -p 5201:5201与-p 5201:5201/udp：分别映射TCP和UDP的5201端口（iperf默认端口）。

指定版本启动

如需使用特定版本的iperf（如iperf3.17.1或iperf2.2.0），通过Docker标签指定：

bash
# 启动iperf3.17.1服务器
docker run -d --name iperf3-17-1 -p 5201:5201 -p 5201:5201/udp docker.xuanyuan.run/iitgdocker/iperf-server:3.17.1

# 启动iperf2.2.0服务器
docker run -d --name iperf2-2-0 -p 5201:5201 -p 5201:5201/udp docker.xuanyuan.run/iitgdocker/iperf-server:2.2.0

Docker Compose配置示例

创建docker-compose.yml文件，配置带日志持久化和自定义参数的iperf服务器：

yaml
version: '3'
services:
  iperf-server:
    image: docker.xuanyuan.run/iitgdocker/iperf-server:latest
    container_name: iperf-server
    restart: always
    ports:
      - "5201:5201"       # TCP端口
      - "5201:5201/udp"   # UDP端口
    environment:
      - ARGS=-o /data/iperf.log -i 2  # 日志输出到文件，每2秒打印一次进度
      - TCP_WINDOW_SIZE=64K           # 设置TCP窗口大小为64KB
    volumes:
      - ./iperf-data:/data  # 挂载宿主机目录./iperf-data到容器/data，持久化日志

启动服务：

bash
docker-compose up -d

配置说明

环境变量

通过环境变量自定义iperf服务器行为，支持以下参数：

卷挂载（日志持久化）

默认情况下，iperf日志输出到容器标准输出（stdout），可通过卷挂载将日志持久化到宿主机：

1. 挂载宿主机目录（如./iperf-data）到容器/data目录；
2. 在ARGS中添加日志输出参数：-o /data/iperf.log。

示例（结合环境变量）：

bash
docker run -d \
  -p 5201:5201 -p 5201:5201/udp \
  -e ARGS="-o /data/iperf.log -i 1" \  # 每1秒记录一次日志到/data/iperf.log
  -v ./iperf-logs:/data \  # 宿主机./iperf-logs目录映射到容器/data
  iitgdocker/iperf-server:latest

日志文件将保存在宿主机./iperf-logs/iperf.log中。

iperf参数参考

ARGS变量支持所有iperf/iperf3命令参数，常用参数示例：

更多参数请参考iperf官方文档。