vimagick/node-red

Node-RED镜像说明

镜像概述

Node-RED是一款开源的可视化编程工具，旨在简化硬件设备、API及在线服务之间的连接与整合。通过拖拽节点并连线的方式，用户可快速构建自动化流程，广泛应用于物联网领域的原型开发与系统搭建。

核心功能

1. 可视化流程设计：无需编写大量代码，通过拖拽节点、配置参数即可完成逻辑流程搭建；
2. 多资源连接：支持对接硬件设备（如Arduino、Raspberry Pi）、第三方API及在线服务（如MQTT、HTTP）；
3. 扩展节点库：可通过npm安装官方或社区提供的节点库，扩展功能场景；
4. 安全认证：支持管理员权限配置，限制未授权访问，保障系统安全。

使用场景

1. 物联网项目：连接传感器、执行器，构建智能监控、自动控制等系统；
2. 自动化任务：实现数据采集、消息推送、定时触发等自动化流程；
3. API整合：串联不同平台的API，完成数据互通与业务逻辑联动；
4. 快速原型开发：快速验证物联网或自动化方案的可行性，缩短开发周期。

配置说明

目录结构

~/fig/node-red/
├── docker-compose.yml  # 容器编排配置文件
└── data/               # 数据持久化目录
    ├── flows_cred.json # 流程凭证文件
    ├── flows.json      # 流程配置文件
    ├── lib/flows/      # 自定义节点库
    └── settings.js     # 系统设置文件

首次运行后会自动创建node-red目录及相关文件。

Docker Compose配置

yaml
node-red:
  image: vimagick/node-red
  ports:
    - "1880:1880"  # 映射Web界面端口
  volumes:
    - ./data:/data  # 挂载数据目录实现持久化
  restart: always   # 容器异常时自动重启

安全设置（settings.js）

javascript
module.exports = {
    adminAuth: {
        type: "credentials",
        users: [{
            username: "admin",  # 管理员用户名
            password: "$2a$08$zZWtXTja0fB1pzD4sHCMyOCMYz2Z6dNbM6tl8sJogENOMcxWV9DN.",  # 密码哈希值
            permissions: "*"    # 全权限
        }],
        default: {
            permissions: "read" # 普通用户默认只读权限
        }
    }
}

密码哈希可通过node-red-admin hash-pw命令生成，具体参考Node-RED安全文档。

启动与运行

1. 启动容器：

   bash
   docker-compose up -d
   

2. 生成密码哈希：

   bash
   docker-compose exec node-red node-red-admin hash-pw
   # 输入密码后获取哈希值，替换settings.js中的password字段
   

3. 安装扩展节点：

   bash
   docker-compose exec node-red bash
   cd /data
   apk add -U build-base  # 安装编译依赖（如需安装需要编译的节点）
   npm install node-red-node-irc  # 示例：安装IRC节点
   exit
   

4. 重启容器生效：

   bash
   docker-compose restart
   

扩展节点可从https://github.com/node-red/node-red-nodes%E8%8E%B7%E5%8F%96%E3%80%82