树莓派上Mosquitto仅运行在本地模式，无法跨设备访问求助

针对你遇到的Mosquitto仅本地模式启动、修改配置后仍无法局域网访问的问题，可从以下几个方向逐一排查：

1. 确认配置文件是否被正确加载 #

Mosquitto可能未自动加载你修改的/etc/mosquitto/mosquitto.conf，而是使用了默认的本地模式配置。需强制指定配置文件启动：

sudo mosquitto -c /etc/mosquitto/mosquitto.conf

启动后查看日志文件/var/log/mosquitto/mosquitto.log，确认是否存在Loaded config file /etc/mosquitto/mosquitto.conf的提示，若无则说明配置文件未被正确加载。

2. 检查Listener绑定的地址 #

配置中listener 1883默认绑定所有网络接口，但如果/etc/mosquitto/conf.d/目录下的其他配置文件存在bind_address 127.0.0.1，会覆盖当前设置。

• 排查conf.d目录下所有文件，删除或注释强制绑定本地地址的配置
• 可显式指定绑定所有接口，修改listener配置为：

  listener 1883 0.0.0.0
  

3. 验证防火墙/端口是否开放 #

局域网设备无法连接，大概率是1883端口被防火墙拦截：

• Ubuntu/Debian系统开放端口：

  sudo ufw allow 1883/tcp
  sudo ufw reload
  

• CentOS/RHEL系统开放端口：

  sudo firewall-cmd --add-port=1883/tcp --permanent
  sudo firewall-cmd --reload
  

• 用其他设备测试端口可达性：执行nc -zv <服务器IP> 1883，显示成功连接则端口正常。

4. 检查持久化目录的权限 #

配置中persistence_location mosquitto/data路径可能不存在或权限不足，导致Mosquitto启动失败并 fallback到默认本地模式：

• 创建目录并设置权限：

  sudo mkdir -p /etc/mosquitto/data
  sudo chown mosquitto:mosquitto /etc/mosquitto/data
  

• 或直接使用默认持久化路径：

  persistence_location /var/lib/mosquitto/
  

5. 排查配置文件语法错误 #

Mosquitto对配置语法要求严格，拼写错误或格式问题会导致配置失效。用以下命令检查配置：

mosquitto -c /etc/mosquitto/mosquitto.conf -v

启动时会输出详细加载日志，重点关注Error开头的提示信息。

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