loganmarchione/docker-iperf3

docker-iperf3

https://github.com/loganmarchione/docker-iperf3/actions/workflows/main.yml/badge.svg](https://github.com/loganmarchione/docker-iperf3/actions/workflows/main.yml)

镜像概述和主要用途

本镜像用于在Docker容器中运行iPerf3服务器。iPerf3是一款常用的网络性能测试工具，可测量带宽、延迟、抖动等网络指标。该镜像基于Alpine Linux构建，体积小巧，支持多架构，适合快速部署iPerf3服务用于网络性能评估。

• 源代码：https://github.com/loganmarchione/docker-iperf3
• Docker容器：https://hub.docker.com/r/loganmarchione/docker-iperf3
• 基础镜像：https://hub.docker.com/_/alpine/
• 应用程序：iPerf3
• 支持架构：linux/amd64, linux/arm64, linux/arm/v7

核心功能和特性

• 核心功能：在Docker容器中运行iPerf3服务器，提供标准iPerf3网络性能测试服务。
• 轻量级：基于Alpine Linux，镜像体积小，资源占用低。
• 多架构支持：兼容amd64、arm64、arm/v7架构，适配不同硬件平台。
• 版本控制：提供语义化版本标签，支持固定特定版本以确保环境一致性。

使用场景和适用范围

• 网络性能测试：需临时或持续运行iPerf3服务器，用于测试客户端与服务器之间的网络带宽、吞吐量、延迟等指标。
• 开发/测试环境：在隔离的Docker环境中快速部署iPerf3服务，避免对主机系统配置造成影响。
• 生产环境辅助：作为网络性能监控节点，长期运行以持续监测网络稳定性（需配合容器重启策略）。

Docker镜像信息

Docker镜像标签

• latest：最新稳定版本
• X.X.X：语义化版本（如需固定版本，建议使用此标签）

环境变量

无特殊环境变量需配置。

端口映射

数据卷

无数据卷需求，容器运行无需持久化数据。

使用方法和配置说明

docker-compose部署示例

以下是标准部署的docker-compose.yml配置文件：

yaml
version: '3'
services:
  iperf3:
    container_name: docker-iperf3  # 容器名称
    restart: unless-stopped        # 重启策略：除非手动停止，否则自动重启
    networks:
      - iperf3                     # 自定义网络隔离
    ports:
      - '5201:5201'                # 端口映射（主机端口:容器端口）
    image: loganmarchione/docker-iperf3:latest  # 镜像及标签

networks:
  iperf3:  # 定义专用网络

调试与本地开发（仅用于编辑/测试/调试）

以下命令用于本地构建、测试镜像（非生产环境使用）：

bash
# 构建镜像（基于开发配置文件）
docker compose -f docker-compose-dev.yml up -d

# 查看容器日志（实时输出）
docker compose -f docker-compose-dev.yml logs -f

# 测试完成后销毁容器及资源
docker compose -f docker-compose-dev.yml down