树莓派新安装Raspbian后Node-RED无法连接本地MQTT Broker

我之前也折腾过类似的Pi Desktop家庭自动化配置，针对你遇到的Node-RED连不上本地MQTT Broker的问题，结合你的环境（raspbian-2017-07-05镜像 + 2018年3月的"The Script" + 只读ROM仅保留boot分区），给你梳理一套排查和修复步骤：

1. 先确认MQTT Broker（Mosquitto）是否正常运行 #

首先得排除Broker压根没启动的情况，执行命令看状态：

sudo systemctl status mosquitto

如果输出里显示active (running)，那Broker没问题；要是显示inactive或者failed，先启动它：

sudo systemctl start mosquitto

顺便设置开机自启，避免重启后又掉链子：

sudo systemctl enable mosquitto

2. 检查Node-RED的MQTT节点配置 #

打开Node-RED编辑器（默认是http://<你的树莓派IP>:1880），双击你的MQTT输入/输出节点：

• 确保服务器填的是localhost或者127.0.0.1（毕竟是本地Broker）
• 端口号默认是1883，没修改过的话别乱改
• 如果节点里勾选了使用用户名密码，得确认账号密码和Mosquitto配置里的完全一致——The Script大概率会开启认证，别在这里输错了

3. 核对Mosquitto的配置文件 #

"The Script"会自动修改Mosquitto的配置，咱们去看看/etc/mosquitto/mosquitto.conf：

cat /etc/mosquitto/mosquitto.conf

重点关注这几项：

• listener 1883：确保监听的是本地端口，要是有bind_address，要么设成127.0.0.1要么直接注释掉（避免限制IP）
• 如果有allow_anonymous false，那肯定得有password_file配置，而且Node-RED里的账号要在这个文件里存在
• 看看日志配置，比如log_dest file /var/log/mosquitto/mosquitto.log，可以实时看日志找错误：

tail -f /var/log/mosquitto/mosquitto.log

然后在Node-RED里触发连接，看日志里有没有拒绝连接、认证失败这类记录。

4. 用命令行测试本地MQTT连通性 #

直接用Mosquitto自带的工具测试，先开个终端发布消息：

mosquitto_pub -h localhost -t "test/topic" -m "hello from cli"

再开另一个终端订阅这个主题：

mosquitto_sub -h localhost -t "test/topic"

如果能收到消息，说明本地MQTT链路是通的，问题肯定在Node-RED的配置上；要是收不到，那还是Broker的问题，回到步骤1和3接着排查。

5. 查看Node-RED的日志找线索 #

Node-RED的日志会详细记录连接失败的原因，执行命令看日志：

node-red-log

或者看系统服务日志：

sudo journalctl -u nodered -f

常见的错误比如Connection refused（端口错了或者Broker没起来）、Unauthorized（账号密码不对），照着日志提示改就行。

6. 考虑镜像与脚本的版本兼容性 #

你用的是2017年的Raspbian镜像，搭配2018年的脚本，可能存在依赖版本不兼容的问题——比如2017年镜像里的Mosquitto版本比较旧，脚本里的新配置可能不兼容。可以尝试更新Mosquitto：

sudo apt-get update
sudo apt-get upgrade mosquitto

不过注意，你的系统是只读ROM（除了boot分区），更新前得先临时挂载为可写，更新完再改回只读模式，具体操作可以参考Pi Desktop的只读配置说明。

7. 检查防火墙/网络权限 #

虽然是本地连接，但偶尔防火墙规则也会搞事情，看看当前的iptables规则：

sudo iptables -L

如果有规则限制了1883端口，得允许本地访问：

sudo iptables -A INPUT -p tcp --dport 1883 -s 127.0.0.1 -j ACCEPT

我之前用类似配置时，遇到过一次是Mosquitto的密码文件生成错误，重新设置密码就解决了：

sudo mosquitto_passwd -c /etc/mosquitto/passwd <你的用户名>

设置完记得重启Mosquitto服务：

sudo systemctl restart mosquitto

内容的提问来源于stack exchange，提问作者Dion Weston