2. Node-RED 环境搭建：Node.js安装、Node-RED全局安装与启动、浏览器访问与初始界面

在开始设备接入与流编排之前，必须首先搭建稳定的 Node-RED 运行环境。本章将引导你完成从 Node.js 安装到 Node-RED 启动、浏览器访问的全流程，确保开发环境就绪。

2.1 环境依赖概览

Node-RED 基于 Node.js 运行时构建，其核心依赖关系如下表所示：

2.2 Node.js 安装

Node.js 是 Node-RED 的运行基石。以下为各主流操作系统的安装方式：

2.2.1 Windows 安装

1. 访问 nodejs.org，下载 Windows 版 LTS 安装包（.msi）。
2. 双击运行安装程序，保持默认选项，勾选“Automatically install the necessary tools”。
3. 安装完成后，打开命令提示符（cmd）或 PowerShell，验证安装：

node --version
npm --version

2.2.2 macOS 安装

1. 推荐使用 Homebrew 安装：

brew install node@20
brew link --overwrite node@20

2. 或从 nodejs.org 下载 macOS 版 .pkg 安装包。
3. 验证安装：

node --version
npm --version

2.2.3 Linux 安装（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
npm --version

2.3 Node-RED 全局安装

Node.js 安装完成后，使用 npm 全局安装 Node-RED：

npm install -g --unsafe-perm node-red

参数说明：

• -g：全局安装，使 node-red 命令可在任意路径下执行。
• --unsafe-perm：以 root 权限运行时避免权限错误（Linux/macOS 推荐）。

安装完成后，验证版本：

node-red --version

2.4 启动 Node-RED

在终端中执行以下命令启动 Node-RED 服务：

node-red

启动成功后，终端输出类似以下信息：

Welcome to Node-RED
===================
...
Server now running at http://127.0.0.1:1880/
...
Started flows

默认配置参数：

2.5 浏览器访问与初始界面

打开浏览器，访问 http://127.0.0.1:1880，即可进入 Node-RED 编辑器界面。

初始界面由以下核心区域组成：

各区域功能说明：

2.6 环境验证与常见问题

启动成功后，建议执行以下验证步骤：

1. 在浏览器中确认编辑器界面完整加载，无报错。
2. 从左侧调色板拖拽一个 inject 节点和一个 debug 节点到工作区。
3. 用鼠标连接两个节点（从 inject 的输出口拖到 debug 的输入口）。
4. 点击右上角红色“部署”按钮，再点击 inject 节点左侧的按钮触发一次输入。
5. 在右侧“调试”标签页中查看输出消息。

常见问题及解决方案：