如何查看MQTT服务器上有哪些客户端连接,有哪些命令?

查看MQTT服务器上有哪些客户端连接,最快的方式是通过Broker自带的监控主题或管理接口获取精确的客户端ID列表,其次是查看实时日志文件,不同Broker的命令略有差异,但原理一致。

先摸清你的Broker是哪种

MQTT服务器本身不提供统一的“在线列表”面板,但几乎每个Broker都预留了查看通道,行业内最常用的Broker无非三种:Mosquitto(开源轻量方案)、EMQX(高性能分布式方案)、qingcloud(轻量级嵌入式方案),先确认自己用的是哪一种,再对症下药。

mqtt 客户端,安卓版
加载中
mqtt 客户端,安卓版

怎么确认?看客户端连接时填的端口号就能猜个大概:1883是MQTT默认端口,8083或8084通常是WebSocket端口,18083往往是EMQX的Dashboard管理端口,如果你是在树莓派或者NAS上部署的智能家居网关,八成是Mosquitto;如果公司里跑着成千上万的设备连接,那大概率是EMQX。

Mosquitto:看主题、翻日志、查系统监控

Mosquitto是目前个人开发者和小型项目中最常见的Broker,它没有图形界面,但提供了足够多的信息渠道。

订阅$SYS开头的系统主题

Mosquitto从1.5版本开始,默认开启$SYS主题树,你只要用一个MQTT客户端订阅$SYS/#就能看到一堆Broker实时统计信息,具体操作如下:

mosquitto_sub -h 服务器IP -p 1883 -t ‘$SYS/#’ -v

然后会刷出一连串类似这样的内容:

  • $SYS/broker/clients/connected 当前已连接的客户端数量
  • $SYS/broker/clients/total 曾经连接过的客户端总数(含掉线的)
  • $SYS/broker/clients/disconnected 已断开但会话保持的客户端数量
  • $SYS/broker/clients/maximum 历史最大并发连接数
  • $SYS/broker/bytes/received Broker收到的总字节数

但这里有个坑:$SYS只给你数量和统计维度,不直接列出每个客户端的ID,如果你能接受只看数量,那这个方式最省事。

直接翻日志文件

要看到“有哪些客户端”这种具体清单,日志比$SYS更直观,在Linux上运行Mosquitto时,日志路径通常在/var/log/mosquitto/mosquitto.log,Windows上一般在C:mosquittomosquitto.log,用一条命令就能看到实时写入的连接记录:

tail -f /var/log/mosquitto/mosquitto.log

日志里会实时打印这样的行:

  • New client connected from 192.168.1.105 as device_001 (p2, c1, k60)
  • Client device_001 disconnected

    如何查看MQTT服务器上有哪些客户端连接,有哪些命令?

  • New client connected from 192.168.1.107 as sensor_temp_02 (p2, c1, k30)

通过跟踪New client connected from后面的IP和as后面的客户端ID,就能拼凑出到底有哪些设备连了上来,不过日志默认只记录“连接建立”和“连接断开”,不会保留一个持续的在线列表,你得自己通过监听日志变化来维护会话状态。

借助第三方工具做可视化

如果你不想手动翻日志,可以用MQTT Explorer这个开源桌面客户端,它连接Broker之后,左侧会有一个“Local”按钮,点开就能看到当前已连接的客户端列表,包含Client ID和IP地址,实际上它的原理也是订阅$SYS主题,但帮我们做了聚合展示。

EMQX:管理界面一打开,谁在线一目了然

如果你的MQTT服务器部署的是EMQX,那查看客户端连接就简单多了。

Dashboard图形界面

默认安装好EMQX之后,浏览器访问http://服务器IP:18083,账号密码默认为admin/public,登录后进入“客户端管理”页面,会看到一个表格,实时列出所有已连接的客户端,表头包含:

  • Client ID
  • 用户名
  • IP地址和端口
  • 协议版本(MQTT 3.1.1还是MQTT 5.0)
  • 连接状态(已连接/已断开)
  • 订阅的主题数量

在这个界面上还能直接踢掉异常连接,或者按Client ID搜索特定设备,非常实用,行业共识认为,EMQX在单节点支持百万级连接的情况下,Dashboard的响应速度依然能保持在毫秒级,这在同类开源产品中是比较突出的。

REST API拉取客户端清单

EMQX提供了完整的REST API,方便你写脚本或对接自建监控告警系统,查看在线客户端列表的接口是:

GET /api/v4/clients

返回的JSON里包含data数组,每一项就是一个客户端的详细信息,配合curl命令可以直接在服务器上测试:

curl -u admin:public http://127.0.0.1:8081/api/v4/clients

这样就能拿到当前所有连接到MQTT服务器上的客户端ID列表,并且可以按需解析出IP、用户名、连接时长等字段。

命令行工具emqx_ctl

对于不习惯图形界面的运维人员,EMQX自带的命令行工具也很方便,执行:

emqx ctl clients list

会以文本行格式输出所有在线客户端,配合grep、wc -l等Linux命令还能快速统计在线数量,如果只想看单个客户端的状态,比如设备device_123是否在线,可以执行:

emqx ctl client device_123
会显示这个客户端当前是否有会话、是否在线、从哪个IP连接、订阅了哪些主题。

如何查看MQTT服务器上有哪些客户端连接,有哪些命令?

qingcloud:轻量部署中的特殊查看方式

一些嵌入式设备或者智能网关里跑的是qingcloud这种轻量级Broker,它们的资源受限,通常不会提供HTTP API或web管理界面,查看客户端连接的方式往往依靠系统自带的订阅或发布工具。

qingcloud有个原生命令可以实时监控在线客户端状态:

qingcloud monitor

执行后会动态刷新当前所有连接,显示每个Client ID对应的IP地址和心跳间隔,这种方式适合开发阶段调试,但生产环境下使用较少。

另外有个小技巧:当客户端连接时,在qingcloud的启动终端(前台运行模式)会直接打印连接日志,但如果在后台运行,则日志重定向到了/var/log/mqtt.log,可以用tail -f查看。

这里需要提一个实际场景:不少开发者用docker容器来跑mosquitto时,容易漏看容器日志导致排查时一头雾水,如果你用的是docker方式部署,务必把日志挂载到宿主机上,否当容器被重建时历史连接记录就全部丢失了。

排查“mqtt客户端掉线频繁”的正确姿势

很多人搜“怎么查看mqtt服务器上有哪些客户端连接”,其实真正的问题背景是“既然连接断了,想确认设备到底有没有连上服务器”,这里有三个不同层面的排查路径:

看Broker侧统计实时连接数

  • 运行Mosquitto时订阅$SYS/broker/clients/connected,观察数值是否长期超过实际设备数,如果数值一直增长且高于设备总量,说明有连接未正确断开,多半是客户端没设置clean session(清理会话)标志位,导致MQTT服务器一直保存会话状态。
  • 用EMQX的Dashboard查看“连接数”和“会话数”两个指标,如果连接数远大于设备数,通常是设备侧反复重连导致的旧连接残留。

看网络层有没有VPC或防火墙拦截

得到IP地址后,在服务器上检查客户端IP是否可达:

ping 192.168.1.105

再用telnet检查1883端口通不通:

telnet 192.168.1.105 1883

如果网络层通了但MQTT连接还是不稳定,下一步就要看认证配置,确认是不是用户名密码或客户端证书校验不通过导致被踢下线。

看订阅关系维持的活跃度

在线不代表活跃。查看MQTT服务器上有哪些客户端连接只解决了“连没连上”的问题,要判断“是否健在”,还得看心跳包情况,大多数Broker默认的keepalive间隔是60秒,如果设备侧设置的心跳太短(比如5秒),在无线网络环境下很容易产生大量无效重连,导致Broker的连接列表像过山车一样起伏。

如何查看MQTT服务器上有哪些客户端连接,有哪些命令?

站在企业监控角度的进阶建议

如果管理的是几十台甚至上百台生产设备,光靠Shell命令临时查看属于应急手段,绝大多数MQTT服务器都支持Webhook或规则引擎,把连接事件转发到外部监控平台,比如EMQX可以配置“连接/断开事件”通过HTTP回调推送给企业微信或钉钉机器人,做到主动感知设备上下线,而不是被动地去服务器上查询。

对于需要长期记录分析的用户,推荐用简米云物联网平台或酷番云IoT平台中托管的MQTT实例,它们的控制台自带设备管理功能,直接以设备维度展示在线状态,不用自己折腾命令行,不过要留意一点,云厂商的MQTT实例通常按照连接数和消息数计费,查看实时连接数的入口一般在“设备管理”或“监控告警”菜单下。

查看MQTT服务器上有哪些客户端连接,本质上就是确认当前Broker的会话表里有哪些活跃条目,用$SYS主题看数量,用日志看明细,用管理API看结构化数据,三种方式任选其一都能达到目的,关键要记住的是:Broker看不到消息内容,但一定看得到每一个连接的来源IP和Client ID,这是MQTT协议中Broker天然具备的能力。

相关问答

Q:怎么查看mqtt服务器上有哪些客户端连接而不影响线上业务?
A:订阅$SYS或调用查询API均属于只读操作,不会对现有连接产生任何影响,但要注意mosquitto_sub -t '$SYS/#'会额外增加Broker的转发负载,连接数较大时建议过滤掉高频更新的字节统计主题,只订阅$SYS/broker/clients/connected这类低频指标。

Q:为什么我查看mqtt客户端连接列表时,发现一些Client ID重复出现?
A:同一个Client ID在同一时间只能维持一个有效连接,出现重复是因为旧的连接未完全释放,而新连接已建立,这通常由网络抖动导致ACK丢失触发,EMQX Dashboard中会显示“连接状态为旧连接”的条目,你可以手动踢掉旧连接释放资源。

Q:EMQX和Mosquitto查看客户端连接的方式能通用吗?
A:不能直接通用,Mosquitto没有内置REST API,只能通过$SYS主题或日志间接获取;EMQX则提供了完整的HTTP API和WebSocket API,如果要统一管理,建议通过MQTT协议订阅$SYS主题来实现跨Broker的连接数量统计。

首发原创文章,作者:王坚‌,如若转载,请注明出处:https://idctop.com/article/708276.html

赞 (0)
怎么进入戴尔服务器系统进行安装还原,操作步骤有哪些?
上一篇 2026年10月4日 17:54
成都定制服务器哪家性价比高,多少钱一台?
下一篇 2026年10月4日 17:55

相关推荐

  • 手机QQ邮箱怎么查看发送的邮件服务器,在哪里设置?

    手机QQ邮箱查看一封已发邮件的发件服务器,标准路径是:打开该邮件→点右上角“···”→选择“查看邮件原文”,在原文的Received、Message-ID、Return-Path这几行里读取服务器域名与IP;而想查自己账号的SMTP服务器地址,则要去“设置→账号→服务器设置”里看,两件事不是同一个入口,很多人搜……

    程序编程 2026年11月9日
    1300
  • 用U盘怎么安装服务器系统教程?,服务器系统U盘安装步骤是什么

    U盘安装服务器系统的底层逻辑与准备工作用U盘安装服务器系统的核心答案是:制作U盘启动盘、进入BIOS/UEFI把U盘设为第一启动项、加载RAID卡驱动、按向导完成安装,全程通常20-40分钟,相比光盘,U盘方案更适合没有光驱的现代服务器,镜像更新也方便,下面按实际操作顺序拆解,每一步都给出可照着做的路径和命令……

    程序编程 2026年11月7日
    500
  • HP DL380服务器如何做阵列?,RAID配置步骤有哪些?

    HP DL380阵列配置到底该从哪下手HP DL380做阵列的核心路径是开机通过Smart Array控制器自带的ORCA或SSA工具完成物理盘分组和RAID级别选择,对于G7到G9这些主流存量机型,离线方式按F8进ORCA最直接;对于G10以后的新机型,则推荐用Intelligent Provisioning……

    程序编程 2026年11月16日
    700
  • ASPRS近期关闭了吗?官方声明及最新动态揭秘!

    没有关闭,ASPRS(美国摄影测量与遥感协会)作为一个具有近90年历史的国际性专业学术组织,目前仍在持续运营并积极推动着地理空间科学的发展,它并未解散或停止活动,其官方网站、会员服务、专业期刊出版、年度会议以及各类认证项目都在正常进行,对于行业内人士、学生以及相关技术爱好者而言,ASPRS依然是获取前沿知识、进……

    2026年2月3日
    12700
  • 怎么在服务器上安装python第三方库

    在服务器上安装Python第三方库,最直接的方法是使用pip命令,但需要先确认服务器环境已正确配置,包括Python版本、pip可用性和网络权限,否则极易遇到安装失败或依赖冲突的问题,服务器上安装python库的步骤环境准备:检查Python和pip版本在服务器上动手安装前,先确认现有环境,这一步看似简单,但不……

    2026年8月21日
    2100
  • 香港EvoxtVPS测评,CN2 GIA实测体验,香港VPS推荐哪家?

    香港Evoxt VPS凭借CN2 GIA线路实现低延迟与高稳定性平衡,是2026年跨境业务与游戏加速的高性价比选择,但需注意其节点负载波动可能影响极致并发场景,网络性能深度解析:CN2 GIA的真实表现在2026年的跨境网络环境中,线路质量直接决定业务体验,Evoxt VPS主打的CN2 GIA(China N……

    2026年5月18日
    7000
  • AIoT路由器设备是什么?AIoT路由器怎么选购?

    在万物互联时代,网络连接已不再局限于简单的数据传输,而是向着智能化、场景化方向深度演进,核心结论在于:AIoT路由器设备已成为智能家居生态的中枢神经,它通过边缘计算与AI算法的深度融合,解决了传统路由器连接稳定性差、安全性低以及交互僵化的痛点,是实现全屋智能体验跃升的关键基础设施, 这类设备不仅仅是数据的通道……

    2026年3月20日
    11100
  • 数据库容器化部署的存储性能有哪些诉求?,怎么解决

    数据库容器化部署的存储性能诉求,不是简单把数据目录挂进容器,而是要让持久卷在低延迟、高IOPS、快照一致性、故障漂移上与物理机或虚拟机存储持平,否则生产库上容器就是自找麻烦,生产环境数据库容器化存储方案:为什么性能总不够用数据库上容器,最容易翻车的环节就是存储,应用层无状态,坏了可以随时重建;数据库有状态,每一……

    2026年9月11日
    500
  • 高防服务做防御升级前必须确认哪些事,有哪些注意事项?

    高防服务做防御升级前,必须先确认三件事:现有攻击画像和业务暴露面、防护带宽与清洗链路是否匹配、切换回滚与计费责任是否清楚, 这三项没对齐,升级往往只是把账单变大,防御效果未必同步提升,升级按钮点下去只要几秒,后面要背的锅可能跟几个月,下面按实操顺序拆开讲,方便你在控制台、合同和割接方案里逐项核对,高防服务升级前……

    程序编程 2026年11月10日
    600
  • 4g服务器为什么会突然停止响应,是什么原因导致的?

    4g服务器停止响应,绝大多数情况下是内存耗尽或CPU跑满,导致服务无法正常处理请求,只能靠重启或优化来“救火”, 所谓4g服务器,通常指内存为4GB的云服务器或物理机,这个配置在个人站长和小团队里非常常见,但它也最容易出现“突然连不上”的毛病,4g服务器停止响应是什么原因4g服务器停止响应,不是单一问题,而是多……

    2026年10月18日
    400

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注