欢迎光临
我们一直在努力

不用从头写后端?Node-RED拖拽搭建HTTP接口实战

前言

在自动化、数据处理和设备联动项目中,经常需要接收消息、判断条件、调用接口,再把结果发送到下一个服务。直接编写完整程序当然可以,但对于简单流程来说,环境配置和代码结构往往比业务逻辑本身更耗时间。

Node-RED是一套基于流程的低代码开发工具。它把输入、处理和输出封装成不同节点,用户可以在浏览器中拖拽节点、连接线路,并通过调试面板观察消息如何在流程中传递。

它常被用于MQTT消息处理、HTTP接口、Webhook、数据库连接和智能家居自动化。简单流程可以主要依靠现成节点完成,遇到数据转换或复杂判断时,也可以在Function节点中编写少量JavaScript代码。

本文将通过Docker在极空间中部署Node-RED,先用Inject和Debug节点验证基础消息流,再搭建一个可以通过浏览器访问的/hello HTTP接口。最后使用cpolar为1880端口建立公网入口,方便在其他网络环境中调试和访问流程。

image-20260508152327650

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

957c00e3b3f0ce8aa95df96aa41b8715

2.2验证docker是否开启

使用命令:

docker -v
systemctl status -v

image-20251017103712618

3.部署Node-RED

通过Docker部署Node-RED:

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

docker –version

image-20260507155742946

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

docker pull nodered/node-red

image-20260507155819653

拉取镜像后,可以使用以下命令启动Node-RED容器:

docker run -d -p 1880:1880 –name mynodered nodered/node-red

参数说明:

  • -d:后台运行容器。
  • -p 1880:1880:将主机的1880端口映射到容器的1880端口。
  • –name mynodered:为容器指定名称。
  • nodered/node-red:指定使用的镜像。

image-20260507155854592

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

2053c6e0a9ef355f081fb39750adb8dd

4.使用Node-RED

一路默认安装:

2de4d90b7bf39c040e8a9be4df89ac0a

c78da4fe1cebb2abe23d6b9646937c2b

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

  • 打开 http://localhost:1880
  • 从左侧调色板拖一个 Inject 节点 到画布
  • 再拖一个 Debug 节点
  • 用鼠标从 Inject 连到 Debug
  • 点击右上角 部署(Deploy)
  • image-20260507171654026

    image-20260507172025265

    6.点击Inject节点左侧的按钮:

    出现如图所示内容即为正确运行!

    这个流程虽然简单,但它验证了:

    • 编辑器能正常加载
    • 节点能被实例化
    • 消息能正确传递
    • 调试面板能输出结果

    image-20260507171931975

    目标: 创建一个简单的HTTP端点,接收请求并返回响应。

    添加HTTP输入节点: 拖拽一个http in节点到画布,配置方法为GET,URL为/hello。

    image-20260507173908378

    添加函数节点: 拖拽一个function节点,编写以下代码:

    msg.payload = "Hello, Node-RED!";
    return msg;

    image-20260507173853168

    添加HTTP响应节点: 拖拽一个http response节点。

    连接节点: 将http in节点连接到function节点,再连接到http response节点。

    image-20260507173808434

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

    image-20260507174000049

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

    image-20260507173732791

    5.安装cpolar实现随时随地开发

    5.1 什么是cpolar?

    cpolar是一款安全高效的内网穿透工具,无需公网IP或复杂配置,只需一条命令,即可将本地服务器、Web服务或任意端口映射到公网,让你随时随地远程访问内网应用,特别适合开发调试、远程运维和应急部署等场景。

    5.2 部署cpolar

    cpolar 可以将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。

    ❤️以下是安装cpolar步骤:

    使用一键脚本安装命令:

    sudo curl https://get.cpolar.sh | sh

    image-20250725104019896

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

    sudo systemctl status cpolar

    22e5adfaf290a17fc3384bb296055259

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

    打开浏览器访问本地9200端口,使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

    8a6698b1bf26d64ba3645827fbfb1c29

    6.配置公网地址

    登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道:

    • 隧道名称:可自定义,本例使用了:node_red,注意不要与已有的隧道名称重复
    • 协议:http
    • 本地地址:1880
    • 域名类型:随机域名
    • 地区:选择China Top

    image-20260508151132823

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

    image-20260508151145184

    访问成功。

    image-20260508151937669

    7.保留固定公网地址

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

    image-20250918151358733

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

    image-20260508152057960

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

    image-20260508152123829

    修改隧道信息,将保留成功的二级子域名配置到隧道中

    • 域名类型:选择二级子域名
    • Sub Domain:填写保留成功的二级子域名
    • 地区: China Top

    点击更新

    image-20260508152209250

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

    image-20260508152229179

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

    image-20260508152255977

    总结

    完成以上配置后,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接口”和“管理编辑器”两类入口,避免把整个后台暴露出去。

    赞(0)
    未经允许不得转载:171主机测评 » 不用从头写后端?Node-RED拖拽搭建HTTP接口实战
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址