直接用系统包管理器安装 mosquitto 足够满足90%物联网场景；默认仅监听127.0.0.1:1883，需改为0.0.0.0并配置密码认证以防未授权访问，同时注意主题斜杠仅为字符串分隔符而非路径。
直接用系统包管理器装 mosquitto 就够用了，除非你明确需要 WebSocket 支持、自定义 QoS 行为，或者必须用某个特定源码版本（比如 2.0.15 修复了某次心跳超时 bug）。别一上来就编译，90% 的物联网开发场景，apt install mosquitto mosquitto-clients 跑起来再调配置，比折腾源码快得多也稳得多。
Ubuntu/Debian 上用 apt 安装后为什么连不上 1883？
默认安装完 mosquitto，服务是启动了，但配置文件 /etc/mosquitto/mosquitto.conf 里 listener 默认只监听 127.0.0.1:1883 —— 这意味着只有本机程序能连，局域网其他设备（比如 ESP32、树莓派、手机 App）全被挡在外面。
改法很简单：
- 打开配置文件：
sudo nano /etc/mosquitto/mosquitto.conf - 找到这行：
listener 1883 127.0.0.1，把它改成：listener 1883 0.0.0.0 - 如果还打算让 Web 端通过 WebSocket 连（比如 MQTTX 或自建前端），顺手加一行：
listener 9001 0.0.0.0，再加一行：protocol websockets - 重启服务：
sudo systemctl restart mosquitto
改完立刻生效，不用重装。注意：开放 0.0.0.0 后，务必下一步配密码，否则等于把 MQTT 服务裸奔在公网或局域网里。
没设密码就启动 mosquitto，客户端能连但发不了消息？
不是发不了，是服务器默默拒绝了——默认配置下，allow_anonymous true 是开启的，但很多新版 Mosquitto（2.0+）在检测到未配置 password_file 且 allow_anonymous false 时，会直接拒绝所有 publish/subscribe 请求，日志里只显示 Client xxx disconnected due to malformed data 这类模糊错误，根本看不出是鉴权问题。
解决步骤：
- 生成密码文件：
sudo mosquitto_passwd -c /etc/mosquitto/passwd your_username（输两遍密码） - 编辑配置文件，在末尾追加两行：
allow_anonymous false和password_file /etc/mosquitto/passwd - 确认文件权限：
sudo chown mosquitto:mosquitto /etc/mosquitto/passwd（否则服务启动失败） - 重启：
sudo systemctl restart mosquitto
测试命令要带认证参数：mosquitto_sub -h 192.168.1.100 -p 1883 -t test -u your_username -P your_password
mosquitto_pub/sub 报错 “error while loading shared libraries: libmosquitto.so.1”
这是典型的动态库路径没刷进去，常见于源码编译安装后，或者某些精简版系统（如 Alpine、部分 Docker 镜像）缺 ldconfig 步骤。
先确认库文件在哪：
-
find /usr -name "libmosquitto.so*" 2>/dev/null（大概率在/usr/local/lib或/usr/lib/x86_64-linux-gnu） - 如果在
/usr/local/lib，执行：echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/mosquitto.conf && sudo ldconfig - 如果提示
libmosquitto.so.1找得到但版本不对（比如只有.so.2），说明客户端工具和服务器库版本不匹配，统一用包管理器装最省心：sudo apt install mosquitto-clients（它会自动拉对应版本的库）
这个错不会影响 mosquitto 服务本身运行，只卡在你本地调试用的 mosquitto_pub/sub 命令上——所以别急着重装整个 Broker，先查库路径。
真正容易被忽略的点是：MQTT 主题名里的斜杠 / 不是路径分隔符，而是纯字符串的一部分；sensor/room1/temperature 和 sensor/room1/humidity 是两个完全独立的主题，订阅 sensor/room1/+ 才能同时收两者。很多人配 ACL 时按文件路径思维写规则，结果权限永远对不上。
