seanosteen/mqtt_heartbeat Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
seanosteen/mqtt_heartbeatseanosteen
一个Python进程，连接至MQTT代理并按指定间隔发布时间戳和系统正常运行时间
1 次收藏下载次数: 0状态：社区镜像维护者：seanosteen仓库类型：镜像最近更新：10 天前
MQTT Heartbeat
概述
MQTT Heartbeat 是一个基于Python的容器化脚本，用于连接MQTT代理（broker），并按配置的时间间隔向指定MQTT主题发布更新的时间戳和系统正常运行时间，适用于通过MQTT协议监控设备或服务运行状态。
核心功能与特性
- MQTT连接：支持连接至MQTT代理，支持用户名/密码认证
- 定时发布：按指定间隔（可配置）发布心跳数据，包含时间戳和系统正常运行时间
- 容器化部署：轻量级容器化设计，易于集成到现有Docker环境
- 灵活配置：支持自定义MQTT主题、心跳间隔、容器主机名等参数
使用场景与适用范围
- 物联网（IoT）设备状态监控：通过接收MQTT心跳消息确认设备在线状态
- 服务健康检查：监控服务器或应用服务是否正常运行
- 分布式系统节点状态追踪：在多节点环境中追踪各节点的运行时间和在线状态
使用方法与配置说明
Docker部署示例
bashdocker 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（容器参数） | 容器主机名（用于在心跳消息中标识实例） | 否 | 容器默认主机名 |
源码地址
GitHub
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"