tangentsoft/iperf3

iperf3 静态二进制服务器镜像

镜像概述和主要用途

本镜像包含 ESNet 的 iperf3 网络性能测试工具的单个静态链接二进制文件，默认配置为以服务器模式启动。主要用途是提供轻量级、高安全性的 iperf3 服务器环境，用于网络带宽、延迟等性能指标的测试。

核心功能和特性

• 静态链接二进制：独立可执行文件，无外部依赖，无需操作系统或库支持即可运行。
• 极小镜像体积：仅包含单个可执行文件，无操作系统、shell 或其他冗余组件，镜像体积极小。
• 高安全性：面仅限于 iperf3 二进制本身，无额外工具或环境可供潜在者利用，降低安全风险。
• 跨平台兼容性：已在 Docker、Podman 及 RouterOS 7 等 OCI 运行器中测试，适用于任何符合标准的 OCI 运行环境。

使用场景和适用范围

• 网络性能测试：作为 iperf3 服务器，配合 iperf3 客户端进行带宽、吞吐量、延迟等网络性能指标测试。
• 安全敏感环境：需最小化***面的场景（如生产网络、隔离测试环境），通过无冗余组件设计提升安全性。
• 资源受限设备：嵌入式系统、路由器（如 RouterOS）等资源受限环境，利用极小体积和低依赖特性实现高效部署。
• 跨平台部署：适用于 Docker、Podman、RouterOS 7 等多种 OCI 运行器，满足不同基础设施需求。

使用方法和配置说明

基本部署（Docker）

默认以服务器模式启动，监听 TCP 端口 5201（iperf3 默认端口）：

bash
docker run -d --name iperf3-server -p 5201:5201 --restart unless-stopped esnet/iperf3-static:latest

自定义参数部署

可通过追加 iperf3 命令参数自定义服务器配置，例如修改监听端口、绑定地址等：

示例 1：修改监听端口为 5202

bash
docker run -d --name iperf3-server -p 5202:5202 --restart unless-stopped esnet/iperf3-static:latest -s -p 5202

示例 2：绑定特定 IP 地址（如 192.168.1.100）

bash
docker run -d --name iperf3-server -p 5201:5201 --restart unless-stopped esnet/iperf3-static:latest -s -B 192.168.1.100

Docker Compose 配置示例

yaml
version: '3'
services:
  iperf3-server:
    image: esnet/iperf3-static:latest
    container_name: iperf3-server
    ports:
      - "5201:5201"  # 默认端口映射
    command: -s -p 5201  # 显式指定服务器模式及端口（默认行为，可省略）
    restart: unless-stopped

参数说明

验证运行状态

通过日志确认服务器启动状态：

bash
docker logs iperf3-server

预期输出：

iperf 3.14
Starting server on 5201

注意事项

• 镜像无 shell，无法通过 docker exec 进入容器内部；
• 所有配置需通过启动命令参数实现，不支持环境变量配置；
• 部署时需确保宿主机防火墙允许映射端口（如 5201）的入站流量。