MQTTX官方版

MQTTX官方版是由EMQ开源的跨平台MQTT 5.0客户端工具，其核心功能涵盖MQTT/TCP、MQTT/TLS、MQTT/WebSocket协议的连接测试，支持创建多个同时在线的客户端，便于验证协议特性。MQTTX内置主题过滤器，支持通配符和正则表达式，可自定义颜色标记不同主题，并且消息收发界面直观，支持 Hex、Base64、JSON 和纯文本等多种格式解析。同时，MQTTX提供脚本编程、基准测试和物联网场景模拟功能，可模拟设备批量连接、压测等复杂场景。

另外，MQTTX全开源特性允许用户通过GitHub提交问题或贡献代码，社区驱动的迭代使其持续适配MQTT 5.0新特性，成为物联网开发中验证通信协议、调试服务连通性的高效工具，有需要的用户可以在本站免费下载使用。

功能特色

1、多协议与多客户端支持

全面兼容 MQTT 5.0/3.1.1 协议，支持 MQTT/TCP、MQTT/TLS 加密连接及 MQTT/WebSocket 通信方式。用户可同时创建多个独立客户端实例，模拟多设备并发场景，便于测试服务端负载与消息分发能力。

2、智能主题管理

内置主题过滤器，支持通配符（+/#）和正则表达式匹配，可快速筛选目标主题。用户可为不同主题自定义颜色标签，通过可视化区分提升调试效率，尤其适合复杂物联网系统的消息路由验证。

3、多格式消息解析

消息收发界面支持 Hex、Base64、JSON 和纯文本等多种格式的自动解析与格式化显示。用户可直接编辑或粘贴二进制数据，工具会自动转换为可读格式，降低数据解析门槛。

4、自动化测试与脚本扩展

提供脚本编程接口（如 JavaScript），支持自定义消息生成、定时发送和条件触发逻辑。结合内置的基准测试模块，可模拟设备批量上线、高频消息推送等场景，快速评估系统性能瓶颈。

5、跨平台与社区生态

覆盖 macOS、Linux、Windows 桌面端及 Web 浏览器，提供一致的交互体验。作为开源项目（GitHub），用户可参与功能开发或通过社区插件扩展功能，持续适配 MQTT 新特性（如会话延续、属性字段等）。

MQTTX官方版使用简介

一、准备 MQTT 服务器

1、公共的 MQTT 服务

如果您无需自行部署 MQTT 服务，您可以使用 EMQX 提供的在线公开版本进行快速测试：

Broker 地址: broker.emqx.io

Broker TCP 端口: 1883

Broker SSL 端口: 8883

2、全托管云原生 MQTT 消息服务

EMQX 提供全托管的云原生 MQTT 消息服务，能够通过可靠、实时的物联网数据传输、处理和集成，连接大量的物联网设备。您可以在几分钟内创建一个 MQTT 服务。

3、自行部署 MQTT 服务

如果您计划部署本地运行的 MQTT 服务，我们建议您下载并使用 EMQX。EMQX 是一款云原生分布式物联网 MQTT 消息服务器，能够高效可靠地连接大量物联网设备。

立即下载和安装 EMQX

以下是使用 Docker 快速安装 EMQX 的方式：

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx

二、快速建立连接

在设置好 MQTT Broker 后，打开主程序页面，点击左侧菜单栏的 + 按钮。如果页面为空，您也可以直接点击右侧的 新建连接 按钮来快速设定新的客户端连接。

1、客户端连接信息

在创建页面，需要设定或填写连接客户端的相关信息。

Broker 信息

Client ID、Host 和 Port 已经默认填写在 Broker 信息栏中，您可以根据实际的 Broker 信息自行修改。点击 Client ID 右侧的刷新按钮，可以迅速生成新的 Client ID。

选择框位于 Host 前面，用以选择该连接的协议，支持 mqtt://，ws://。如果使用 SSL/TLS 连接，需要修改为 mqtts://，wss://。

注意：当协议更改时，需要修改连接的端口。

用户认证信息

如果您的 Broker 开启了用户认证，您可以在配置项中填写 Username 和 Password 信息。

SSL/TLS

如果需要开启 SSL/TLS 认证，在配置中开启 SSL/TLS，并提供 CA signed server 或 Self signed 中的一种方式。

若选择 Self signed，需要进行证书配置。点击最右侧的文件夹按钮，选择您已经生成好的各项证书。若是单向连接，只需选择您的 CA File。若是双向认证，还需要选择配置 Client Certificate File 和 Client key file。开启 Strict validate Certificate 选项后，将启用更完整的证书验证连接。此选项建议在需要测试正式环境时启用。

2、关于使用 SSL 安全开关：

SSL 安全开关是您 MQTT 配置中的一个选项，用于确定是否在建立连接时验证服务端证书链和地址名称。当将该开关设置为关闭时，将不会进行验证，即允许连接到未经验证的服务器。

SSL 安全开关的使用场景：

开发环境：在开发环境中，为了方便测试和调试，可以关闭 SSL 安全开关，允许连接到未经验证的服务器。

内部网络：在受信任的内部网络环境中，如果没有外部访问风险，可以考虑关闭 SSL 安全开关，简化证书管理和验证过程。

需要注意的是，关闭 SSL 安全开关会降低连接的安全性。在生产环境或与外部网络通信时，建议打开 SSL 安全开关，确保通信的安全性和数据保护。

高级配置

在高级配置中，可以设置 连接超时时长、KeepAlive、Clean Session、自动重连、MQTT 版本 等。

MQTT 5.0

在高级配置中，您可以选择 MQTT 的协议版本，支持 MQTT v3.1.1 和 MQTT v5.0。默认版本为 v3.1.1。如果选择了 v5.0，还可以配置 Session Expiry Interval、Receive Maximum 和 Topic Alias Maximum（可选）。

遗嘱消息

在高级配置下方的配置卡片中，您可以配置遗嘱消息。Last-Will-QoS 和 Last-Will-Retain 的值默认为 0 和 False。当您输入 Last-Will-Topic 和 Last-Will-Payload 后，即可完成遗嘱消息的配置。完成配置后，点击右上角的 Connect 按钮就可以快速创建一个连接并连接至 MQTT Broker。

使用场景

1、设备调试

模拟传感器/执行器，测试与 MQTT Broker 的消息发布/订阅功能，快速验证通信逻辑。

2、协议测试

切换 MQTT 5.0/3.1.1 协议，检查服务端对不同版本或特性（如遗嘱消息、属性字段）的兼容性。

3、性能压测

批量创建虚拟客户端，模拟高并发连接或消息洪峰，评估 Broker 的负载能力和稳定性。

4、路由验证

通过通配符订阅测试主题路由规则，确认消息是否按预期转发至目标服务（如数据库、队列）。

5、教学演示

直观展示 MQTT 发布-订阅模型，适合物联网教学或快速搭建原型验证业务逻辑。

6、运维监控

临时订阅关键主题（如设备心跳），实时监控消息流，辅助排查连接异常或消息堆积问题。

更新日志

v1.13.0版本

有效载荷检查器和用户界面刷新更新

此版本引入了功能强大的有效负载检查器，具有差异比较和 JSON 树视图，更新了桌面和 Web 的用户界面，增强了复制功能，并修复了社区报告的主题订阅问题。

特色

桌面端、网页端：

添加主题、代理和主机信息的快速复制选项。

添加主题空格检测设置，以警告是否存在前导/尾随空格。

桌面：

添加有效载荷检查器，并带有差异视图，用于比较消息之间的有效载荷变化。

添加 JSON 树状视图，用于结构化有效载荷的可视化和导航。

添加可配置的最大有效载荷显示大小设置。

网址：

为 JSON 有效负载显示添加语法高亮显示。

桌面、命令行界面：

将 protobufjs 升级以支持 Protobuf Editions 2023。

改进

桌面端、网页端：

采用现代化的样式、更流畅的动画和更好的视觉一致性来刷新用户界面。

简化连接列表所选状态的样式。

使用现代布局重新设计“关于 MQTT 的一切”帮助页面。

采用现代布局重新设计“关于我们”页面，并推广 EMQX 平台。

桌面：

将 Electron 从 33.4.11 升级到 39.2.7，以获得更好的性能和安全性。

添加 Windows 便携版本（无需安装）。

提高跨平台兼容性并修复脚本依赖关系。

修复

桌面：

通过升级 Electron 修复 macOS 26 Tahoe 的性能问题。

修复编辑禁用主题时状态不一致的问题（ #2007 ）。

修复 Enter 键在主题输入中插入换行符导致订阅错误（ #2001 ）。

配置属性后，修复 Meta 按钮红点位置问题。

修复主题空格检测问题。

网址：

修复发布区域主题输入强制换行的问题。

修复主题输入和选择样式问题。

桌面端、网页端：

禁止在主题和别名 textarea 输入中出现换行符。