MQTT 分发

将设备数据发布到 MQTT 消息服务器。适用于对接其他物联网平台、边缘计算节点订阅、实时数据流处理等场景。

工作原理

设备数据会自动发布到您指定的 MQTT Broker 和主题，订阅该主题的客户端可实时接收数据。

快速开始

第一步：准备 MQTT Broker

1. 部署 MQTT Broker（如 EMQX、Mosquitto）或使用云服务
2. 创建用于发布的用户账号
3. 规划数据主题

第二步：创建分发配置

1. 进入「组织 → 数据分发」
2. 点击「新建配置」
3. 选择类型为 MQTT
4. 填写 Broker 连接信息
5. 点击「保存」

配置参数

参数	必填	说明
Broker 地址	是	MQTT 服务器地址
主题	是	发布的主题名称
Client ID	是	客户端标识
用户名	否	认证用户名
密码	否	认证密码
QoS	否	服务质量等级（0/1/2）

Broker 地址示例

mqtt://broker.example.com:1883
mqtts://broker.example.com:8883  # SSL 加密

数据格式

发布的消息为 JSON 格式：

[
  {
    "agri_id": "d-1000-abc-1-00",
    "t": 1709856000,
    "value": 25.5,
    "the_type": 100,
    "org_id": "your-org-slug"
  }
]

安全建议

• 使用 mqtts:// 加密连接
• 设置用户名和密码认证
• 使用唯一的 Client ID

常见问题

问题	解决方案
连接失败	检查 Broker 地址和端口
认证错误	确认用户名和密码
消息未收到	检查主题名称和订阅配置
连接不稳定	检查网络和 Broker 负载

应用场景

• 物联网平台对接：将数据同步到其他 IoT 平台
• 边缘计算：边缘节点实时订阅处理数据
• 实时监控：构建实时数据展示系统