Ineed收发你的第一条 MQTT 消息
准备一个本地 broker，创建连接、订阅主题，再发布一条可核对的 JSON 消息。
继续深入：阅读 MQTT Tool 完整手册 ↗
本页目录
先准备什么
需要一个可以运行的 MQTT Tool 客户端，以及一个你有权访问的 MQTT broker。当前官网尚未提供公开安装包，具体状态见下载页。本教程不要求连接真实设备。
以下示例使用本机 broker：127.0.0.1:1883。如果你使用其他测试环境，请替换地址、端口与身份认证信息。不要把生产环境凭据放进截图或公开日志。
可选：用 Mosquitto 启动本地 broker
已安装 Mosquitto 时，下载本机演示配置，在文件所在目录运行：
mosquitto -c mosquitto-demo.conf配置只监听 127.0.0.1，允许本机匿名测试。它不是公网部署配置。端口被占用时，可先停止自己的测试进程，或同时修改配置和客户端端口。测试结束后在终端按 Ctrl+C 停止 broker。
1. 创建连接
在左侧「连接」区域点击加号，新建连接：
| 字段 | 示例值 |
|---|---|
| 连接名称 | 本地入门 |
| 协议 | mqtt |
| 主机地址 | 127.0.0.1 |
| 端口 | 1883 |
| Client ID | ineed-demo-client |
| 用户名 / 密码 | 本机演示配置可留空 |
主机地址只填主机，不要再填 mqtt://。如果 broker 要求认证，使用分配给你的测试账号。多个客户端不能同时使用相同的 Client ID，否则可能互相挤下线。
保存并连接，确认当前连接状态为「已连接」。尚未连接成功时，先查看「日志」，不要继续排查消息内容。
2. 先订阅主题
在当前连接的订阅区点击加号，订阅 ineed/demo/hello，QoS 选择 0。确认订阅操作成功后，再进行发布。
这里使用完整主题便于核对。了解通配符时，可以改为 ineed/demo/#；发布主题不能使用 # 或 +。
3. 发布 JSON 消息
在下方发送区域填写：
- TOPIC：
ineed/demo/hello - QoS：
0 - RETAIN：
否 - 输入格式：
JSON - 发送方式：
原文
{
"message": "hello",
"from": "ineed"
}点击「发送」。当前客户端已经订阅该主题，broker 应把消息转发回来。消息列表可切换「接收」「发送」进行对照。
4. 怎样算成功
检查三件事：连接保持在线，接收记录的主题是 ineed/demo/hello，载荷中 message 为 hello。只有发送记录不等于订阅接收已经成功。
打开「历史」查看消息记录；连接、订阅等操作信息通过「日志」检查。首次验证先不启用定时发送，便于辨认这一条消息。
如果没有收到
- 核对订阅和发布是否属于同一个 broker。
- 核对主题大小写与层级。
ineed/demo/hello与ineed/demo/Hello不相同。 - 确认先订阅成功，再发布；Retain 为否时，过去的普通消息不会因新订阅而自动重放。
- 如果连接被断开，检查 Client ID 冲突和日志中的认证错误。
- 检查 broker 是否分别允许订阅和发布该主题。
更详细的判断方法见主题、QoS 与排查。