前言
在自动化、数据处理和设备联动项目中,经常需要接收消息、判断条件、调用接口,再把结果发送到下一个服务。直接编写完整程序当然可以,但对于简单流程来说,环境配置和代码结构往往比业务逻辑本身更耗时间。
Node-RED是一套基于流程的低代码开发工具。它把输入、处理和输出封装成不同节点,用户可以在浏览器中拖拽节点、连接线路,并通过调试面板观察消息如何在流程中传递。
它常被用于MQTT消息处理、HTTP接口、Webhook、数据库连接和智能家居自动化。简单流程可以主要依靠现成节点完成,遇到数据转换或复杂判断时,也可以在Function节点中编写少量JavaScript代码。
本文将通过Docker在极空间中部署Node-RED,先用Inject和Debug节点验证基础消息流,再搭建一个可以通过浏览器访问的/hello HTTP接口。最后使用cpolar为1880端口建立公网入口,方便在其他网络环境中调试和访问流程。

1.什么是Node-RED?
Node-RED是一款开源的、基于流(flow-based)的可视化编程工具,最初由IBM的工程师于2013年开发,旨在简化物联网(IoT)应用的开发流程。如今,它已成为一个由OpenJS Foundation托管的独立开源项目,广泛应用于设备连接、数据处理、自动化控制、Web API集成等场景。
核心特点:
-
可视化编程界面:
用户通过在浏览器中拖拽“节点”(nodes)并用连线将它们连接起来,构建数据流逻辑,无需编写大量代码。
-
基于 Node.js:
Node-RED 运行在 Node.js 环境之上,天然支持异步事件驱动和轻量级高性能处理,非常适合处理实时数据和网络通信。
-
丰富的节点库:
官方和社区提供了数千个预构建节点,涵盖 MQTT、HTTP、WebSocket、数据库(如 ySQL、MongoDB)、云平台(如 AWS IoT、阿里云)、硬件(如 Raspberry Pi、Arduino)等,极大提升开发效率。
-
低代码 / 零代码友好:
即使没有编程经验,用户也能通过图形化界面完成传感器数据采集、设备控制、消息推送等常见 IoT 任务;同时,也支持嵌入 JavaScript 代码以实现高级功能。
-
跨平台 & 轻量级:
可运行在树莓派、PC、服务器甚至云端容器中,资源占用小,部署灵活。
典型应用场景:
- 智能家居自动化(如根据温湿度自动开关空调)
- 工业设备监控与告警
- 将传感器数据上传至云端或数据库
- 构建 RESTful API 或 Webhook 接口
- 快速原型验证(Rapid Prototyping)
简单来说,Node-RED就像“物联网的乐高积木”——你只需选择合适的模块,把它们拼接起来,就能让设备“对话”、让数据“流动”、让想法“落地”。
在接下来的章节中,我们将从安装开始,手把手带你创建第一个Node-RED流程,真正体验“零代码玩转物联网”的乐趣。
2.前提条件
2.1ssh远程连接到极空间
- 开启【SSH 服务】
- 使用终端(Windows PowerShell / Mac Terminal)登录:
ssh root@IP

2.2验证docker是否开启
使用命令:
docker -v
systemctl status -v

3.部署Node-RED
通过Docker部署Node-RED:
在开始部署之前,确保你的系统已经安装了 Docker。可以通过以下命令检查 Docker 是否已安装:
docker –version

Node-RED提供了官方的Docker镜像,用户可以直接从Docker Hub拉取最新版本的镜像。
docker pull nodered/node-red

拉取镜像后,可以使用以下命令启动Node-RED容器:
docker run -d -p 1880:1880 –name mynodered nodered/node-red
参数说明:
- -d:后台运行容器。
- -p 1880:1880:将主机的1880端口映射到容器的1880端口。
- –name mynodered:为容器指定名称。
- nodered/node-red:指定使用的镜像。

部署完成后,在浏览器中输入 http://极空间IP:1880 就能看到Node-Red的界面:

4.使用Node-RED
一路默认安装:


一切就绪后,让我们做个简单测试:


6.点击Inject节点左侧的按钮:
出现如图所示内容即为正确运行!
这个流程虽然简单,但它验证了:
- 编辑器能正常加载
- 节点能被实例化
- 消息能正确传递
- 调试面板能输出结果

目标: 创建一个简单的HTTP端点,接收请求并返回响应。
添加HTTP输入节点: 拖拽一个http in节点到画布,配置方法为GET,URL为/hello。

添加函数节点: 拖拽一个function节点,编写以下代码:
msg.payload = "Hello, Node-RED!";
return msg;

添加HTTP响应节点: 拖拽一个http response节点。
连接节点: 将http in节点连接到function节点,再连接到http response节点。

部署流程: 点击右上角的“部署”按钮。

测试: 在浏览器中访问http://极空间ip:1880/hello,应看到页面显示 “Hello, Node-RED!”。

5.安装cpolar实现随时随地开发
5.1 什么是cpolar?
cpolar是一款安全高效的内网穿透工具,无需公网IP或复杂配置,只需一条命令,即可将本地服务器、Web服务或任意端口映射到公网,让你随时随地远程访问内网应用,特别适合开发调试、远程运维和应急部署等场景。
5.2 部署cpolar
cpolar 可以将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤:
使用一键脚本安装命令:
sudo curl https://get.cpolar.sh | sh

安装完成后,执行下方命令查看cpolar服务状态:(如图所示即为正常启动)
sudo systemctl status cpolar

Cpolar安装和成功启动服务后,在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面,使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可:
打开浏览器访问本地9200端口,使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

6.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道:
- 隧道名称:可自定义,本例使用了:node_red,注意不要与已有的隧道名称重复
- 协议:http
- 本地地址:1880
- 域名类型:随机域名
- 地区:选择China Top

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址,接下来就可以在其他电脑或者移动端设备(异地)上,使用地址访问。

访问成功。

7.保留固定公网地址
使用cpolar为其配置二级子域名(cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站),该地址为固定地址,不会随机变化。

点击左侧的预留,选择保留二级子域名,地区选择china Top,然后设置一个二级子域名名称,我使用的是nodered,大家可以自定义。填写备注信息,点击保留。

登录cpolar web UI管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道,点击右侧的编辑。

修改隧道信息,将保留成功的二级子域名配置到隧道中
- 域名类型:选择二级子域名
- Sub Domain:填写保留成功的二级子域名
- 地区: China Top
点击更新

更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称。

最后,我们使用固定的公网地址在任意设备的浏览器中访问,可以看到成功访问的页面,这样一个永久不会变化的二级子域名公网网址即设置好了。

总结
完成以上配置后,Node-RED已经可以在极空间中运行。通过Inject和Debug节点,可以验证消息是否正常进入流程并输出到调试面板;通过HTTP In、Function和HTTP Response节点,则可以搭建一个简单的Web接口。
这个示例虽然没有连接真实传感器或MQTT设备,但已经展示了Node-RED最基础的工作方式:由输入节点接收事件,中间节点处理数据,最后交给输出节点返回结果。后续可以在此基础上继续增加定时任务、Webhook、数据库或设备控制节点。
通过cpolar为1880端口建立公网隧道后,原本只能在局域网中访问的Node-RED页面和HTTP接口,也可以从其他网络环境打开。继续配置固定二级子域名后,访问入口能够保持不变。
需要注意的是,当前Docker命令没有挂载Node-RED的/data目录。创建的流程、安装的节点和部分配置可能只保存在容器中,删除或重建容器后存在丢失风险。长期使用前,建议增加数据卷挂载、自动重启策略,并固定镜像版本。
此外,Node-RED编辑器具备修改流程、调用接口和管理节点的能力,不应在没有认证的情况下直接公开到互联网。正式开放公网前,应配置编辑器账号密码,限制固定地址的分享范围,并区分“公开HTTP接口”和“管理编辑器”两类入口,避免把整个后台暴露出去。




