thinger/node-red-plugin Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Node-RED 镜像文档

一、镜像概述和主要用途

Node-RED 是由 IBM 开发的开源项目，旨在为规则引擎市场提供一个简单但功能强大的框架，具备易用的图形化编程界面，并有超过 2000 个社区贡献。该技术特别适用于 IoT 项目，可用于数据处理与分析、创建自动化规则以响应 IoT 设备事件，还可作为 MQTT 代理或自定义仪表盘展示数据。其最大潜力体现在与 IoT 平台（如 Thinger.io）结合使用时：Thinger.io 负责数据采集、存储和设备管理，Node-RED 负责数据处理和自动化等任务。

二、核心功能和特性

2.1 Thinger.io 与 Node-RED 集成

集成主要体现在以下两个方面：

2.1.1 node-red-contrib-thinger 贡献包

专为简化 Node-RED 流与 Thinger.io 功能集成而开发的节点集，支持以下交互能力：

• 资产迭代节点：遍历 Thinger.io 平台资产
• 数据桶创建节点：事件触发时创建数据桶
• 数据桶读取/写入/导出节点：操作数据桶数据
• 设备回调节点：调用设备回调并支持自动配置
• 设备创建节点：创建各类设备
• 设备资源读取/流订阅/写入节点：与设备资源交互
• 端点调用节点：调用 Thinger.io 端点
• 属性读取/写入节点：操作设备、类型或组的属性
• 服务器事件节点：检测设备、数据桶等事件
• 存储读取/写入节点：操作文件存储中的文件

2.1.2 Node-RED 插件

可将 Node-RED 服务器部署在与 Thinger.io IoT 平台相同的主机上，实现 24/7 无限制运行，解决单独托管 Node-RED 的问题。

三、使用场景和适用范围

Node-RED 适用于以下场景：

• IoT 数据处理与分析：实时处理 IoT 设备产生的数据
• 自动化规则创建：基于设备事件触发自动化行为
• 设备管理与监控：通过自定义节点监控和管理 Thinger.io 设备
• 数据集成与转发：将 IoT 数据导出至第三方服务或存储
• 设备自动配置：通过事件触发设备自动创建和配置
• 告警与通知：结合 Thinger.io 端点实现设备状态变更告警

四、Node-RED 核心概念

4.1 节点（Nodes）

流的基本构建块，包含配置表单和特定行为，主要类型：

• 注入节点（Inject Nodes）：通过定时或手动触发流，发送包含 payload 和 topic 的消息
• 功能节点（Function Nodes）：通过 JavaScript 函数或预配置工具处理流数据（如函数节点、转换节点、开关节点）
• 输出与调试节点（Output and Debug Nodes）：从流中提取数据至第三方、文件或调试控制台

4.2 节点面板（Palette）

Web 编辑器中的节点列表，可通过"面板管理器"扩展，包含 2000+ 社区贡献节点。

4.3 流（Flows）

编辑器工作区中的标签页，用于组织节点。每个流可命名并描述，流内节点共享流作用域上下文。通过"部署"按钮将流部署至运行时。

4.4 调试控制台（Debug Console）

右侧边栏区域，结构化显示调试节点发送的消息，包含时间戳和节点信息，点击节点 ID 可定位节点。

五、使用方法和配置说明

5.1 Thinger.io 节点配置

5.1.1 服务器连接配置

1. 将任意 Thinger.io 节点拖至画布并双击打开属性表单
2. 在"服务器"输入框点击编辑按钮，打开 Thinger 服务器配置菜单
3. 配置服务器参数：
   • Thinger.io 插件内部署：主机填写 $(THINGER_HOST)，令牌填写 $(THINGER_TOKEN_NODE_RED_PLUGIN)，禁用 SSL（本地通信）
   • 独立部署：主机填写 Thinger.io 服务器 URL 或 IP，令牌填写具有管理员权限的访问令牌，建议启用 SSL

5.2 节点详细说明

5.2.1 资产迭代节点（Asset Iterator）

• 类型：功能节点
• 用途：按筛选条件遍历 Thinger.io 平台资产，批量执行操作
• 配置：至少需指定"资产类型"
• 输出：每个资产生成一条包含单资产信息的消息

5.2.2 数据桶操作节点（Bucket Create/Read/Write/Export）

• 数据桶创建：配置"数据桶 ID"和"数据源"，事件触发时创建数据桶，输出操作结果
• 数据桶读取：配置"数据桶 ID"、"筛选条件"和"排序方式"，触发时读取数据，输出 JSON 格式数据
• 数据桶写入：配置"数据桶 ID"，接收流中 JSON 数据并写入数据桶
• 数据桶导出：配置"数据桶 ID"、"导出类型"、"数据范围"和"时间戳格式"，输出下载 URL 或数据内容

5.2.3 设备操作节点（Device Create/Read/Write/Stream/Callback）

• 设备创建：配置"设备 ID"、"类型"和"凭证"，创建设备并输出结果
• 设备读取：配置"设备 ID"和"资源名称"，触发时读取设备资源，输出 JSON 数据
• 设备写入：配置"设备 ID"和"资源 ID"，向在线设备发送数据
• 设备流订阅：配置"设备 ID"和"资源名称"，按设定间隔订阅设备资源数据
• 设备回调：配置"设备 ID"，调用设备 HTTP 回调，支持设备自动配置

5.2.4 其他核心节点

• 端点调用节点：配置"端点 ID"，调用 Thinger.io 端点，支持传入 JSON 数据
• 属性读写节点：配置"资产类型"、"资产 ID"和"属性名称"，读取/写入设备、类型或组的属性
• 存储读写节点：配置"存储 ID"，读取/写入 Thinger.io 文件存储中的文件
• 服务器事件节点：配置"事件类型"（如设备状态变更），实时触发平台事件，输出事件详情

六、部署方案

6.1 Thinger.io 插件部署

作为 Thinger.io 插件部署时，Node-RED 与 Thinger.io 共享主机环境，无需额外配置，直接通过 Thinger.io 控制台访问。

6.2 独立 Docker 部署（参考）

bash
# 基础运行命令
docker run -d -p 1880:1880 \
  -v node_red_data:/data \
  --name node-red \
  nodered/node-red

# 安装 Thinger.io 节点
docker exec -it node-red npm install node-red-contrib-thinger

6.3 Docker Compose 配置（参考）

yaml
version: '3'
services:
  node-red:
    image: nodered/node-red
    ports:
      - "1880:1880"
    volumes:
      - node_red_data:/data
    environment:
      - THINGER_HOST=api.thinger.io
      - THINGER_TOKEN=your_admin_token
    restart: always

volumes:
  node_red_data:

七、示例流程

7.1 设备离线告警流程

功能描述

检测设备离线事件，通过 Thinger.io 邮件端点发送告警。

流程配置

1. 服务器事件节点：配置事件类型为"device_state_change"，筛选状态为"disconnected"，监控所有设备（设备 ID 留空）
2. 端点调用节点：配置端点 ID 为"DisconnectionAlert"，接收设备离线事件数据并触发邮件发送

流程导入 JSON

json
[
  {
    "id": "d577ba5d.a271b8",
    "type": "tab",
    "label": "设备离线告警",
    "disabled": false,
    "info": ""
  },
  {
    "id": "b5b501a2.a5287",
    "type": "server-events",
    "z": "d577ba5d.a271b8",
    "name": "",
    "asset": "",
    "event": "device_state_change",
    "filter": "",
    "filters": {
      "state": "disconnected"
    },
    "bucket": "",
    "device": "",
    "endpoint": "",
    "state": "disconnected",
    "server": "ec0dd4b1ef5aa9a8",
    "x": 231,
    "y": 159,
    "wires": [
      [
        "6fd24968.0dc1b8"
      ]
    ]
  },
  {
    "id": "6fd24968.0dc1b8",
    "type": "endpoint-call",
    "z": "d577ba5d.a271b8",
    "name": "",
    "endpoint": "DisconnectionAlert",
    "server": "ec0dd4b1ef5aa9a8",
    "x": 481,
    "y": 159,
    "wires": []
  },
  {
    "id": "ec0dd4b1ef5aa9a8",
    "type": "thinger-server",
    "host": "$(THINGER_HOST)",
    "name": "本地服务器",
    "ssl": false
  }
]

说明

• 服务器事件节点监控所有设备的离线状态变更
• 端点调用节点将事件数据（设备 ID、状态、时间戳）发送至"DisconnectionAlert"端点
• 需提前创建邮件端点（参考 Thinger.io 端点文档）

八、注意事项

• 避免循环运行创建类节点（如设备创建、数据桶创建），防止资源耗尽
• 使用调试节点验证数据格式，建议通过转换节点过滤 JSON 键
• 独立部署时确保访问令牌具有足够权限，插件内部署使用环境变量令牌
• 详细节点文档可通过 Node-RED 帮助对话框查看