转发器
高级功能 → 转发器,定义在两个 Broker 之间桥接 MQTT 主题的消息路由规则。每条规则在 Source Broker 上订阅一个主题,并将收到的每条消息转发(重新发布)到 Target Broker。

工作原理
Source Broker ──(订阅主题)──▶ 转发器规则 ──(发布)──▶ Target Broker转发器规则默认不对消息做任何变换——原样转发 payload。如需在转发前对消息进行处理,可开启自定义脚本,填写 JavaScript 转换逻辑。
列字段
| 列 | 含义 |
|---|---|
| ID | 转发器记录 ID |
| 名称 | 规则名称,如 receive、trans-inner |
| 使能 | 绿色 开启 = 规则激活中,正在转发;灰色 = 已暂停 |
| 自定义脚本 | 绿色 开启 = 转发前会执行转换脚本 |
| SourceBroker | 本规则订阅消息的来源 Broker |
| TargetBroker | 本规则将消息发布到的目标 Broker |
| 操作 | 详情——查看并编辑规则 |
配置字段(新增/编辑对话框)
| 字段 | 说明 |
|---|---|
| 名称 | 本条转发规则的标签 |
| 使能 | 开关,激活或暂停规则,不删除记录 |
| Source Broker | 从 Broker 中选择消息来源 Broker |
| Target Broker | 从 Broker 中选择消息目标 Broker |
| Subscription Topic | 在 Source Broker 上订阅的 MQTT 主题模式(支持 + 和 # 通配符) |
| 自定义脚本 | 开启后可编写 JS 脚本,在消息发布到 Target Broker 前对 payload 进行转换 |
| 备注 | 自由文本备注 |
典型用途
- 内部桥接 — 将设备上行数据从 AS Broker 转发到内部服务 Broker 做进一步处理(
trans-inner) - 外部推送 — 将指定主题转发到客户自有的 MQTT Broker 或云平台
- 协议转换 — 开启自定义脚本,在转发前对 payload 进行格式改写(如字段重命名、单位换算)
相关页面
系统平台转发器
系统平台可以创建公共转发器配置。公共配置面向所有组织可见,租户侧可以查看但不能编辑。如果系统平台为某个组织创建转发器,则该转发器按所选组织的 Broker 与组织参数执行。
系统平台中选择空组织或 PUBLIC 时,Source Broker 和 Target Broker 会被清空,作为公共配置保存。选择具体组织后,才可选择该组织下的 Broker。
订阅 Topic 占位符
订阅 Topic 支持使用组织参数占位符。平台会从组织的 params.org_params 中读取参数并渲染订阅 Topic。例如:
text
/${tenant}/device/${project}/up保存后,转发器缓存会记录渲染后的实际订阅 Topic,并按该 Topic 建立订阅。
自定义脚本参数
自定义脚本入口为:
javascript
function forwardScript({ topic, msg, org_params }) {
return msg
}org_params 是只读对象,适合在转发逻辑中读取组织级动态参数。
版本恢复
转发器保存时会生成版本快照。编辑前建议填写提交说明,后续可以在历史版本中查看或恢复。