术语与参数速查
快速理解 broker、Topic、QoS、Retain、Client ID 和本地历史。
浏览全部手册
本页目录
连接与身份
| 术语 | 含义 |
|---|---|
| Broker | 转发 MQTT 消息并管理会话与权限的服务 |
| Client ID | broker 用来识别客户端会话的标识 |
| Keep Alive | MQTT 保活参数，不是定时发送周期 |
| Clean Session | MQTT 3.1.1 会话清理标志；工具当前全局开关尚未影响新建连接 |
| TLS | 传输加密；不代表工具已提供客户端证书管理 |
| WebSocket | 一种传输方式，需要 broker 提供对应监听入口 |
消息与订阅
| 术语 | 含义 |
|---|---|
| Topic | 发布消息使用的具体主题 |
| Topic 过滤器 | 订阅匹配规则，可以使用合法的 + 和 # |
| Payload | 消息内容，可以是文本或二进制 |
| QoS | MQTT 协议层交付质量，不等于业务成功 |
| Retain | broker 保留该主题最近一条保留消息的标志 |
| RX / TX | 接收 / 发送 |
显示与存储
JSON 是内容结构，UTF-8 是文本编码，HEX 是字节的十六进制表示。当前工具的 HEX 发送是文本转字节，不是输入十六进制命令解析器。
实时列表是当前窗口的可见数据；历史消息是本地持久化记录；保留消息是 broker 侧状态。三者的清理方式和生命周期不同。
SQLite 是本地数据库；WAL 和 SHM 是 SQLite 运行期间可能使用的辅助文件。备份前正常退出并备份完整数据目录。
按问题继续阅读
- 连接问题：字段说明与协议区别。
- 匹配问题：Topic、QoS 与 Retain。
- 字节问题：JSON、Text 与 HEX。
- 历史问题：查询与数据清理。
仍有疑问？按反馈清单整理复现信息 →