开始使用

收发第一条消息

准备本地 broker,完成连接、订阅、发布和接收核对。

浏览全部手册
本页目录

准备条件

需要一个可运行的 MQTT Tool 桌面客户端,以及你有权连接的 broker。官网当前不提供公开安装包;已有客户端的用户可继续操作。

本例使用本机 127.0.0.1:1883,不连接生产设备。已安装 Mosquitto 时,下载本机演示配置,在文件所在目录执行:

mosquitto -c mosquitto-demo.conf

配置只监听本机并允许本机匿名测试。若端口被占用,请调整配置和客户端端口,或停止你自己的占用进程。测试完成后按 Ctrl+C 停止 broker。

1. 创建并连接

点击左侧连接区域的加号,填写后点击「创建连接」,再点击状态栏的「连接」。

字段 本例填写
连接名称 本地入门
协议 mqtt://
主机地址 127.0.0.1
端口 1883
Client ID ineed-demo-client
用户名 / 密码 本例留空
Keep Alive 60

主机不要带 mqtt://。状态显示「已连接」才进入下一步。

2. 先订阅

在「当前连接的订阅」旁点击加号,Topic 过滤器填 ineed/demo/hello,QoS 选 0,消息格式选 JSON,点击「确认订阅」。确认订阅处于生效状态。

3. 发布 JSON

下方主题填 ineed/demo/hello,发布 QoS 选 0,Retain 选「否」,编辑格式选「JSON」,发送方式选「UTF-8」。输入:

{
  "message": "hello",
  "from": "ineed"
}

点击「发送」。你也可以在编辑器中按 Cmd+Enter(macOS)或 Ctrl+Enter

4. 核对成功结果

消息列表应有一条 TX 发送记录和一条 RX 接收记录。接收主题为 ineed/demo/hello,内容的 messagehello

只有 TX 不能证明订阅已收到。没收到时核对订阅状态、主题大小写和 broker 权限,见排查清单

5. 回看与结束

在「消息」页点击「历史记录」,查询这一轮收发。记录时间和载荷后关闭历史窗口,点击连接状态栏「断开」,最后停止本地 broker。

继续阅读工作台布局发布参数

连接栏与独立订阅栏并排;聊天式消息区区分发送与接收,下方编排发布内容。
新版 MQTT 工作台 · 连接栏与独立订阅栏并排;聊天式消息区区分发送与接收,下方编排发布内容。
0.1.0 开发版 · 2026-09-21 实机采集 · 点击查看原图 ↗

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