speedtest 的安装和配置教程

项目基础介绍

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

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

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

准备工作

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

• Docker
• Docker Compose
• InfluxDB
• Grafana

安装步骤

1. 克隆项目仓库 首先，需要从 GitHub 上克隆 speedtest 项目到本地：

   git clone https://github.com/robinmanuelthiel/speedtest.git
   cd speedtest
   

2. 构建 Docker 镜像（如果需要） 如果没有现成的 Docker 镜像，可以通过以下命令构建：

   docker build -t robinmanuelthiel/speedtest .
   

3. 运行 speedtest 容器 使用以下命令运行 speedtest 容器：

   docker run --rm robinmanuelthiel/speedtest:latest
   

   运行结果将显示您的下载速度、上传速度和延迟。

4. 配置周期性测试 如果需要周期性运行测试，可以设置环境变量 LOOP 为 true，并指定 LOOP_DELAY 为希望的延迟时间（单位：秒）：

   docker run --rm -e LOOP=true -e LOOP_DELAY=60 robinmanuelthiel/speedtest:latest
   

5. 将结果保存到 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
   

6. 使用 Grafana 可视化数据 若要使用 Grafana 可视化数据，首先确保 Grafana 和 InfluxDB 均已启动。然后，在 Grafana 中添加 InfluxDB 作为数据源，并创建一个新的仪表板，配置相应的查询以显示网络速度。

通过以上步骤，您可以成功安装和配置 speedtest 项目，并利用 Docker 容器来测试和记录您的网络带宽。