MQTTX

MQTTX官方版是EMQ开源的一款跨平台MQTT 5.0客户端工具，功能强大且全面。它支持MQTT/TCP、MQTT/TLS、MQTT/WebSocket协议的连接测试，允许用户创建多个同时在线的客户端，方便验证协议特性。

MQTTX内置主题过滤器，支持通配符与正则表达式，能自定义颜色标记不同主题，消息收发界面直观，可对Hex、Base64、JSON和纯文本等多种格式进行解析。此外，它还具备脚本编程、基准测试和物联网场景模拟功能，可模拟设备批量连接、压测等复杂场景。

其全开源特性让用户能通过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消息服务器，能高效可靠地连接大量物联网设备。

使用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安全开关，确保通信的安全性和数据保护。

3. 高级配置

在高级配置中，可设置连接超时时长、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版本

特色

1. 桌面端、网页端

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

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

2. 桌面

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

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

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

3. 网址

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

4. 桌面、命令行界面

- 将protobufjs升级以支持Protobuf Editions 2023。

改进

1. 桌面端、网页端

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

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

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

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

2. 桌面

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

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

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

修复

1. 桌面

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

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

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

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

- 修复主题空格检测问题。

2. 网址

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

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

3. 桌面端、网页端

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