第4章 Mosquitto命令行工具快速上手

4.1 命令行工具概览

Mosquitto命令行工具
mosquitto_pub
mosquitto_sub
mosquitto
mosquitto_passwd
发布消息
订阅主题
启动Broker
管理密码文件

4.2 mosquitto_pub 详解

基本语法

mosquitto_pub
连接参数
消息参数
选项参数
主题和消息
-h 主机
-p 端口
-u 用户名
-P 密码
-t 主题
-m 消息
-f 文件
-l 从标准输入
-q QoS
-r 保留
-i ClientID

常用示例

bash 复制代码

# 最简单的发布
mosquitto_pub -t "test/hello" -m "Hello World"

# 指定QoS和保留消息
mosquitto_pub -t "sensor/temp" -m "25.5" -q 1 -r

# 从文件发布
mosquitto_pub -t "config/device" -f config.json

# 发布JSON数据
mosquitto_pub -t "sensor/data" -m '{"temp":25.5,"humidity":60.2}'

# 保留消息后清除
mosquitto_pub -t "status/device" -r -n

# 设置遗嘱消息
mosquitto_pub -t "data" -m "message" \
  --will-topic "status/offline" \
  --will-payload "gone" \
  --will-qos 1 \
  --will-retain

4.3 mosquitto_sub 详解

基本语法与示例

bash 复制代码

# 订阅单个主题
mosquitto_sub -t "sensor/temp"

# 订阅多个主题
mosquitto_sub -t "sensor/temp" -t "sensor/humidity"

# 使用通配符
mosquitto_sub -t "home/#"
mosquitto_sub -t "sensor/+/data"

# 显示主题名称(-v)
mosquitto_sub -v -t "sensor/#"

# 只接收一条消息(-C)
mosquitto_sub -C 1 -t "config/device"

# 持久会话
mosquitto_sub -id "myclient" -t "sensor/#" -q 1

# 保留连接
mosquitto_sub -t "sensor/#" -k 30

4.4 实战演练

场景1: 温度监控系统

监控终端 Mosquitto 传感器脚本监控终端 Mosquitto 传感器脚本 PUBLISH sensor/livingroom/temp "25.5" PUBLISH sensor/bedroom/temp "24.2" SUBSCRIBE sensor/+/temp sensor/livingroom/temp 25.5 sensor/bedroom/temp 24.2

脚本实现:

bash 复制代码

#!/bin/bash
# temperature_publisher.sh

while true; do
    TEMP=$(echo "scale=1; $RANDOM / 100 % 10 + 20" | bc)
    mosquitto_pub -t "sensor/livingroom/temperature" -m "$TEMP" -q 1
    echo "发布温度: $TEMP°C"
    sleep 5
done

bash 复制代码

# 订阅监控
mosquitto_sub -v -t "sensor/+/temperature"

场景2: 遥控器控制

bash 复制代码

# 控制终端
echo "打开客厅灯"
mosquitto_pub -t "home/livingroom/light" -m "ON" -q 1

echo "设置空调温度"
mosquitto_pub -t "home/livingroom/ac" -m '{"action":"set","temp":24}' -q 1

# 设备端订阅
mosquitto_sub -t "home/livingroom/#"

4.5 调试技巧

详细调试模式

bash 复制代码

# 使用-v参数查看详细信息
mosquitto_pub -v -t "test" -m "hello"

# 使用-d参数调试
mosquitto_sub -d -t "test/#"

连接问题排查

未运行
运行中
端口错误
端口正确
阻止
通过
需认证
无需认证
连接失败
检查服务
启动mosquitto
检查端口
使用正确-p端口
检查防火墙
开放防火墙
检查认证
提供-u用户名-P密码
检查网络

4.6 本章小结

掌握了mosquitto_pub和mosquitto_sub的使用方法,可以进行基本的MQTT消息通信测试和开发调试。