mosquitto

Mosquitto MQTT Broker

补充说明

Mosquitto 是轻量级 MQTT Broker，适合边缘设备、单机和中小规模 IoT 场景。配置文件通常位于 /etc/mosquitto/mosquitto.conf，默认端口 1883，TLS 8883。

常用示例

启动并前台调试：

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

创建密码文件：

mosquitto_passwd -c /etc/mosquitto/passwd app
mosquitto_passwd -b /etc/mosquitto/passwd sensor '***'

基础配置：

cat > /etc/mosquitto/mosquitto.conf <<'EOF'
listener 1883 0.0.0.0
allow_anonymous false
password_file /etc/mosquitto/passwd
acl_file /etc/mosquitto/acl
persistence true
persistence_location /var/lib/mosquitto/
log_dest file /var/log/mosquitto/mosquitto.log
EOF

ACL 示例：

cat > /etc/mosquitto/acl <<'EOF'
user app
topic readwrite sensors/#
user sensor
topic write sensors/room1/#
EOF

订阅与发布：

mosquitto_sub -h broker -u app -P '***' -t 'sensors/#' -v
mosquitto_pub -h broker -u sensor -P '***' -t 'sensors/room1/temp' -m '23.5' -q 1

TLS 监听：

listener 8883
cafile /etc/mosquitto/certs/ca.crt
certfile /etc/mosquitto/certs/server.crt
keyfile /etc/mosquitto/certs/server.key

易错点与排错

• allow_anonymous true 且公网暴露，任何人都能发布消息。
• 密码文件权限过宽，mosquitto 启动时拒绝加载。
• ACL 文件修改后没有重启或重载，规则未生效。
• 持久化目录权限不对，重启后会话和 retained 消息丢失。
• 客户端 ID 重复，后连接的客户端把前一个踢下线。
• QoS 2 并不等于业务只处理一次，消费端仍需幂等。
• 桥接配置的 topic 前缀写错，消息循环转发。
• 日志级别过低，认证失败时看不到原因。