nodered/node-red-docker

Node-RED-Docker

弃用通知：

此仓库已弃用，建议使用 https://hub.docker.com/r/nodered/node-red

所有新版本（1.0.0及以上）将通过该渠道提供。

此处提供的最后版本为0.20.8。

本项目介绍了在Docker下运行Node-RED的多种方式。假设用户已具备Docker和https://docs.docker.com/reference/commandline/cli/%E7%9A%84%E5%9F%BA%E6%9C%AC%E5%B8%B8%E8%AF%86%E3%80%82

本项目还提供DockerHub上nodered/node-red-docker容器的构建，地址：https://hub.docker.com/r/nodered/node-red-docker/%E3%80%82

基本运行方法

最简单的直接运行命令：

bash
docker run -it -p 1880:1880 --name mynodered docker.xuanyuan.run/nodered/node-red-docker

命令解析：

• docker run - 运行容器，必要时先本地构建
• -it - 附加终端会话，以便查看运行情况
• -p 1880:1880 - 将本地端口1880映射到容器暴露的内部端口1880
• --name mynodered - 为容器指定友好的本地名称
• nodered/node-red-docker - 基础镜像，当前为Node-RED v0.14.5

运行后，终端将显示Node-RED的启动信息：

Welcome to Node-RED
===================
8 Apr 12:13:44 - [info] Node-RED version: v0.14.5
8 Apr 12:13:44 - [info] Node.js  version: v4.4.7
.... etc

此时可通过http://{主机IP}:1880访问Node-RED界面。

通过指定名称可更方便地管理容器，固定主机端口便于访问（但一次只能运行一个实例）。

若需分离终端（容器继续后台运行），按Ctrl-p``Ctrl-q。

重新附加终端（查看日志）：

bash
docker attach mynodered

重启容器（如系统重启或Docker守护进程重启后）：

bash
docker start mynodered

停止容器：

bash
docker stop mynodered

注意：此Dockerfile配置将flows.json文件和安装的额外节点存储在容器外部，以便重建基础容器时不会永久丢失自定义内容。

容器布局

本仓库包含构建不同Node-RED Docker镜像的Dockerfile：

• latest - 基于https://hub.docker.com/_/node/
• slim - 基于https://hub.docker.com/r/mhart/alpine-node/
• rpi - 基于https://hub.docker.com/r/hypriot/rpi-node/

Alpine Linux版本可减小镜像体积（约100MB vs 约700MB），但移除了原生模块编译所需的标准依赖。如需添加带原生依赖的模块，建议使用标准镜像或扩展slim镜像以补充缺失的包。

构建镜像命令：

bash
docker build -f <版本>/Dockerfile -t mynodered:<版本> .

package.json

package.json是元文件，用于下载安装指定版本的Node-RED及其他构建时所需的npm包。Docker构建过程中，依赖将安装在/usr/src/node-red目录下。

主要修改部分：

json
"dependencies": {
    "node-red": "0.14.x",           // 设置Node-RED版本
    "node-red-node-rbe": "*"        // 添加额外npm包
},
"scripts": {
    "start": "node-red -v $FLOWS"   // 容器运行时启动Node-RED的命令
}

启动配置

Node-RED通过NPM start从/usr/src/node-red启动，--userDir参数指向容器的/data目录。

flows配置文件通过环境变量FLOWS设置，默认为*'flows.json'*，可在运行时通过以下命令修改：

bash
docker run -it -p 1880:1880 -e FLOWS=my_flows.json docker.xuanyuan.run/nodered/node-red-docker

Node.js运行参数可通过环境变量NODE_OPTIONS传递。例如，设置Node.js垃圾回收堆大小：

bash
docker run -it -p 1880:1880 -e NODE_OPTIONS="--max_old_space_size=128" docker.xuanyuan.run/nodered/node-red-docker

添加节点

可通过以下方式为Docker中运行的Node-RED实例安装额外节点：

Node-RED管理工具

使用管理工具，通过容器到主机的端口转发，无需离开主机即可安装节点：

bash
npm install -g node-red-admin
node-red-admin install node-red-node-openwhisk

该工具默认假设Node-RED在http://localhost:1880可用。刷新浏览器页面即可在面板中看到新添加的节点。

容器Shell

bash
docker exec -it mynodered /bin/bash

进入容器命令行后，运行npm安装命令：

bash
cd /data
npm install node-red-node-smooth
exit
docker stop mynodered
docker start mynodered

刷新浏览器页面即可看到新节点。

主机目录作为卷

将主机目录挂载为数据卷运行容器，可在主机目录中手动运行npm install，主机目录中的文件将自动同步到容器文件系统：

bash
docker run -it -p 1880:1880 -v ~/.node-red:/data --name mynodered docker.xuanyuan.run/nodered/node-red-docker

在主机中安装节点：

bash
cd ~/.node-red
npm install node-red-node-smooth
docker stop mynodered
docker start mynodered

注意：带原生依赖的模块将在主机架构上编译，仅当主机架构与容器基础镜像匹配时才能在容器中工作。建议通过容器shell安装原生模块，或更新项目package.json后重新构建。

构建自定义镜像

以公共Node-RED镜像为基础创建新Docker镜像，可在构建过程中安装额外节点。

以下Dockerfile构建包含flightaware模块的自定义Node-RED镜像：

dockerfile
FROM docker.xuanyuan.run/nodered/node-red-docker
RUN npm install node-red-contrib-flightaware

也可修改本仓库的package.json后从头构建镜像，这还允许修改安装的Node-RED版本。

管理用户数据

为避免容器销毁时丢失自定义内容，可通过以下方式管理用户数据：

将更改保存为自定义镜像

容器内的修改（如手动添加节点或创建flows）仅在容器生命周期内有效。可将容器当前状态提交为新镜像：

bash
docker commit mynodered custom-node-red-docker

销毁mynodered容器后，可使用custom-node-red-docker镜像恢复实例。

使用命名数据卷

Docker支持使用https://docs.docker.com/engine/tutorials/dockervolumes/%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%A4%96%E9%83%A8%E5%AD%98%E5%82%A8%E6%8C%81%E4%B9%85%E5%8C%96%E6%88%96%E5%85%B1%E4%BA%AB%E6%95%B0%E6%8D%AE%EF%BC%8C%E6%95%B0%E6%8D%AE%E5%8D%B7%E4%B8%AD%E7%9A%84%E6%96%87%E4%BB%B6%E5%9C%A8%E5%AE%B9%E5%99%A8%E7%A7%BB%E9%99%A4%E5%90%8E%E4%BB%8D%E5%AD%98%E5%9C%A8%E3%80%82

Node-RED使用/data目录存储用户配置数据。将数据卷挂载到该目录可使配置数据保存在容器外部，甚至在容器实例间共享。

创建并使用命名数据卷：

bash
docker volume create --name node_red_user_data
docker volume ls  # 查看卷
docker run -it -p 1880:1880 -v node_red_user_data:/data --name mynodered docker.xuanyuan.run/nodered/node-red-docker

创建并部署示例flows后，销毁并重启容器，用户数据不会丢失：

bash
docker rm mynodered
docker run -it -p 1880:1880 -v node_red_user_data:/data --name mynodered docker.xuanyuan.run/nodered/node-red-docker

更新

更新基础容器镜像：

bash
docker pull docker.xuanyuan.run/nodered/node-red-docker
docker stop mynodered
docker start mynodered

无头运行

最简化运行Node-RED：

bash
docker run -d -p 1880 docker.xuanyuan.run/nodered/node-red-docker

此命令将创建运行实例，使用随机端口。通过以下命令查看端口：

bash
docker ps -a

输出示例：

CONTAINER ID        IMAGE                       COMMAND             CREATED             STATUS                     PORTS                     NAMES
4bbeb39dc8dc        nodered/node-red-docker:latest   "npm start"         4 seconds ago       Up 4 seconds               0.0.0.0:49154->1880/tcp   furious_yalow

通过http://{主机IP}:49154（示例端口）访问。

链接容器

使用--link选项可在Docker运行时内部链接容器。

例如，运行MQTT broker容器：

bash
docker run -it --name mybroker docker.xuanyuan.run/nodered/node-red-docker

（无需全局暴露1883端口，除非需要外部访问）

运行Node-RED容器并链接broker：

bash
docker run -it -p 1880:1880 --name mynodered --link mybroker:broker docker.xuanyuan.run/nodered/node-red-docker

--link会在Node-RED实例的hosts文件中添加名为broker的条目，指向mybroker实例。暴露1880端口以便外部浏览器编辑flows。

以下flows示例可使用broker别名连接：

json
[{"id":"190c0df7.e6f3f2","type":"mqtt-broker","broker":"broker","port":"1883","clientid":""},{"id":"37963300.c869cc","type":"mqtt in","name":"","topic":"test","broker":"190c0df7.e6f3f2","x":226,"y":244,"z":"f34f9922.0cb068","wires":[["802d92f9.7fd27"]]},{"id":"edad4162.1252c","type":"mqtt out","name":"","topic":"test","qos":"","retain":"","broker":"190c0df7.e6f3f2","x":453,"y":135,"z":"f34f9922.0cb068","wires":[]},{"id":"13d1cf31.ec2e31","type":"inject","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"x":226,"y":157,"z":"f34f9922.0cb068","wires":[["edad4162.1252c"]]},{"id":"802d92f9.7fd27","type":"debug","name":"","active":true,"console":"false","complete":"false","x":441,"y":261,"z":"f34f9922.0cb068","wires":[]}]

默认内部broker不暴露到Docker主机外部，如需外部访问，可在broker运行命令中添加-p 1883:1883。