speedtest 的安装和配置教程

2025-05-25 14:52:51作者：滑思眉Philip

项目基础介绍

speedtest 是一个使用 Docker 容器来测试网络带宽的开源项目。它可以周期性地运行，并将测试结果保存到 InfluxDB 数据库中，便于后续的视觉化展示或长期记录。该项目主要使用 Shell 脚本和 Dockerfile 进行编程。

项目使用的关键技术和框架

Docker：用于创建容器化环境，确保软件能在不同系统中一致运行。
Shell 脚本：用于编写测试网络带宽的脚本。
InfluxDB：一个时间序列数据库，用于存储和检索时间标记的度量数据。
Grafana：一个用于可视化数据的开源平台，可以与 InfluxDB 配合使用。

准备工作

在开始安装和配置之前，请确保以下环境已经安装在您的系统上：

Docker
Docker Compose
InfluxDB
Grafana

安装步骤

克隆项目仓库 首先，需要从 GitHub 上克隆 speedtest 项目到本地：
```
git clone https://github.com/robinmanuelthiel/speedtest.git
cd speedtest
```
构建 Docker 镜像（如果需要） 如果没有现成的 Docker 镜像，可以通过以下命令构建：
```
docker build -t robinmanuelthiel/speedtest .
```
运行 speedtest 容器 使用以下命令运行 speedtest 容器：
```
docker run --rm robinmanuelthiel/speedtest:latest
```
运行结果将显示您的下载速度、上传速度和延迟。
配置周期性测试 如果需要周期性运行测试，可以设置环境变量 LOOP 为 true，并指定 LOOP_DELAY 为希望的延迟时间（单位：秒）：
```
docker run --rm -e LOOP=true -e LOOP_DELAY=60 robinmanuelthiel/speedtest:latest
```

将结果保存到 InfluxDB 如果要将结果保存到 InfluxDB，请确保 DB_SAVE 环境变量设置为 true，并配置正确的数据库连接信息：

docker run --rm -e DB_SAVE=true -e DB_HOST=http://localhost:8086 -e DB_NAME=speedtest -e DB_USERNAME=admin -e DB_PASSWORD=password robinmanuelthiel/speedtest:latest