lordsimpson/iperf3-server

镜像概述和主要用途

Docker Iperf Server 是一个基于 Alpine Linux 的轻量级容器，专门用于以服务器模式运行 iperf3 工具。iperf3 是一款广泛使用的网络性能测试工具，可用于测量 TCP 和 UDP 带宽性能。该镜像通过每周构建机制，确保集成 Alpine 的最新安全补丁，适合需要可靠、安全网络性能测试环境的场景。

核心功能和特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低，启动速度快
• 服务器模式运行：默认以 iperf3 服务器模式启动，可直接接收客户端连接进行网络性能测试
• 安全更新机制：每周自动构建，集成 Alpine Linux 的最新安全补丁，持续提升运行环境安全性

使用场景和适用范围

• 网络带宽和吞吐量测试
• 服务器与客户端之间的网络性能基准测试
• 网络设备（如路由器、交换机）的转发性能评估
• 网络拓扑变更后的性能验证
• 开发/测试环境中的网络性能调试与优化

使用方法和配置说明

基本运行命令

使用以下命令启动 iperf3 服务器容器，默认监听 5201 端口（iperf3 标准端口）：

bash
docker run -d -p 5201:5201 --name iperf-server networkstatic/iperf3 -s

参数说明：

• -d：后台运行容器
• -p 5201:5201：将容器的 5201 端口映射到主机的 5201 端口，允许外部客户端连接
• --name iperf-server：指定容器名称为 iperf-server
• -s：以服务器模式启动 iperf3（必须参数）

Docker Compose 配置示例

创建 docker-compose.yml 文件，实现容器的持久化管理：

yaml
version: '3'
services:
  iperf-server:
    image: networkstatic/iperf3
    container_name: iperf-server
    ports:
      - "5201:5201/tcp"  # TCP 端口映射
      - "5201:5201/udp"  # UDP 端口映射（如需测试 UDP 性能）
    command: -s
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

客户端连接测试

服务器启动后，可通过 iperf3 客户端连接进行网络性能测试。本地测试示例：

bash
# 安装 iperf3 客户端（以 Ubuntu 为例）
sudo apt-get install iperf3

# 连接服务器进行 TCP 带宽测试
iperf3 -c localhost -p 5201

# 连接服务器进行 UDP 带宽测试（需服务器开放 UDP 端口）
iperf3 -c localhost -p 5201 -u -b 1G

客户端命令说明：-c 指定服务器地址，-p 指定端口，-u 启用 UDP 测试，-b 设置目标带宽