Node-RED自定义节点部署后一次性加载配置的实现方法

阿华AIGC实验室

2026-5-15

嘿，我完全懂你的需求——不想让用户手动点ADD按钮，而是让自定义节点一部署就自动加载一份固定的共享配置，还能和其他输入输出节点共用。和MQTT那些需要手动创建配置节点的路子不一样，咱们来搞个自动加载的方案：

实现部署后自动加载共享固定配置的步骤

1. 先定义一个隐藏的共享配置节点

首先得有个配置节点当共享配置的载体，但这个节点不用用户手动创建，所以咱们把它藏起来。在你的节点模块里注册这个配置节点：

RED.nodes.registerType('my-shared-config', {
    category: 'config',
    defaults: {
        apiUrl: { value: 'https://your-fixed-api.com', required: true },
        apiKey: { value: 'your-fixed-key', required: true }
        // 这里放所有你需要共享的固定配置项
    },
    label: function() {
        return '内部共享配置';
    },
    hidden: true // 关键：让用户在节点面板看不到这个配置节点
});

设置hidden: true后，用户就没法手动创建或修改它，完全由咱们的代码控制。

2. 部署完成后自动创建/复用配置节点

接下来要监听Node-RED的部署事件，一旦部署完成，就检查有没有现成的共享配置节点，没有的话就自动创建一个：

RED.events.on('runtime-deploy', function() {
    // 用固定的节点ID，方便后续其他节点精准引用
    const CONFIG_NODE_ID = 'my-shared-config-001';
    const existingConfig = RED.nodes.getNode(CONFIG_NODE_ID);

    if (!existingConfig) {
        // 创建新的配置节点实例
        const configNode = RED.nodes.createNode(CONFIG_NODE_ID, {
            type: 'my-shared-config',
            apiUrl: 'https://your-fixed-api.com',
            apiKey: 'your-fixed-key'
            // 同步上面defaults里的固定配置值
        });
        // 把配置节点加入Node-RED的节点池
        RED.nodes.add(configNode);
        // 保存到存储，确保重启Node-RED后配置不会丢
        RED.nodes.save();
    }
});

每次部署都做这个检查，既能保证配置节点存在，又不会重复创建多个实例。

3. 让输入/输出节点自动绑定共享配置

现在要让你的业务节点（输入/输出节点）自动用上这个共享配置。在节点定义里，把配置项指向咱们的共享配置节点，并且锁定它不让用户修改：

RED.nodes.registerType('my-custom-input', {
    category: 'input',
    defaults: {
        name: { value: '' },
        // 默认直接绑定到我们的固定配置节点ID，指定类型为共享配置节点
        sharedConfig: { value: 'my-shared-config-001', type: 'my-shared-config' }
    },
    inputs: 0,
    outputs: 1,
    oneditprepare: function() {
        // 编辑界面里隐藏配置选择框，不让用户改
        $('#node-input-sharedConfig').hide();
    },
    oneditsave: function() {
        // 强制锁定配置ID，防止用户通过调试工具修改
        this.sharedConfig = 'my-shared-config-001';
    },
    onStart: function() {
        // 节点启动时获取共享配置
        const config = RED.nodes.getNode(this.sharedConfig);
        if (config) {
            // 这里就可以用配置内容了，比如
            this.apiUrl = config.apiUrl;
            this.apiKey = config.apiKey;
            console.log('已加载共享配置:', this.apiUrl);
        }
    }
});

这样一来，用户把你的节点拖到流里部署后，节点会自动获取到共享配置，完全不需要用户手动操作。