moafrancky/speedtest2mqtt

speedtest2mqtt

镜像概述和主要用途

speedtest2mqtt是一个基于Alpine的轻量级Docker镜像，主要功能是运行Ookla Speedtest网络速度测试，并将测试结果推送到指定的MQTT服务器。适用于需要定期监控网络性能并通过MQTT协议集成到监控系统、智能家居平台或数据分析系统的场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 定时测试：通过CRON表达式配置测试频率，默认每天4次（0点、6点、12点、18点）
• MQTT集成：支持自定义MQTT服务器连接参数，包括主机、ID、主题、认证信息等
• 自动许可接受：自动接受Ookla Speedtest的许可协议和GDPR条款，无需手动干预

使用场景和适用范围

• 家庭网络性能长期监控
• 企业网络质量定期检测
• 网络服务质量（QoS）评估
• 与Home Assistant等智能家居系统集成，实现网络状态可视化
• 网络故障自动报警触发条件

环境变量

以下环境变量可用于配置镜像行为：

使用方法

docker-compose.yml示例

yaml
version: "3"

services:
  speedtest:
    image: moafrancky/speedtest2mqtt:latest
    container_name: speedtest2mqtt
    environment:
      - MQTT_HOST=192.168.100.100  # 替换为实际MQTT服务器地址
    restart: unless-stopped

docker run示例

使用环境变量文件启动：

bash
docker run -d --env-file ./env.list moafrancky/speedtest2mqtt:latest

env.list文件内容示例：

MQTT_HOST=192.168.100.100  # MQTT服务器地址
MQTT_ID=speedtest2mqtt      # 客户端ID
MQTT_TOPIC=speedtest        # 结果发布主题
MQTT_OPTIONS=-r             # MQTT客户端选项
MQTT_USER=user              # MQTT用户名
MQTT_PASS=changeme          # MQTT密码
CRON=0 * * * *              # 每小时执行一次测试

注意事项

此镜像使用Ookla Speedtest CLI工具，并会自动接受Ookla的许可协议和GDPR条款。

Ookla Speedtest许可

您只能将此Speedtest软件及其生成的信息用于个人、非商业用途，通过个人计算机上的命令行界面使用。使用本软件需遵守以下链接的最终用户许可协议、使用条款和隐私政策：

• [***]
• [***]
• [***]

Ookla Speedtest GDPR

Ookla通过Speedtest收集的某些数据可能被视为个人身份信息，例如您的IP地址、唯一设备标识符或位置。Ookla认为其有合法利益与互联网服务提供商、硬件制造商和行业监管机构共享这些数据，以帮助他们理解并创建更好、更快的互联网。有关数据可能如何共享、可能传输到何处以及Ookla联系详情的更多信息，请参阅我们的隐私政策：[***]