brennentsmith/internet-speed-logger

互联网速度记录器 (Internet Speed Logger) 镜像文档

镜像概述和主要用途

该镜像提供一个简单应用，用于长期跟踪互联网连接的下载速度、上传速度和延迟。应用持续监控网络性能，并通过响应式网页视图展示结果，同时提供基本的平均指标。它基于Ookla官方的Speedtest.net CLI二进制文件构建，以确保最佳性能。早期版本已稳定运行多年，是跟踪网络性能变化的实用工具。

核心功能和特性

• 长期性能跟踪：支持多年的互联网速度和延迟数据记录
• 权威测速引擎：集成Ookla Speedtest.net CLI，提供准确的网络性能测试
• 可视化展示：通过响应式网页界面直观展示历史数据和趋势
• 基本指标计算：自动生成下载/上传速度及延迟的平均统计数据
• 简单部署：基于Docker容器化，部署流程简洁，无需复杂配置

使用场景和适用范围

• 家庭用户长期监控网络服务质量
• 网络管理员跟踪宽带连接稳定性
• 需要记录网络性能变化趋势的个人或小型组织
• 诊断间歇性网络问题，收集历史数据用于分析

使用方法和配置说明

前提条件

• 已安装Docker和Docker Compose
• 具备互联网连接（用于执行Speedtest测试）

部署步骤

1. 克隆项目仓库

   bash
   git clone https://github.com/brennentsmith/internet-speed-logger.git
   cd internet-speed-logger
   

2. 启动服务

   bash
   docker compose up
   

   首次运行时会自动拉取所需镜像并构建应用，可能需要几分钟时间

3. 访问Web界面 打开浏览器，访问 http://localhost:3000 即可查看网络性能监控页面

数据持久化

应用数据默认通过Docker Compose配置进行持久化，无需额外设置即可保留历史记录。

停止服务

如需停止服务，可在项目目录中执行：

bash
docker compose down