octoblu/forwarder-service

转发器订阅服务

该微服务用于注册转发器设备，并可代表设备所有者设置设备消息订阅，帮助用户将设备消息转发至指定端点。

什么是转发器？

转发器是接收其他设备消息并将其转发至其他位置（如数据存储或其他消息平台）的设备，可监视设备发送、接收或广播的消息并转发到目标端点。

核心功能

• 注册转发器设备
• 管理设备消息订阅（添加、删除、查询）
• 支持多种消息类型订阅（发送、接收、广播）

使用场景

• 设备消息监控与同步至外部数据存储
• 跨平台消息转发（如将设备消息同步到企业消息系统）
• 设备间消息路由与分发

配置说明

所有API请求需在HTTP头中包含以下认证字段：

meshblu_auth_uuid
meshblu_auth_token

字段值需属于将创建订阅的用户或设备。

API接口列表

获取转发器类型 /types GET

返回支持的转发器类型列表。

获取所有转发器 /forwarders GET

返回授权用户拥有的转发器列表，响应状态码200。

获取转发器订阅 /forwarders/:uuid/subscriptions

参数：uuid（转发器的meshblu uuid）
返回转发器已订阅的设备列表。

添加转发器订阅 /forwarders/:forwarderUuid/subscriptions/:emitterUuid/:type POST

参数：

• forwarderUuid（转发器的meshblu uuid）
• emitterUuid（需订阅的设备uuid）
• type（订阅类型：message.sent/message.received/broadcast.sent）
  响应：204（成功）/403（权限不足）

删除转发器订阅 /forwarders/:forwarderUuid/subscriptions/:emitterUuid/:type DELETE

参数同添加接口，响应：204（成功）/403（权限不足）

Docker部署示例

基本运行

bash
docker run -d -p 3000:3000 octoblu/forwarder-service

Docker Compose配置

yaml
version: '3'
services:
  forwarder-service:
    image: octoblu/forwarder-service
    ports:
      - "3000:3000"
    # 若需自定义配置，可添加环境变量
    # environment:
    #   - MESHBLU_HOST=meshblu.example.com