单片机与物联网 / 系统课时

启动本地 Broker 并验证端口

启动本地 Broker 并验证端口

在开发机上搭建 MQTT 联调环境,首先要确认 Broker 进程已启动、TCP 1883 端口确实监听,并且客户端能够完成真实的发布订阅。本篇以使用 systemd 的 Ubuntu 和 Eclipse Mosquitto 为例,完成安装、连通性验收与常见故障定位。

学习目标

  • 安装并启动 Mosquitto Broker 与命令行客户端。
  • 区分服务运行、端口监听和 MQTT 消息收发三种验证结果。
  • 根据连接被拒绝、超时或授权失败定位问题。

安装并启动本地服务

准备一台可以使用 sudo、apt-get 和 systemctl 的 Ubuntu 开发机,打开终端执行以下命令。mosquitto 是 Broker,mosquitto-clients 提供发布和订阅测试工具。

bash
sudo apt-get update
sudo apt-get install -y mosquitto mosquitto-clients
# 启动服务,同时设置开机启动
sudo systemctl enable --now mosquitto
systemctl is-active mosquitto

预期输出(以最后一条命令为准,安装过程另有日志):

text
active

enable --now 同时完成开机自启设置与本次启动。active 只能证明 systemd 认为服务正在运行,并不能证明网络监听或 MQTT 鉴权正确。如果返回 inactive 或 failed,先排查服务启动,不要直接进入发布订阅测试。

确认 TCP 1883 正在监听

MQTT 基于 TCP 的常用明文端口是 1883。用 ss 查看实际监听地址,避免仅凭进程存在就判断网络可达。下面的命令只显示监听状态与本地地址,减少队列长度、进程标识等动态字段干扰。

bash
# 隐藏列标题,只显示 TCP 监听状态与本地地址
ss -H -lnt '( sport = :1883 )' | awk '{print $1, $4}'

预期输出示例(可能另有 IPv6 的 [::1]:1883 行):

text
LISTEN 127.0.0.1:1883

在没有显式配置 listener 的 Mosquitto 2.x 默认模式下,服务只绑定本机回环地址 127.0.0.1 和/或 ::1,适合本机测试。此时其他机器不能通过开发机的局域网 IP 访问它。

若没有任何监听行,检查服务是否启动、端口是否被占用以及实际加载的配置。如果看到 0.0.0.0:1883,表示该端口监听所有 IPv4 网络接口,应确认这是有意配置且访问控制已经就绪。监听成功也不等于客户端已经完成 MQTT 连接。

用两个终端验证消息收发

先在终端 A 启动订阅,保持它等待消息。-h 指定 Broker 地址,-p 指定端口,-t 指定主题。-v 打印主题及载荷,-C 1 在收到一条消息后退出,-W 60 表示连接建立后最多等待 60 秒。

bash
# 先订阅,避免错过未设置 Retain 的消息
mosquitto_sub -h 127.0.0.1 -p 1883 -t lab/temperature -v -C 1 -W 60

预期输出(在终端 B 发布消息之后):

text
lab/temperature 26.4

在 60 秒内打开终端 B 执行发布。-t 指定 Topic,-m 指定载荷;成功时 mosquitto_pub 默认不打印正文,所以用 printf 显示发布命令成功结束。

bash
# 与订阅端使用完全相同的主题
mosquitto_pub -h 127.0.0.1 -p 1883 -t lab/temperature -m '26.4' && printf 'publish ok\n'

预期输出(终端 B):

text
publish ok

终端 A 能出现 lab/temperature 26.4,才表示本机客户端连接、订阅注册、发布和 Broker 转发这条链路都已验证。publish ok 只确认发布客户端成功完成此次发布操作,不能单独证明订阅者收到了消息。

如果终端 A 到时退出且没有收到消息,先确认它是否早于发布启动,以及双方主题是否完全一致。由于示例未设置 Retain,先发布后订阅不能保证收到先前消息。

按症状缩小故障范围

遇到连接问题时,不要反复重装 Broker。先分清故障处于服务层、TCP 网络层,还是 MQTT 认证与订阅层。

  • Connection refused: 优先查看 systemctl is-active mosquitto 和 ss 的监听结果。常见原因是服务未启动、端口不符,或客户端连接了错误的地址。
  • 端口被占用: 已由 systemd 启动 Broker 时,不要再手工运行第二个 mosquitto 实例抢占 1883;应先确认已有进程及服务配置。
  • Not authorised: 说明 TCP 连接可能已建立,但 MQTT 认证或 ACL 不允许操作。显式配置监听器后,不应假设匿名客户端仍可访问。
  • 其他机器连不上: 首先检查监听地址是否仅为 127.0.0.1 或 ::1;还需检查主机防火墙和网络路径,而不只是 Broker 进程。
  • 发布成功却没有消息: 检查订阅是否已生效、Topic 大小写和层级是否一致,以及订阅端是否已超时退出。

如果服务启动失败,可以通过 systemctl status mosquitto --no-pager 查看服务状态,并用 sudo journalctl -u mosquitto -n 30 --no-pager 查看最近的服务日志。实际日志时间和进程 ID 因机器而异,重点寻找配置解析错误、端口占用或文件权限问题。

需要跨设备联调时,再参照 Mosquitto 官方监听与认证说明 调整配置。验收顺序始终是先确认服务,再确认监听地址和端口,最后通过真正的 MQTT 发布订阅判断链路是否畅通。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

启动本地 Broker 并验证端口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通