使用Node-RED API离线安装节点时遭遇模块未找到错误求助

你之前操作的问题分析 #

• 直接指定package.json路径：Admin API的POST /nodes接口需要的是完整npm包的源路径，而非单个配置文件，因此无法识别。
• 指定解压后的目录但未加file:前缀：Node-RED底层调用npm install时，会把无前缀的路径当成包名去远程源查找，离线环境下自然找不到，触发“模块未找到”错误。
• 直接传未解压的.tgz文件：正如你所知，该API不支持直接传入压缩包，因此无效。

可行的解决方法 #

方法1：正确使用Admin API安装 #

确保.tgz已解压为完整的npm包目录（包含package.json及所有节点文件），然后调用API时，在请求体的module字段中填写带file:前缀的绝对路径，示例：

{
  "module": "file:/opt/node-red/custom-nodes/my-node-folder"
}

注意：路径必须是绝对路径，避免相对路径导致Node-RED解析错误。

方法2：手动复制节点文件（最可靠的离线方案） #

1. 将解压后的节点目录完整复制到Node-RED用户目录下的nodes文件夹（通常路径为~/.node-red/nodes）
2. 若该节点有依赖包，需提前将依赖包离线安装到~/.node-red/node_modules目录
3. 重启Node-RED，节点会自动被加载到面板中

方法3：用npm本地安装后加载 #

1. 进入Node-RED的用户目录（cd ~/.node-red）
2. 执行本地安装命令：

   # 从解压后的目录安装
   npm install /path/to/unpacked-node-folder
   # 或直接从.tgz包安装（npm支持本地压缩包）
   npm install /path/to/node-package.tgz
   

3. 安装完成后重启Node-RED，节点即可正常使用

内容的提问来源于stack exchange，提问作者Rohit Soni