Node-RED 开发/测试镜像文档

1. 镜像概述与主要用途

1.1 镜像概述

本镜像为 Node-RED 项目的开发/测试专用镜像，包含项目分支的不稳定构建版本及清单列表（manifest lists）。镜像内容基于 Node-RED 开发分支代码构建，用于开发阶段的功能验证与测试，严禁用于生产环境。官方稳定镜像请参考 nodered/node-red。

1.2 主要用途

• 提供 Node-RED 开发分支的实时构建环境，支持测试最新代码与功能
• 用于验证新特性、bug 修复及分支代码的稳定性
• 作为开发人员本地调试、贡献代码的临时运行环境

2. 核心功能与特性

• 包含开发分支代码：集成 Node-RED 项目各开发分支的最新代码，反映未发布的开发进度
• 支持功能测试：可用于提前测试计划发布的新功能、优化及修复
• 多架构支持：包含镜像清单列表（manifest lists），可能支持多种硬件架构（需根据具体分支构建配置）
• 高频更新：随开发分支代码提交频繁更新，保持与上游开发进度同步
• 临时构建产物：包含分支构建过程中的中间产物与测试清单，便于开发调试

3. 使用场景与适用范围

3.1 适用场景

• Node-RED 开发人员本地测试新功能或 bug 修复
• 贡献者在提交代码前验证分支功能完整性
• 测试环境中验证上游分支代码对业务场景的兼容性

3.2 适用范围

• 仅限开发/测试环境，不支持生产环境部署
• 适用于熟悉 Node-RED 开发流程的技术人员
• 需配合 Node-RED 源码仓库（GitHub）使用

4. 使用方法与配置说明

4.1 获取镜像

通过 Docker 命令拉取镜像（标签为开发分支标识，如 dev 或具体分支名，标签可能随时变更）：

docker pull nodered/node-red:dev  # 示例标签，实际标签需参考项目分支命名

4.2 基本运行示例

使用 docker run 启动容器，映射默认端口（1880）并挂载本地目录（用于临时数据存储）：

docker run -it \
  -p 1880:1880 \  # 映射 Node-RED  Web 界面端口
  -v ./node-red-data:/data \  # 挂载本地目录作为数据卷（测试数据建议定期备份）
  --name node-red-dev \  # 容器名称
  nodered/node-red:dev  # 镜像及标签（标签需替换为实际使用的开发分支标签）

4.3 核心配置说明

4.3.1 环境变量

（注：环境变量与官方稳定镜像基本兼容，但开发版本可能存在差异，以下为常用变量）

• PORT：Node-RED 服务端口，默认 1880
• NODE_RED_HOME：Node-RED 主目录，默认 /usr/src/node-red
• USER：运行用户，默认 node-red
• NODE_OPTIONS：Node.js 运行参数（如 --inspect 用于调试）

示例：指定自定义端口并启用调试模式

docker run -it \
  -p 1881:1881 \
  -e PORT=1881 \
  -e NODE_OPTIONS=--inspect \
  nodered/node-red:dev

4.3.2 数据持久化

由于镜像为开发/测试性质，数据可能因镜像更新或标签变更丢失，建议：

• 挂载本地目录作为数据卷（如示例中的 /data）
• 定期备份挂载目录中的配置文件（flows.json、settings.js 等）

5. 注意事项

• 生产环境禁用：镜像包含不稳定代码，可能存在未知 bug，严禁用于生产部署
• 标签不稳定性：镜像标签（tag）可能随时删除、重命名或更新，使用前需确认最新分支标签
• 数据风险：测试数据建议仅临时存储，避免依赖该镜像保存关键数据
• 问题反馈：使用中遇到的问题请通过 Node-RED 社区论坛 或 GitHub 仓库 反馈

参考链接

• 官方稳定镜像：nodered/node-red
• Node-RED 官网：nodered.org
• 项目代码仓库：GitHub
• 社区论坛：discourse.nodered.org