selorbis/rpi-nodered

Nodered 树莓派 Docker 镜像文档

1. 镜像概述

本镜像是专为树莓派（Raspberry Pi）平台构建的 Nodered 应用容器化解决方案，基于 hypriot/rpi-node 基础镜像构建，集成了 Nodered 流程编排工具。镜像通过 Gitlab CI 实现自动化构建，确保版本更新的及时性与一致性。其中，latest 标签对应最新稳定发布版本，便于用户快速获取当前最新功能。

2. 核心功能与特性

2.1 Nodered 核心功能

• 轻量级流程自动化：支持通过可视化界面拖拽节点、配置连接，实现数据流转与业务逻辑编排，无需复杂代码开发。
• 丰富节点生态：内置数百种官方及社区贡献的节点，覆盖物联网（IoT）设备通信、数据处理、API 集成、定时任务等场景。
• Node.js 运行时：基于 Node.js 构建，可直接调用 JavaScript 代码扩展功能，兼容 Node.js 生态系统中的库与工具。

2.2 镜像特性

• 树莓派优化：基于 hypriot/rpi-node 基础镜像，针对 ARM 架构的树莓派硬件进行适配，确保运行稳定性与资源效率。
• 自动化构建：通过 Gitlab CI 流水线自动构建，保证镜像版本与 Nodered 官方更新同步，减少手动维护成本。
• 标签管理：latest 标签指向最新发布版本，便于用户快速获取稳定版本，简化版本管理流程。

3. 使用场景与适用范围

3.1 典型应用场景

• 物联网（IoT）项目：树莓派作为边缘设备，通过 Nodered 连接传感器、执行器，实现数据采集、设备控制流程自动化（如温湿度监控、灯光控制）。
• 家庭自动化：整合智能家居设备（如智能开关、摄像头、语音助手），构建自定义联动逻辑（如“进门自动开灯”“检测到烟雾触发警报”）。
• 数据采集与处理：对接数据库、API 接口或本地文件，实现数据清洗、格式转换、定时上报等轻量级数据处理流程。
• 轻量级服务集成：快速串联多个微服务或第三方平台（如 MQTT broker、HTTP 服务、云平台），实现跨系统数据交互与业务协同。

3.2 适用范围

• 硬件：树莓派系列（Raspberry Pi 2/3/4/Zero W 等支持 ARM 架构的型号）。
• 系统：支持 Docker 的树莓派操作系统（如 Raspberry Pi OS、HypriotOS）。
• 用户：物联网开发者、家庭自动化爱好者、需要快速实现流程自动化的技术人员。

4. 使用方法与配置说明

4.1 镜像拉取

通过 Docker 命令拉取最新版本镜像：

bash
docker pull [镜像仓库地址]/nodered-rpi:latest

注：请将 [镜像仓库地址] 替换为实际镜像仓库路径（如 Gitlab 容器 registry 地址）。

4.2 容器运行

4.2.1 基础运行命令

bash
docker run -d \
  --name nodered \
  -p 1880:1880 \
  --restart unless-stopped \
  [镜像仓库地址]/nodered-rpi:latest

• -d：后台运行容器。
• --name nodered：指定容器名称为 nodered。
• -p 1880:1880：映射容器内 Nodered 默认端口（1880）到主机端口，允许外部访问。
• --restart unless-stopped：容器退出时自动重启（除非手动停止）。

4.2.2 数据持久化配置

为避免容器重建导致流程配置丢失，需挂载数据卷持久化 Nodered 工作目录（/data）：

bash
docker run -d \
  --name nodered \
  -p 1880:1880 \
  -v /path/on/host/nodered-data:/data \
  --restart unless-stopped \
  [镜像仓库地址]/nodered-rpi:latest

• -v /path/on/host/nodered-data:/data：将主机目录 /path/on/host/nodered-data 挂载到容器内 /data 目录，存储流程配置、节点数据等持久化文件。

4.3 Docker Compose 配置示例

创建 docker-compose.yml 文件，简化容器管理：

yaml
version: '3'
services:
  nodered:
    image: [镜像仓库地址]/nodered-rpi:latest
    container_name: nodered
    ports:
      - "1880:1880"
    volumes:
      - ./nodered-data:/data  # 相对路径挂载，数据存储在当前目录下的 nodered-data 文件夹
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

4.4 访问与使用

容器启动后，通过浏览器访问树莓派 IP 地址的 1880 端口，即可打开 Nodered 可视化编辑器：

http://<树莓派IP>:1880

在编辑器中拖拽节点、配置流程，完成后点击“部署”即可运行。

4.5 配置参数说明

当前镜像暂未定义特定环境变量或配置参数。如需自定义 Nodered 运行参数（如修改端口、添加节点模块），可通过以下方式实现：

• 修改端口：调整 docker run 或 docker-compose.yml 中的端口映射（如 -p 8080:1880 将主机 8080 端口映射到容器 1880 端口）。
• 安装额外节点：进入容器内部执行 npm install <node-package>，或通过 Nodered 编辑器的“管理面板 > 安装”功能在线安装。
• 持久化配置：通过数据卷挂载 /data 目录，确保自定义节点、流程配置在容器重建后不丢失。