hilschernetpi/netpi-nodered

Node-RED 容器

专为Raspberry Pi 3B架构设备及兼容设备设计。

Docker仓库

https://hub.docker.com/r/hilschernetpi/netpi-nodered

容器特性

本镜像部署的容器包含Debian系统、Node-RED、硬件特定Node-RED节点以及多个社区维护的常用Node-RED节点。

镜像基于https://www.balena.io/docs/reference/base-images/base-images/%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%84%E8%A3%85%E7%89%A9%E8%81%94%E7%BD%91%E6%B5%81%E7%A8%8B%E5%BC%8F%E7%BC%96%E7%A8%8BWeb%E5%B7%A5%E5%85%B7https://nodered.org/%E3%80%82

此外，容器预安装以下节点：

• https://flows.nodered.org/node/node-red-contrib-opcua
• https://flows.nodered.org/node/node-red-dashboard
• https://www.npmjs.com/package/node-red-contrib-ibm-watson-iot
• https://flows.nodered.org/node/node-red-contrib-azure-iot-hub
• https://flows.nodered.org/node/node-red-contrib-modbus
• https://flows.nodered.org/node/node-red-contrib-influxdb
• https://flows.nodered.org/node/node-red-contrib-mssql-plus

根据容器启动时检测到的/dev/...设备，以下节点会动态安装：

• https://github.com/HilscherAutomation/netPI-nodered-npix-io/tree/master/node-red-contrib-npix-io%EF%BC%88%E9%9C%80%60/dev/gpiomem%60%EF%BC%89
• https://github.com/HilscherAutomation/netPI-nodered-npix-ai/tree/master/node-red-contrib-npix-ai%EF%BC%88%E9%9C%80%60/dev/i2c-1%60%EF%BC%89
• https://github.com/HilscherAutomation/netPI-nodered-user-leds/tree/master/node-red-contrib-user-leds%EF%BC%88%E9%9C%80%60/dev/gpiomem%60%EF%BC%89
• https://github.com/HilscherAutomation/netPI-nodered-npix-leds/tree/master/node-red-contrib-npix-leds%EF%BC%88%E9%9C%80%60/dev/gpiomem%60%EF%BC%89
• https://www.npmjs.com/package/node-red-contrib-generic-ble%EF%BC%88%E9%9C%80%60/dev/ttyAMA0,/dev/vcio%60%EF%BC%89
• https://flows.nodered.org/node/node-red-node-serialport%EF%BC%88%E9%9C%80%60/dev/ttyS0%60%EF%BC%89
• https://flows.nodered.org/node/node-red-contrib-canbus%EF%BC%88%E9%9C%80%60/dev/i2c-1%60%EF%BC%89
• https://github.com/HilscherAutomation/netPI-nodered-fieldbus%EF%BC%88%E9%9C%80%60/dev/spidev0.0%60%EF%BC%89
• https://github.com/HilscherAutomation/netPI-nodered-fram/tree/master/node-red-contrib-fram%EF%BC%88%E9%9C%80%60/dev/i2c-1%60%EF%BC%89

支持的容器主机

容器已在以下主机上成功测试：

• netPI RTE 3（产品名称：NIOT-E-NPI3-51-EN-RE）
• netPI CORE 3（产品名称：NIOT-E-NPI3-EN）
• netFIELD Connect（产品名称：NIOT-E-TPI51-EN-RE/NFLD）
• Raspberry Pi 3B

netPI设备具有受限Docker环境，以最大程度保护系统软件完整性，限制包括：

• 特权模式不会自动将所有主机设备/dev/添加到容器
• 不支持绑定挂载到rootfs
• 无法将/dev、/dev/mem、/dev/sd*、/dev/dm*、/dev/mapper、/dev/mmcblk*设备添加到容器

容器配置

卷映射（可选）

为使Node-RED流程和设置文件在Docker主机上永久存储，可将其挂载到容器外部的独立卷中。即使容器被移除，文件仍保留在系统中；重新映射到新容器时可复用。

端口映射与网络模式

容器需运行在host网络模式下。此模式无需端口映射，以下TCP/UDP容器端口会自动暴露给主机：

主机设备

• 蓝牙支持：需添加/dev/ttyAMA0设备；为避免软重启后固件加载失败，需添加/dev/vcio设备以支持蓝牙芯片物理重置。
• GPIO访问：需添加/dev/gpiomem设备。
• NPIX串口模块（NIOT-E-NPIX-RS232/RS485）：需添加/dev/ttyS0设备（系统启动时需连接NPIX模块）。注：NIOT-E-NPIX-RS485修订版#2需将GPIO 17设为'1'以激活TX/RX自动方向功能。
• netPI RTE 3和netFIELD Connect：需添加/dev/spidev0.0设备以访问板载netX工业网络控制器；添加/dev/i2c-1设备以访问板载FRAM内存。

特权模式

需激活特权模式以解除Docker默认的容器限制，使容器内应用获得接近主机的权限。

环境变量

仅适用于netPI RTE 3和netFIELD Connect：

• FIELD：指定现场总线节点支持的协议类型。值为pns加载PROFINET IO设备协议，eis加载EtherNet/IP适配器协议，none则禁用现场总线节点。

容器部署

拉取镜像可能需要10分钟。

netPI示例

步骤1：在浏览器中打开netPI的Web UI（https）。

步骤2：点击Docker图标打开http://portainer.io/ Docker管理界面。

步骤3：点击Volumes > + Add Volume，输入nodered作为Name，点击Create the volume。

步骤4：在Containers > + Add Container下输入以下参数：

步骤5：点击Actions > Start/Deploy container按钮。

Docker命令行示例

bash
docker volume create nodered &&
docker run -d --privileged --network=host --restart=always -e FIELD=pns --device=/dev/ttyAMA0:/dev/ttyAMA0 --device=/dev/vcio:/dev/vcio --device=/dev/gpiomem:/dev/gpiomem --device=/dev/spidev0.0:/dev/spidev0.0 --device=/dev/i2c-1:/dev/i2c-1 -v nodered:/root/.node-red -p 1880:1880/tcp -p 9000:9000/tcp hilschernetpi/netpi-nodered

Docker Compose示例

docker-compose.yml文件示例：

yaml
version: "2"

services:
  nodered:
    image: hilschernetpi/netpi-nodered
    restart: always
    privileged: true
    network_mode: host
    ports:
      - 1880:1880
      - 9000:9000
    devices:
      - "/dev/ttyAMA0:/dev/ttyAMA0"
      - "/dev/vcio:/dev/vcio"
      - "/dev/gpiomem:/dev/gpiomem"
      - "/dev/spidev0.0:/dev/spidev0.0"
      - "/dev/i2c-1:/dev/i2c-1"
    volumes:
      - nodered:/root/.node-red
    environment:
      - FIELD=pns

volumes:
  nodered:

容器访问

容器部署后会自动启动Node-RED及相关服务。

Node-RED配置为支持HTTPS安全通信，在浏览器中通过https://<设备IP地址>:1880访问（例如https://192.168.0.1:1880）。

若容器运行在具有管理员Web UI的设备（如netPI或netFIELD Connect）上，Node-RED会要求登录，使用Web UI中设置的用户/密码登录。

许可证

Copyright (c) Hilscher Gesellschaft fuer Systemautomation mbH. All rights reserved. Licensed under the LICENSE.txt file information stored in the project's source code repository.

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能受其他许可证约束（如基础发行版中的Bash等，以及包含的主要软件的任何直接或间接依赖项）。 对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。

![N|Solid]([] Hilscher Gesellschaft fuer Systemautomation mbH []