hvalev/isp-speedtest

speedtest-docker

!GitHub Workflow Status !Docker Pulls !Docker Stars !Docker Image Size (latest by date)

镜像概述

这是一个轻量级Docker容器，用于通过speedtest-cli工具测试网络带宽，并将测试结果按日期记录到CSV文件中（如2020-03-24.csv），方便用户长期监控网络性能。

核心功能

• 使用speedtest-cli进行带宽测速（含下载/上传速度、延迟）
• 通过CRON定时任务自动执行测速
• 结果按日期分类保存为CSV文件，便于数据分析
• 支持卷挂载持久化存储日志文件

使用场景

• 家庭用户监控ISP提供的带宽是否达标
• 小型企业定期检查网络连接稳定性
• 网络管理员跟踪网络性能变化趋势

配置说明

环境变量

• CRON_STRINGS：定时任务表达式，例如*/5 * * * *表示每5分钟执行一次测速

卷挂载

• 将宿主机目录挂载到容器内/isp路径，用于保存CSV日志（如/home/pi/isp-speedtest:/isp）

部署示例

Docker Run命令

bash
docker run -d --network host -e 'CRON_STRINGS=*/5 * * * * /speedtest.sh' -v /home/pi/isp-speedtest:/isp --name isp-speedtest hvalev/isp-speedtest

Docker Compose配置

yaml
version: "3.7"
services:
  isp-speedtest:
    image: hvalev/isp-speedtest
    container_name: isp-speedtest
    network_mode: host
    environment:
      - 'CRON_STRINGS=*/5 * * * * /speedtest.sh'
    volumes:
      - /home/pi/isp-speedtest/:/isp/
    restart: always

构建镜像

bash
docker build https://github.com/hvalev/isp-speedtest-docker.git --tag isp-speedtest

致谢

部分代码参考自https://github.com/igomez10/speedInspectorRPI/%EF%BC%8CCRON%E5%AD%97%E7%AC%A6%E4%B8%B2%E4%BD%9C%E4%B8%BA%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E7%9A%84%E5%AE%9E%E7%8E%B0%E6%96%B9%E5%BC%8F%E5%8F%82%E8%80%83%E8%87%AAhttps://hub.docker.com/r/xordiv/docker-alpine-cron%E3%80%82

限制说明

speedtest-cli工具会产生较多连接，若过于频繁执行可能导致路由器负载过高，建议使用默认5分钟间隔。本镜像作者不对因使用该工具造成的网络问题负责。此外，speedtest-cli本身存在一些限制，详情可参考https://github.com/sivel/speedtest-cli#inconsistency%E3%80%82