machinedata/node-red

支持的标签及对应Dockerfile链接

• latest, 1, 1.6, 1.6.2 https://github.com/machine-data/docker-oauth2_proxy/blob/master/Dockerfile
• 1.5, 1.5.1 https://github.com/machine-data/docker-node-red/blob/v1.5.1/Dockerfile

Docker上的Node-RED

本仓库包含Node-RED Docker镜像的构建定义及支持文件，已作为自动化构建镜像machinedata/node-red发布于Docker Hub。

什么是Node-RED？

Node-RED是一款用于将硬件设备、API和在线服务以新颖有趣的方式连接起来的工具。

为何选择此Node-RED容器？

该镜像具有以下特点：

• 基于官方Alpine Linux镜像，超轻量且体积小巧；
• 仅依赖node.js和node-gyp（部分扩展包所需）；
• 配置简洁，支持通过环境变量或配置文件自定义，遵循上游规范；
• 遵循Docker最佳实践（放弃root权限、使用PID1处理信号、规范日志等）；
• 所有用户数据存储于/data目录，支持挂载卷。

快速开始

启动Node-RED并通过http://{主机名}:1880访问：

sh
$ docker run -d -p 1880:1880 machinedata/node-red

建议挂载卷存储应用数据（流文件和扩展模块）：

sh
$ mkdir data
$ docker run -d \
    --volume $(pwd)/data:/data \
    --publish 1880:1880 \
    machinedata/node-red

环境变量

可通过环境变量配置Node-RED（无配置文件时自动生成默认配置）：

• NODE_RED_FLOW_FILE：流文件名称，默认值为flows.json；
• NODE_RED_USER_DIR：用户数据存储目录，对应settings.js中的userDir，默认值为/data。

示例：使用自定义流文件启动Node-RED：

sh
$ mkdir -p /mnt/data/flows
$ touch /mnt/data/flows/my_flow.json
$ docker run -d \
             -e NODE_RED_FLOW_FILE=my_flow.json \
             -v /mnt/data/flows:/data \
             -p 1880:1880 machinedata/node-red

配置文件

容器默认使用/config/settings.js作为配置文件。若挂载自定义配置文件（建议只读），环境变量将被忽略：

sh
$ curl -O https://raw.githubusercontent.com/node-red/node-red/master/settings.js
$ sed -i -e "s#//userDir: '.*'#userDir: '/data'#" settings.js
$ docker run -d \
             -v $(pwd)/settings.js:/config/settings.js:ro \
             -p 1880:1880 machinedata/node-red

卷

• /data：Node-RED用户数据存储路径，通过Web界面安装的扩展包将保存于/data/node_modules。

端口

• 1880：Node-RED默认监听端口，可通过$PORT环境变量修改。

***声明

Node-RED是JS基金会的项目，由IBM新兴技术团队创建，遵循Apache 2.0许可证。本Docker镜像由Jodok Batlogg创建，遵循Apache 2.0许可证，版权归Crate.io所有。

贡献指南

欢迎通过GitHub提交问题或分叉仓库创建拉取请求参与贡献，如有疑问可通过Slack联系。