shneezin/breitbandmessung-node

Breitbandmessung.de 自动化工具

概述

这是一个自动化脚本，用于帮助ISP用户按照德国联邦网络局相关说明执行宽带连接速度的测量活动。

核心功能和特性

• 支持定时测量：通过cron配置定期执行速度测试
• 支持单次测量：可配置仅执行一次测量
• 时区配置：支持设置不同时区，默认使用UTC
• 启动时运行：可配置容器启动时立即执行测量
• 结果导出：测量结果保存到CSV文件，便于后续分析

使用场景和适用范围

适用于需要定期监测宽带连接速度的用户，特别是对ISP服务质量有疑虑，需要收集客观速度数据的情况。可用于个人家庭网络或小型企业网络的连接质量监控。

使用方法和配置说明

1. 准备配置文件

创建config文件夹和config.cfg配置文件：

bash
mkdir -p config
touch config/config.cfg

配置文件示例（config.cfg）：

timezone=Europe/Berlin  # 时区设置
crontab=0 */2 * * *      # 定时任务配置，默认每2小时执行一次
run_once=true            # 是否仅执行一次测量
run_on_startup=true      # 是否在容器启动时执行测量

配置参数说明：

• timezone：时区名称，可从时区列表中选择，默认UTC
• crontab：定时任务表达式，可使用crontab生成器生成
• run_once：设为true时仅执行一次测量，设为false时按cron配置定期执行
• run_on_startup：设为true时容器启动时立即执行一次测量

2. 准备测量结果目录

创建用于存储测量结果的文件夹：

bash
mkdir messprotokolle

3. 运行Docker容器

使用Alpine版本（支持amd64和arm64架构）：

bash
docker run -d -v $PWD/config/:/usr/src/app/config:rw -v $PWD/messprotokolle:/export/ --name "breitbandmessung" shneezin/breitbandmessung-node

使用Debian版本（支持amd64、arm64和arm/v7架构）：

bash
docker run -d -v $PWD/config/:/usr/src/app/config:rw -v $PWD/messprotokolle:/export/ --name "breitbandmessung" shneezin/breitbandmessung-node:debian

4. 合并CSV结果文件

如需将多个CSV测量结果合并为一个文件，可运行：

bash
wget -O - https://raw.githubusercontent.com/shneezin/breitbandmessung-node/master/merge.sh | bash

其他部署方式

也可通过项目脚本创建容器：

bash
git clone https://github.com/shneezin/breitbandmessung-node.git && cd breitbandmessung
sudo ./create.sh alpine  # 或使用 debian 参数创建Debian版本容器

许可证

可自由使用和改进本脚本，作者不对脚本使用负责。