【第一章03】MQTTX 下载安装，发布订阅说明

1MQTTX简介MQTTX是EMQ开源的一款跨平台MQTT 5.0客户端工具箱作为EMQX的官方配套客户端可高效完成MQTT连接测试、消息调试、性能压测等工作是物联网开发中验证EMQX通信的核心工具。你可以通过MQTTX官网获取最新版本与完整功能说明。一、产品形态MQTTX Desktop桌面端‌提供图形化操作界面支持Windows、macOS、Linux全平台安装。支持多连接灵活管理、自定义分组、多窗口独立查看不同连接状态。‌MQTTX CLI命令行工具‌无图形化依赖可在服务器环境直接运行支持本地保存连接配置。内置性能压测能力可快速模拟大量客户端连接测试EMQX服务性能。‌MQTTX Web网页版‌无需安装直接通过浏览器访问使用支持私有环境部署。仅支持WebSocket协议连接可快速完成EMQX基础连通性验证。二、核心功能类聊天式发布订阅界面‌操作逻辑简洁直观支持不同订阅主题自定义颜色区分消息日志可读性强。‌多格式消息支持‌可自由选择Hex、Base64、JSON、纯文本等消息载荷格式适配不同调试场景。‌数据模拟能力‌内置特斯拉设备、智能家居等预设场景脚本也支持自定义脚本模拟真实物联网数据。‌AI辅助能力‌集成MQTTX Copilot可智能提供MQTT与EMQX相关问题解答、错误分析提升开发调试效率。三、连接EMQX基础步骤启动MQTTX后点击「New Connection」新建连接。填写EMQX服务地址、对应端口TCP默认1883、TLS默认8883、WebSocket默认8083。配置EMQX后台设置的客户端认证用户名与密码点击连接即可完成接入。2MQTTX Desktop桌面端‌下载安装使用A下载MQTTX APPMQTTX下载地址操作说明访问 MQTTX 官网下载页面https://mqttx.app/downloads根据您的操作系统Windows、macOS 或 Linux选择对应的安装包。Windows 用户下载.exe安装程序macOS 用户下载.dmg文件Linux 用户根据发行版选择.deb、.rpm或 AppImage 格式。下载完成后双击安装文件按照提示完成安装。B打开MQTTX 桌面版客户端安装完成之后打开操作说明安装完成后在桌面或开始菜单中找到 MQTTX 图标并双击打开。首次启动时您会看到简洁的主界面左侧是连接列表区域右侧是消息收发区域。界面支持中文/英文切换可根据需要调整语言设置。CMQTTX新建链接操作说明1. 点击左上角的「 New Connection」按钮2. 在弹出的连接配置窗口中填写以下信息Name连接名称可自定义如本地EMQX测试Client ID客户端ID可保持默认或自定义建议使用有意义的名称HostEMQX服务器地址本地测试用127.0.0.1或localhost远程服务器填写实际IP或域名Port端口号TCP默认1883TLS默认8883WebSocket默认8083Username/Password如果EMQX启用了认证填写对应的用户名密码Protocol选择 MQTT 协议版本默认 MQTT 3.1.1也支持 MQTT 5.0点击右上角的「Connect」按钮建立连接连接成功后状态指示灯会变为绿色D查看仪表盘链接建立成功我们就可以看到我们的仪表盘有一个链接操作说明连接成功后左侧连接列表中的连接状态会变为绿色在线状态同时会显示连接时间。点击连接名称右侧会显示该连接的详细信息面板包括连接参数、实时消息收发界面和订阅管理区域。E新建一个消息接收操作说明在已建立的连接界面中找到「New Subscription」区域准备创建消息订阅。F订阅一个topic这个主题你自定义操作说明在「Topic」输入框中填写要订阅的主题名称如test/topic点击「Confirm」按钮确认订阅订阅成功后该主题会出现在下方的订阅列表中当有消息发布到该主题时消息会自动显示在消息区域GEMQX客户端仪表盘上可以看到订阅管理操作说明在EMQX管理控制台的「客户端」或「订阅」页面可以查看当前所有活跃的客户端及其订阅的主题。这有助于验证MQTTX客户端是否成功连接到EMQX并正确订阅了主题。Hpub发布消息操作说明在消息发送区域填写以下信息Topic要发布消息的主题如test/topicPayload消息内容支持文本、JSON、Hex等多种格式QoS服务质量等级0、1、2根据需求选择点击「Send」按钮发布消息Isub已经获取到了pub发布的消息操作说明消息发布后订阅了相同主题的客户端会立即收到该消息。在MQTTX的消息接收区域您可以看到刚刚发布的消息内容、时间戳和QoS等信息验证了发布/订阅功能的正常工作。3MQTTX CLI命令行工具‌使用A下载https://mqttx.app/downloads操作说明从MQTTX官网下载CLI版本根据您的操作系统选择对应的可执行文件。Windows用户下载.exe文件Linux/macOS用户下载对应的二进制文件。B建立订阅主题B进入到这个mqttx-cli-win-x64.exe所在的目录建立订阅主题B操作说明打开命令行终端Windows用CMD或PowerShellLinux/macOS用Terminal使用cd命令切换到mqttx-cli-win-x64.exe所在的目录执行订阅命令.\mqttx-cli-win-x64.exe sub -t B -h localhost -p 1883 -vsub表示订阅操作-t B指定订阅的主题为B-h localhost指定MQTT服务器地址-p 1883指定端口号-v详细输出模式使用localhost报错.\mqttx-cli-win-x64.exe sub-tB-hlocalhost-p1883-v原因分析‌MQTT Broker服务未启动‌这是该报错最常见的诱因本地的MQTT服务比如EMQX、Mosquitto没有正常运行1883端口没有进程在监听直接导致连接请求被拒绝。你可以先检查对应服务的运行状态启动MQTT Broker后再重试连接。‌地址解析不匹配‌Windows系统中localhost默认会优先解析为IPv6地址::1但多数MQTT Broker默认仅绑定IPv4的127.0.0.1地址无法响应IPv6的连接请求。你可以直接将命令中的-h localhost修改为-h 127.0.0.1强制使用IPv4地址连接即可解决该问题。‌端口监听配置异常‌确认你的MQTT Broker配置文件中已正确设置监听1883端口且绑定地址为0.0.0.0允许所有地址访问而非仅绑定了特定的外部网卡地址避免本地环回地址无法访问该端口。‌防火墙拦截‌检查Windows系统防火墙或第三方安全软件确认没有拦截1883端口的本地TCP连接请求临时关闭防火墙测试即可快速验证是否是该因素导致的故障。这里就是地址解析不匹配‌调整之后成功C建立发布主题操作说明打开另一个命令行窗口保持订阅窗口运行同样切换到mqttx-cli-win-x64.exe所在目录执行发布命令.\mqttx-cli-win-x64.exe pub -t B -q 0 -h 127.0.0.1 -p 1883 -m from MQTT CLIpub表示发布操作-t B指定发布到的主题为B-h 127.0.0.1使用IPv4地址避免解析问题-p 1883端口号-m from MQTT CLI要发布的消息内容在订阅窗口中会立即看到接收到的消息4MQTTX WEB使用操作说明访问 MQTTX Web 版地址通常为https://mqttx.app/web或私有部署地址界面与桌面版类似点击「New Connection」创建连接配置连接参数时注意协议选择WebSocketWeb版仅支持WebSocket端口使用8083WebSocket默认端口其他参数与桌面版相同连接成功后操作流程与桌面版完全一致到了这里就和我们的MQTTX Desktop使用一样了这里就不多讲了有兴趣可以在试试