开始使用

认识 MQTT Tool

了解适用场景、工作流程与当前版本的能力边界。

浏览全部手册
本页目录

它能帮助你做什么

MQTT Tool 是开发与调试用的桌面 MQTT 客户端。你可以连接 broker、订阅主题、发布测试消息,并对照实时消息、历史消息和连接日志定位问题。

常见用途是验证设备上报主题、检查后端订阅、模拟一条命令,以及比较 JSON 文本和原始字节。它不会替你启动 broker,也不是设备管理平台。

三件事,把问题看完整

  • 按订阅主题独立解析:设备状态用 JSON,文本日志用 Text,字节排查用 Hex。同一工作台中分别设置,不要求所有主题采用一种格式;这是显示与解析选项,不是自定义脚本执行器。
  • 历史消息回看内容:实时聊天式消息区便于观察这一轮收发,本地历史用于查找之前的主题与载荷。清空视图不会清除历史;历史内容也不能一概当作原始字节存档。
  • 过程日志解释原因:连接、重连、订阅和发送失败时,结合日志与消息定位环节。日志与消息的搜索条件、清理范围不同。

先按任务选入口

现在想做什么 从哪里开始 完成后检查什么
确认客户端到 Broker 的链路 收发第一条消息 同一主题的 TX/RX 与 JSON 内容一致
同时观察不同类型设备数据 订阅与格式 各主题按选定格式展示,筛选范围正确
查找此前收到的消息 历史消息 核对连接、主题、方向与载荷
排查连接或订阅失败 过程日志 找到对应操作的结果,再核对 Broker 配置

为长时间调试留出空间

连接栏右侧有独立订阅栏,收起连接列表后仍能选择主题。实时消息以聊天式记录区分发送与接收;点击订阅筛选 RX,TX 不受该订阅筛选影响。清除筛选即可回到全部订阅的接收消息。

在「设置 → 外观」开启大字模式并保存,配合舒适密度调整阅读空间。熟悉“古法编程”的开发者,也值得一个不用眯眼找报文的工作台;具体操作见外观与布局。

一次完整的调试流程

  1. 创建连接,等到状态显示「已连接」。
  2. 添加订阅,确认主题与 QoS。
  3. 发布消息,在接收方向核对主题和载荷。
  4. 点击消息内容查看详情,必要时打开历史消息。
  5. 如果连接或订阅失败,先检查日志。

界面与运行环境

Electron 和 Tauri 使用同一份工作台 UI,原生网络、存储和窗口实现不同。使用时先关注任务与功能;反馈问题时,再从「关于」记录运行环境。

消息历史、连接与设置由桌面端本地存储。网站只提供介绍与手册,不会代替桌面端连接 MQTT。

当前版本的边界

本手册对应 0.1.0 开发版、2026-10-07 对上述入门能力核对的工作区实现;配图保留各自采集日期。macOS、Windows、Linux 的 Electron 测试构建已提供下载;正式签名与公证仍待完成,见下载与版本状态。源码已完成 GitHub / Gitee 公开托管,原创源码采用 Apache-2.0,仓库入口与许可范围见源码与许可说明。

当前连接表单没有协议版本切换、自定义 CA/客户端证书、遗嘱消息或 MQTT 5 属性配置入口。不要将底层库能力或「关于」的概览文字理解为这些操作已经可用。

首次使用请从第一条消息开始。

最新源码新增路线(2026-11-02)

场景测试复用已连接 broker:先确认订阅,再发布带请求 ID 的 JSON,用严格条件核对新响应,保存配置版本与报告。 本模块已包含于 2026-11-03 测试包,请核对构建标识与平台验收范围。

场景配置、执行与报告

仍有疑问?按反馈清单整理复现信息 →