本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

seanosteen/mqtt_heartbeat

一个Python进程，连接至MQTT代理并按指定间隔发布时间戳和系统正常运行时间

1 收藏0 次下载activeseanosteen镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

MQTT Heartbeat

概述

MQTT Heartbeat 是一个基于Python的容器化脚本，用于连接MQTT代理（broker），并按配置的时间间隔向指定MQTT主题发布更新的时间戳和系统正常运行时间，适用于通过MQTT协议监控设备或服务运行状态。

核心功能与特性

MQTT连接：支持连接至MQTT代理，支持用户名/密码认证
定时发布：按指定间隔（可配置）发布心跳数据，包含时间戳和系统正常运行时间
容器化部署：轻量级容器化设计，易于集成到现有Docker环境
灵活配置：支持自定义MQTT主题、心跳间隔、容器主机名等参数

使用场景与适用范围

物联网（IoT）设备状态监控：通过接收MQTT心跳消息确认设备在线状态
服务健康检查：监控服务器或应用服务是否正常运行
分布式系统节点状态追踪：在多节点环境中追踪各节点的运行时间和在线状态

使用方法与配置说明

Docker部署示例

docker run -d \
   -e MQTT_HOST=<MQTT代理地址> \  # MQTT代理主机地址（必填）
   -e MQTT_USERNAME=<MQTT用户名> \  # MQTT代理认证用户名（必填）
   -e MQTT_PASSWORD=<MQTT密码> \  # MQTT代理认证密码（必填）
   -e MQTT_TOPIC="Docker/Heartbeats" \  # 发布心跳消息的MQTT主题（默认值）
   -e HEARTBEAT_INTERVAL=30 \  # 心跳发布间隔（秒，默认值30）
   --name mqtt_heartbeat \  # 容器名称
   --restart unless-stopped \  # 容器退出时自动重启（除非手动停止）
   -h <自定义主机名> \  # 容器主机名（用于标识不同实例）
   seanosteen/mqtt_heartbeat

配置参数说明

参数	说明	是否必填	默认值
MQTT_HOST	MQTT代理的主机地址或IP	是	无
MQTT_USERNAME	MQTT代理的认证用户名	是	无
MQTT_PASSWORD	MQTT代理的认证密码	是	无
MQTT_TOPIC	发布心跳消息的MQTT主题	否	"Docker/Heartbeats"
HEARTBEAT_INTERVAL	心跳消息发布间隔（单位：秒）	否	30
--h（容器参数）	容器主机名（用于在心跳消息中标识实例）	否	容器默认主机名