Node-RED管理器Skill node-red-manager

---

name: node-red-manager description: 通过管理API或CLI管理Node-RED实例。自动化流程部署、安装节点和故障排除。当用户想要“构建自动化”、“连接设备”或“修复node-red”时使用。

Node-RED 管理器

设置

1. 复制 .env.example 文件为 .env。
2. 在 .env 文件中设置 NODE_RED_URL、NODE_RED_USERNAME 和 NODE_RED_PASSWORD。
3. 脚本会在首次运行时自动处理依赖项。

基础设施

• 堆栈位置: deployments/node-red
• 数据卷: deployments/node-red/data
• Docker服务: mema-node-red
• URL: https://flow.glassgallery.my.id

使用方法

流程管理

# 列出所有流程
scripts/nr list-flows

# 通过ID获取特定流程
scripts/nr get-flow <flow-id>

# 从文件部署流程
scripts/nr deploy --file assets/flows/watchdog.json

# 更新特定流程
scripts/nr update-flow <flow-id> --file updated-flow.json

# 删除流程
scripts/nr delete-flow <flow-id>

# 获取流程运行时状态
scripts/nr get-flow-state

# 设置流程运行时状态
scripts/nr set-flow-state --file state.json

备份与恢复

# 将所有流程备份到文件
scripts/nr backup
scripts/nr backup --output my-backup.json

# 从备份恢复流程
scripts/nr restore node-red-backup-20260210_120000.json

节点管理

# 列出已安装的节点
scripts/nr list-nodes

# 安装节点模块
scripts/nr install-node node-red-contrib-http-request

# 获取节点信息
scripts/nr get-node node-red-contrib-http-request

# 启用/禁用节点
scripts/nr enable-node node-red-contrib-http-request
scripts/nr disable-node node-red-contrib-http-request

# 移除节点
scripts/nr remove-node node-red-contrib-http-request

运行时信息

# 获取运行时设置
scripts/nr get-settings

# 获取运行时诊断信息
scripts/nr get-diagnostics

上下文管理

# 获取上下文值
scripts/nr get-context flow my-key
scripts/nr get-context global shared-data

# 设置上下文值
scripts/nr set-context flow my-key '"value"'
scripts/nr set-context global counter '42'
scripts/nr set-context global config '{"key": "value"}'

Docker 操作

# 重启 Node-RED
cd deployments/node-red && docker compose restart

# 查看日志
docker logs mema-node-red --tail 100

# 实时跟踪日志
docker logs -f mema-node-red

环境变量

• NODE_RED_URL: Node-RED API 端点 (默认: http://localhost:1880)
• NODE_RED_USERNAME: 管理员用户名
• NODE_RED_PASSWORD: 管理员密码

为向后兼容，也支持旧版变量名 (NR_URL, NR_USER, NR_PASS)。

API 参考

完整的管理员API端点文档请参见 references/admin-api.md。