node-red-contrib-symi-modbus 2.0.0 → 2.1.0

package/README.md

@@ -2,6 +2,44 @@
 
 Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成。
 
+> **最新版本 v2.1.0** - 修复MQTT连接错误日志输出，优化连接稳定性
+
+## 版本更新
+
+### v2.1.0 (2025-10-20) - MQTT连接与认证完善
+
+**核心修复**：
+- 修复MQTT连接error事件处理不当导致错误日志被吞掉的问题
+- 改善错误日志输出，所有MQTT连接错误现在都会被记录
+- 优化重试逻辑，避免极快重试但确保错误被捕获
+- 修复package.json循环依赖问题（移除对自身的依赖）
+- 添加MQTT认证调试日志，方便排查认证问题
+- 完善MQTT认证支持，确保用户名密码正确传递
+- 移除所有emoji图标，确保在工控机环境下正常显示
+
+**MQTT认证配置**：
+如果MQTT broker需要认证（如Home Assistant的MQTT集成），必须在MQTT服务器配置节点中填写用户名和密码：
+1. 打开任意主站或从站节点配置
+2. 点击"MQTT服务器"右边的编辑按钮
+3. 填写用户名和密码（例如：hasskit/hasskit）
+4. 保存并部署
+
+**测试验证**：
+- 本地Node-RED环境测试通过
+- MQTT broker连接测试通过（nc -z -v -w2 192.168.2.12 1883）
+- MQTT认证测试通过（用户名密码正确传递）
+- 成功发布32个MQTT发现消息到Home Assistant
+- 适合Linux工控机24/7长期稳定运行
+
+**升级方式**：
+```bash
+cd ~/.node-red
+npm install node-red-contrib-symi-modbus@latest
+# 重启Node-RED生效
+```
+
+---
+
 ## 功能特性
 
 - 多协议支持：支持Modbus TCP和Modbus RTU（串口）
@@ -45,45 +83,39 @@ Node-RED的Modbus继电器控制节点，支持TCP/串口通信和MQTT集成。
 
 本节点支持**智能地址fallback机制**，自动适配不同部署环境：
 
-** HassOS/Home Assistant环境**
+**HassOS环境（推荐）**
 ```yaml
-推荐配置: mqtt://core-mosquitto:1883
-备选地址: mqtt://supervisor:1883 或 mqtt://homeassistant.local:1883
+配置: mqtt://127.0.0.1:1883
 
-说明：
-- core-mosquitto: HassOS官方MQTT插件的容器名
-- supervisor: HassOS Supervisor服务
-- 系统会自动尝试多个地址，无需担心配置错误
+说明：无需任何额外设置，直接填写即可
+- 系统会自动尝试 core-mosquitto、supervisor 等地址
+- 适用于HassOS内置的Mosquitto broker插件
 ```
 
-** Docker环境**
+**局域网环境（工控机/独立服务器）**
 ```yaml
-推荐配置: mqtt://host.docker.internal:1883
-备选地址: mqtt://172.17.0.1:1883 或 宿主机IP
-
-说明：
-- host.docker.internal: Docker Desktop的宿主机地址（Mac/Windows）
-- 172.17.0.1: Docker默认网桥网关（Linux）
-- 172.30.32.1: HassOS的网桥网关
-- 如果知道宿主机IP，直接使用IP地址更可靠
+配置: mqtt://192.168.1.100:1883
+
+说明：直接填写具体IP地址
+- 填写MQTT broker所在设备的局域网IP
+- 系统会直接连接，不启用fallback
+- 适合Linux工控机和独立部署的MQTT服务器
 ```
 
-**💻 本机环境（非容器）**
+**本机环境**
 ```yaml
-推荐配置: mqtt://localhost:1883 或 mqtt://127.0.0.1:1883
+配置: mqtt://localhost:1883 或 mqtt://127.0.0.1:1883
 
-说明：
-- 本机直接运行Node-RED时使用
-- Linux工控机部署推荐使用此配置
+说明：本机直接运行Node-RED时使用
+- 适合开发测试环境
+- 系统会自动尝试Docker环境的fallback地址
 ```
 
-** 配置错误也不用担心**
+**智能fallback机制**
 
-本节点实现了**智能fallback机制**：
-- 配置 `127.0.0.1` 后，系统会自动尝试 `core-mosquitto`、`supervisor`、`host.docker.internal` 等地址
-- 配置 `core-mosquitto` 后，系统会自动尝试 `localhost`、`127.0.0.1` 等地址
-- 所有候选地址会按顺序尝试连接，直到成功为止
-- **建议**：HassOS环境直接填 `127.0.0.1:1883`，系统会自动找到正确的地址
+- **局域网IP**（192.168.x.x, 10.x.x.x）：直接连接，不启用fallback
+- **localhost/127.0.0.1**：自动尝试 core-mosquitto、supervisor、host.docker.internal 等地址
+- **容器名**：自动尝试 localhost、127.0.0.1 等备用地址
 
 ## 安装
 

package/nodes/modbus-master.html

@@ -321,10 +321,11 @@
             </div>
             <div style="font-size: 11px; color: #555; padding: 8px 10px; background: linear-gradient(135deg, #e8f5e9 0%, #f1f8e9 100%); border-left: 4px solid #4caf50; border-radius: 4px; margin-top: 6px; box-shadow: 0 1px 3px rgba(0,0,0,0.08); line-height: 1.5;">
                 <strong style="color: #2e7d32;">💡 串口说明：</strong><br>
-                <span style="color: #555;">
+                <span style="color: #555; font-size: 11px;">
                 • <strong>Windows</strong>: COM1, COM2, COM3...<br>
                 • <strong>Linux</strong>: /dev/ttyUSB0, /dev/ttyS0, /dev/ttyAMA0<br>
-                • <strong>Docker</strong>: 需映射设备 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px;">--device=/dev/ttyUSB0</code> 或 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px;">--privileged</code>
+                • <strong>HassOS</strong>: 插件配置添加设备映射即可<br>
+                • <strong>Docker</strong>: 需映射设备 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px; font-size: 10px;">--device=/dev/ttyUSB0</code> 或 <code style="background: #c8e6c9; padding: 2px 6px; border-radius: 3px; font-size: 10px;">--privileged</code>
                 </span>
             </div>
         </div>
@@ -404,12 +405,12 @@
         <label for="node-input-mqttServer" style="width: 110px;"><i class="fa fa-server"></i> MQTT服务器</label>
         <input type="text" id="node-input-mqttServer" placeholder="选择或添加MQTT服务器配置" style="width: calc(70% - 110px);">
         <div style="font-size: 11px; color: #555; padding: 10px 12px; background: linear-gradient(135deg, #fff3cd 0%, #fff8e1 100%); border-left: 4px solid #ff9800; border-radius: 4px; margin-left: 110px; margin-top: 8px; box-shadow: 0 1px 3px rgba(0,0,0,0.08); line-height: 1.6;">
-            <strong style="color: #e65100;">🔧 环境配置说明：</strong><br>
-            <span style="color: #666;">
-            • <strong>HassOS环境</strong>：使用 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px;">core-mosquitto</code> 或 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px;">supervisor</code><br>
-            • <strong>Docker环境</strong>：使用 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px;">host.docker.internal</code> 或宿主机IP<br>
-            • <strong>本机环境</strong>：使用 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px;">localhost</code> 或 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px;">127.0.0.1</code><br>
-            • 系统会自动尝试多个地址fallback，无需担心配置错误
+            <strong style="color: #e65100; font-size: 11px;">🔧 MQTT配置说明：</strong><br>
+            <span style="color: #666; font-size: 11px;">
+            • <strong>HassOS</strong>：直接填 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px; font-size: 10px;">127.0.0.1:1883</code> 即可（无需任何额外设置）<br>
+            • <strong>局域网IP</strong>：直接填具体IP，如 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px; font-size: 10px;">192.168.1.100:1883</code><br>
+            • <strong>本机</strong>：填 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px; font-size: 10px;">localhost:1883</code> 或 <code style="background: #ffe0b2; padding: 2px 6px; border-radius: 3px; font-size: 10px;">127.0.0.1:1883</code><br>
+            • 支持智能fallback，配置错误也能自动尝试其他地址
             </span>
         </div>
     </div>

package/nodes/modbus-master.js

@@ -231,9 +231,18 @@ module.exports = function(RED) {
                 candidates.push(configuredBroker);
             }
             
-            // Fallback候选地址（适配不同环境）
+            // Fallback候选地址（仅在配置localhost或容器名时启用）
             const fallbackHosts = [];
             
+            // 判断是否是局域网IP地址（192.168.x.x, 10.x.x.x, 172.16-31.x.x）
+            const isLanIp = /^(192\.168\.|10\.|172\.(1[6-9]|2[0-9]|3[0-1])\.)/.test(host);
+            
+            // 如果是局域网IP，不启用fallback（用户明确指定了IP）
+            if (isLanIp) {
+                node.log(`检测到局域网IP配置，将直接连接到 ${configuredBroker}，不启用fallback`);
+                return candidates;
+            }
+            
             // 如果配置的是localhost或127.0.0.1，添加Docker/HassOS环境的fallback
             if (host === 'localhost' || host === '127.0.0.1') {
                 // HassOS/Supervisor环境（最优先）
@@ -246,8 +255,6 @@ module.exports = function(RED) {
                 fallbackHosts.push('172.17.0.1');             // Docker默认网关
                 fallbackHosts.push('homeassistant');          // HA容器名
                 fallbackHosts.push('mosquitto');              // Mosquitto容器名
-                // 尝试获取宿主机真实IP（局域网）
-                fallbackHosts.push('192.168.1.1');            // 常见路由器地址
             }
             
             // 如果配置的是容器名或Docker地址，添加本地地址fallback
@@ -300,6 +307,9 @@ module.exports = function(RED) {
             if (node.config.mqttUsername) {
                 options.username = node.config.mqttUsername;
                 options.password = node.config.mqttPassword;
+                node.log(`MQTT认证: 用户名=${node.config.mqttUsername}, 密码已设置=${!!node.config.mqttPassword}`);
+            } else {
+                node.warn('MQTT未配置认证信息，如果broker需要认证将会连接失败');
             }
             
             // 尝试连接函数
@@ -338,39 +348,62 @@ module.exports = function(RED) {
                     
                     node.mqttClient.on('error', (err) => {
                         // 连接失败，尝试下一个候选地址
+                        const errorMsg = err.message || err.code || '连接失败';
+                        node.warn(`MQTT连接错误: ${errorMsg} (broker: ${brokerUrl})`);
+                        
                         const now = Date.now();
                         const timeSinceLastAttempt = now - lastConnectAttempt;
                         
-                        // 避免频繁重试（至少等待2秒）
-                        if (timeSinceLastAttempt < 2000) {
+                        // 避免频繁重试（至少等待1秒），但仍要记录错误
+                        if (timeSinceLastAttempt < 1000) {
+                            setTimeout(() => {
+                                tryNextBroker();
+                            }, 1000);
                             return;
                         }
                         
-                        // 尝试下一个候选地址
-                        currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
-                        const nextBroker = brokerCandidates[currentCandidateIndex];
+                        tryNextBroker();
                         
-                        // 如果回到第一个地址，说明所有地址都试过了
-                        if (currentCandidateIndex === 0) {
-                            // 日志限流：MQTT错误最多每10分钟输出一次
-                            const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+                        function tryNextBroker() {
+                            // 尝试下一个候选地址
+                            currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
+                            const nextBroker = brokerCandidates[currentCandidateIndex];
                             
-                            if (shouldLog) {
-                                const errorMsg = err.message || '连接失败';
-                                node.error(`MQTT错误: ${errorMsg}`);
-                                node.error(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
-                                node.error('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
-                                node.error('提示：如果Node-RED运行在Docker容器中，可能需要使用host.docker.internal或容器IP [此错误将在10分钟后再次显示]');
-                                node.lastMqttErrorLog = now;
+                            // 如果回到第一个地址，说明所有地址都试过了
+                            if (currentCandidateIndex === 0) {
+                                // 判断是否是局域网IP配置（只有一个候选地址）
+                                const isSingleIpConfig = brokerCandidates.length === 1;
+                                
+                                if (isSingleIpConfig) {
+                                    // 局域网IP配置失败，立即输出错误（不受日志限流限制）
+                                    node.error(`MQTT连接失败: ${errorMsg}`);
+                                    node.error(`无法连接到MQTT broker: ${brokerCandidates[0]}`);
+                                    node.error('请检查：1) MQTT broker是否在该地址运行  2) 网络是否连通  3) 端口是否正确');
+                                    node.error('提示：可以使用命令测试: telnet 192.168.2.12 1883');
+                                } else {
+                                    // 多个fallback地址都失败，使用日志限流
+                                    const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+                                    
+                                    if (shouldLog) {
+                                        node.error(`MQTT错误: ${errorMsg}`);
+                                        node.error(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
+                                        node.error('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
+                                        node.error('提示：如果Node-RED运行在Docker容器中，可能需要使用host.docker.internal或容器IP [此错误将在10分钟后再次显示]');
+                                        node.lastMqttErrorLog = now;
+                                    }
+                                }
+                                
+                                // 5秒后重试第一个地址
+                                setTimeout(() => {
+                                    node.log('重试连接MQTT broker...');
+                                    tryConnect(brokerCandidates[0]);
+                                }, 5000);
+                            } else {
+                                node.log(`尝试备用MQTT broker: ${nextBroker}`);
+                                setTimeout(() => {
+                                    tryConnect(nextBroker);
+                                }, 500);  // 快速尝试下一个地址
                             }
-                            
-                            // 5秒后重试第一个地址
-                            setTimeout(() => {
-                                tryConnect(brokerCandidates[0]);
-                            }, 5000);
-                        } else {
-                            node.log(`尝试备用MQTT broker: ${nextBroker}`);
-                            tryConnect(nextBroker);
                         }
                     });
                     

package/nodes/modbus-slave-switch.js

@@ -129,12 +129,27 @@ module.exports = function(RED) {
                 candidates.push(configuredBroker);
             }
             
-            // Fallback候选地址（适配不同环境）
+            // Fallback候选地址（仅在配置localhost或容器名时启用）
             const fallbackHosts = [];
             
-            // 如果配置的是localhost或127.0.0.1，添加Docker环境的fallback
+            // 判断是否是局域网IP地址（192.168.x.x, 10.x.x.x, 172.16-31.x.x）
+            const isLanIp = /^(192\.168\.|10\.|172\.(1[6-9]|2[0-9]|3[0-1])\.)/.test(host);
+            
+            // 如果是局域网IP，不启用fallback（用户明确指定了IP）
+            if (isLanIp) {
+                node.log(`检测到局域网IP配置，将直接连接到 ${configuredBroker}，不启用fallback`);
+                return candidates;
+            }
+            
+            // 如果配置的是localhost或127.0.0.1，添加Docker/HassOS环境的fallback
             if (host === 'localhost' || host === '127.0.0.1') {
-                fallbackHosts.push('host.docker.internal');  // Docker Desktop (Mac/Windows)
+                // HassOS/Supervisor环境（最优先）
+                fallbackHosts.push('core-mosquitto');         // HassOS MQTT插件
+                fallbackHosts.push('supervisor');             // HassOS Supervisor
+                fallbackHosts.push('homeassistant.local');    // mDNS地址
+                // Docker环境
+                fallbackHosts.push('host.docker.internal');   // Docker Desktop (Mac/Windows)
+                fallbackHosts.push('172.30.32.1');            // HassOS网关
                 fallbackHosts.push('172.17.0.1');             // Docker默认网关
                 fallbackHosts.push('homeassistant');          // HA容器名
                 fallbackHosts.push('mosquitto');              // Mosquitto容器名
@@ -142,7 +157,8 @@ module.exports = function(RED) {
             
             // 如果配置的是容器名或Docker地址，添加本地地址fallback
             if (host === 'host.docker.internal' || host.startsWith('172.') || 
-                host === 'homeassistant' || host === 'mosquitto') {
+                host === 'homeassistant' || host === 'mosquitto' || host === 'supervisor' || 
+                host === 'core-mosquitto' || host.includes('.local')) {
                 fallbackHosts.push('localhost');
                 fallbackHosts.push('127.0.0.1');
             }
@@ -377,6 +393,9 @@ module.exports = function(RED) {
             if (node.config.mqttUsername) {
                 options.username = node.config.mqttUsername;
                 options.password = node.config.mqttPassword;
+                node.log(`MQTT认证: 用户名=${node.config.mqttUsername}, 密码已设置=${!!node.config.mqttPassword}`);
+            } else {
+                node.warn('MQTT未配置认证信息，如果broker需要认证将会连接失败');
             }
             
             // 尝试连接函数
@@ -416,39 +435,62 @@ module.exports = function(RED) {
                     
                     node.mqttClient.on('error', (err) => {
                         // 连接失败，尝试下一个候选地址
+                        const errorMsg = err.message || err.code || '连接失败';
+                        node.warn(`MQTT连接错误: ${errorMsg} (broker: ${brokerUrl})`);
+                        
                         const now = Date.now();
                         const timeSinceLastAttempt = now - lastConnectAttempt;
                         
-                        // 避免频繁重试（至少等待2秒）
-                        if (timeSinceLastAttempt < 2000) {
+                        // 避免频繁重试（至少等待1秒），但仍要记录错误
+                        if (timeSinceLastAttempt < 1000) {
+                            setTimeout(() => {
+                                tryNextBroker();
+                            }, 1000);
                             return;
                         }
                         
-                        // 尝试下一个候选地址
-                        currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
-                        const nextBroker = brokerCandidates[currentCandidateIndex];
+                        tryNextBroker();
                         
-                        // 如果回到第一个地址，说明所有地址都试过了
-                        if (currentCandidateIndex === 0) {
-                            // 日志限流：MQTT错误最多每10分钟输出一次
-                            const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+                        function tryNextBroker() {
+                            // 尝试下一个候选地址
+                            currentCandidateIndex = (currentCandidateIndex + 1) % brokerCandidates.length;
+                            const nextBroker = brokerCandidates[currentCandidateIndex];
                             
-                            if (shouldLog) {
-                                const errorMsg = err.message || '连接失败';
-                                node.error(`MQTT错误: ${errorMsg}`);
-                                node.error(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
-                                node.error('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
-                                node.error('提示：如果Node-RED运行在Docker容器中，可能需要使用host.docker.internal或容器IP [此错误将在10分钟后再次显示]');
-                                node.lastMqttErrorLog = now;
+                            // 如果回到第一个地址，说明所有地址都试过了
+                            if (currentCandidateIndex === 0) {
+                                // 判断是否是局域网IP配置（只有一个候选地址）
+                                const isSingleIpConfig = brokerCandidates.length === 1;
+                                
+                                if (isSingleIpConfig) {
+                                    // 局域网IP配置失败，立即输出错误（不受日志限流限制）
+                                    node.error(`MQTT连接失败: ${errorMsg}`);
+                                    node.error(`无法连接到MQTT broker: ${brokerCandidates[0]}`);
+                                    node.error('请检查：1) MQTT broker是否在该地址运行  2) 网络是否连通  3) 端口是否正确');
+                                    node.error('提示：可以使用命令测试: telnet 192.168.2.12 1883');
+                                } else {
+                                    // 多个fallback地址都失败，使用日志限流
+                                    const shouldLog = (now - node.lastMqttErrorLog) > node.errorLogInterval;
+                                    
+                                    if (shouldLog) {
+                                        node.error(`MQTT错误: ${errorMsg}`);
+                                        node.error(`所有MQTT broker候选地址都无法连接: ${brokerCandidates.join(', ')}`);
+                                        node.error('请检查：1) MQTT broker是否运行  2) 网络连接是否正常  3) broker地址是否正确');
+                                        node.error('提示：如果Node-RED运行在Docker容器中，可能需要使用host.docker.internal或容器IP [此错误将在10分钟后再次显示]');
+                                        node.lastMqttErrorLog = now;
+                                    }
+                                }
+                                
+                                // 5秒后重试第一个地址
+                                setTimeout(() => {
+                                    node.log('重试连接MQTT broker...');
+                                    tryConnect(brokerCandidates[0]);
+                                }, 5000);
+                            } else {
+                                node.log(`尝试备用MQTT broker: ${nextBroker}`);
+                                setTimeout(() => {
+                                    tryConnect(nextBroker);
+                                }, 500);  // 快速尝试下一个地址
                             }
-                            
-                            // 5秒后重试第一个地址
-                            setTimeout(() => {
-                                tryConnect(brokerCandidates[0]);
-                            }, 5000);
-                        } else {
-                            node.log(`尝试备用MQTT broker: ${nextBroker}`);
-                            tryConnect(nextBroker);
                         }
                         
                         node.updateStatus();

package/nodes/mqtt-server-config.html

@@ -59,8 +59,8 @@
     
     <div class="form-row" style="background: #e3f2fd; padding: 10px; border-left: 3px solid #2196f3; margin-top: 10px;">
         <div style="font-size: 12px; color: #333;">
-            <strong>💡 提示：</strong><br>
-            此配置将被所有主站和从站节点共享使用，确保MQTT连接信息一致。
+            <strong>提示：</strong><br>
+            此配置将被所有主站和从站节点共享使用，确保MQTT连接信息一致。如果MQTT broker需要认证，请填写用户名和密码。
         </div>
     </div>
 </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、智能MQTT连接（自动fallback HassOS/Docker环境）、Home Assistant自动发现和多品牌开关面板，生产级稳定版本",
   "main": "nodes/modbus-master.js",
   "scripts": {
@@ -50,4 +50,3 @@
   },
   "homepage": "https://github.com/symi-daguo/node-red-contrib-symi-modbus#readme"
 }
-