Docker-Speedtest 镜像文档

镜像概述与主要用途

Docker-Speedtest 是一个集成 speedtest-cli 工具的Docker镜像。speedtest-cli 是一款命令行网络速度测试工具，通过对接 speedtest.net 提供网络上传/下载带宽测试功能。本镜像旨在简化服务器环境中的网络速度测试流程，无需手动安装依赖或配置复杂隧道，直接运行容器即可完成测试。

核心功能与特性

• 集成 speedtest-cli：预装最新版 speedtest-cli，支持完整命令行参数与功能
• 零配置启动：拉取镜像后无需额外配置，直接通过命令行参数控制测试行为
• 原生网络性能：支持主机网络模式（--net=host），避免容器网络虚拟化开销，获取真实服务器网络性能数据
• 灵活参数支持：兼容 speedtest-cli 全部原生参数（如指定测试服务器、源IP、输出格式等）

使用场景与适用范围

• 服务器网络诊断：快速评估服务器网络带宽（上传/下载速度），适用于服务器部署验证、网络故障排查等场景
• 无图形界面环境：在仅提供命令行访问的服务器中，替代浏览器端 speedtest.net 测试
• 自动化监控集成：通过 JSON 格式输出（--json）对接监控系统，实现网络性能定期检测
• 特定网络接口测试：支持通过 --source 参数指定源IP，测试服务器多网络接口的性能差异

使用方法与配置说明

基本运行

通过以下命令启动容器，查看 speedtest-cli 完整帮助信息（含所有可用参数）：

bash
docker run --rm --net=host waja/speedtest -h

• 参数说明：
  • --rm：容器运行结束后自动清理，避免残留临时文件
  • --net=host：使用主机网络模式（推荐），直接使用主机网络栈，确保测试结果反映真实服务器网络性能（非必需，但用于原生性能测试或指定源IP时建议启用）
  • -h：speedtest-cli 帮助参数，列出所有支持的命令行选项

常用测试命令示例

1. 默认自动测试

自动选择距离最近的 speedtest.net 服务器执行测试：

bash
docker run --rm --net=host waja/speedtest

2. 指定测试服务器

先列出可用服务器（按距离排序），再通过服务器ID指定目标：

bash
# 列出所有可用服务器（含ID、名称、距离信息）
docker run --rm --net=host waja/speedtest --list

# 使用指定服务器ID测试（例如服务器ID为1234）
docker run --rm --net=host waja/speedtest --server 1234

3. 指定源IP地址

测试服务器特定网络接口的性能（需配合 --net=host）：

bash
docker run --rm --net=host waja/speedtest --source 192.168.1.100  # 替换为实际源IP

4. JSON格式输出（用于自动化）

生成结构化 JSON 结果，便于监控系统解析：

bash
docker run --rm --net=host waja/speedtest --json

构建镜像

如需本地构建镜像，执行以下命令（需环境预装 make 工具）：

bash
make build

容器交互（调试用）

如需在运行中的容器内获取交互式shell（用于调试或手动操作）：

bash
make shell