RunMQTT 为原生 MQTT 客户端和浏览器 WebSocket 客户端提供安全接入地址。
接入地址
| 传输方式 | 地址格式 | 典型用途 |
|---|---|---|
| MQTT over TLS | mqtts://<broker>.tls-broker.runmqtt.com:8883 | 设备、网关和后端服务 |
| MQTT over secure WebSocket | wss://<broker>.tls-broker.runmqtt.com/mqtt | 浏览器应用及只允许 WebSocket 的网络 |
产品不会向客户暴露明文 MQTT 接入。请始终使用 Dashboard 中显示的完整主机名，确保 TLS 证书验证可以通过。
MQTT 版本
托管 Broker 链路支持 MQTT 3.1.1 和 MQTT 5.0。MQTT 5 包含标准确认原因码，以及常用的 Publish Properties，例如 Content Type、User Property、Response Topic、Correlation Data 和消息过期时间。
内置浏览器 Console 目前有意保持在 MQTT 3.1.1。它用于验证凭证、地址路由和基础 Topic 权限，不是完整的 MQTT 5 协议调试器。
套餐能力对照
| 能力 | Starter | Growth | Scale |
|---|---|---|---|
| MQTT 3.1.1 客户端 | 包含 | 包含 | 包含 |
| MQTT 5 客户端 | 包含 | 包含 | 包含 |
| QoS 0 和 QoS 1 | 包含 | 包含 | 包含 |
| QoS 2 | — | 包含 | 包含 |
| 遗嘱消息 | 包含 | 包含 | 包含 |
| 保留消息 | — | 包含 | 包含 |
| TLS 和 WSS | 包含 | 包含 | 包含 |
如何选择 QoS
- QoS 0：适合可以被后续数据替代的高频遥测，协议开销最低。
- QoS 1：适合必须送达、且业务可以幂等处理的事件。
- QoS 2：适用于 Growth 和 Scale 中确实需要 MQTT 协议边界 Exactly Once 的工作负载。
QoS 不能替代业务幂等。重连、下游重试和外部系统仍可能造成业务操作重复。
保留消息与遗嘱消息
保留消息会保存某个 Topic 的最新 Payload，并在新订阅建立时立即投递，Growth 和 Scale 可用。遗嘱消息用于在客户端未正常关闭连接时通知订阅方，所有套餐均包含。