用途：面向 Eclipse Mosquitto MQTT 代理的管理与运维，覆盖安装、配置、认证、TLS、ACL、桥接、WebSocket 监听和故障排查。
主要能力：提供身份信息（服务单元 mosquitto.service、守护进程 mosquitto、配置 /etc/mosquitto/mosquitto.conf 与 conf.d/、日志 journalctl -u mosquitto 及 /var/log/mosquitto/mosquitto.log、用户 mosquitto）；安装命令 apt install mosquitto mosquitto-clients 或 dnf install mosquitto；常用操作如 systemctl status mosquitto、mosquitto_pub -h localhost -t test/topic -m "hello"、mosquitto_sub -h localhost -t test/topic -v、通配符订阅 '#' 与 'sensors/+/temperature'、查看 $SYS 指标、带认证与 TLS 的测试、桥接、日志排查、systemctl reload mosquitto 重载配置、mosquitto_passwd 创建与添加用户。
端口与健康检查：1883/tcp 明文、8883/tcp TLS、9001/tcp WebSocket，默认绑定 0.0.0.0；可用 ss -tlnp | grep mosquitto 验证，ufw 放行对应端口。健康检查包括 systemctl is-active mosquitto、回环发布订阅往返测试及日志错误检查。
常见故障：连接被拒、未授权、TLS 握手失败、无匹配订阅者、保留消息混淆、WebSocket 无法连接、协议版本不匹配、代理启动即退出，均给出可能原因与检查修复方向。
限制与注意：默认无加密，明文传输凭据与负载；旧版本默认允许匿名，2.0+ 默认无监听器，生产应设 allow_anonymous false 并配置 password_file；通配符 + 匹配单层、# 匹配多层且须在末尾；保留消息跨重启持久；QoS 0/1/2 在可靠性与性能间权衡；$SYS 主题不包含在 # 订阅中；ACL 变更需 reload 而非 restart。参考资料见 references/ 下的 mosquitto.conf.annotated 与 docs.md。