Skip to content

连接 MQTTX

本文将介绍以 MQTTX 作为 MQTT 客户端测试工具,接入 MQTT 云服务 - EMQX Cloud 部署。

MQTTXEMQ 开源的一款优雅的跨平台 MQTT 5.0 客户端工具,它支持 macOS、Linux 和 Windows,并且支持 MQTT 消息格式转换。

MQTTX 的用户界面借助聊天软件的形式简化了页面的操作逻辑,用户可以快速创建连接保存并同时建立多个连接客户端,方便用户快速测试 MQTT/TCPMQTT/TLS、和 MQTT/WebSocket连接/发布/订阅 功能及其他特性。

前置准备

  1. 安装 MQTTX 客户端工具。
  2. 已在 EMQX Cloud 创建部署,并且部署状态为运行中

在下载和安装前请访问我们的官网或者是 GitHub 来了解并获取到最新的版本信息,使用最新版本有助于提高使用体验。如果你对本项目了解也可以直接 Clone MQTTX 的仓库源码,自行打包和使用。使用过程中,有任何问题都可以到 GitHub issues 来发表问题和看法或者是 Fork 我们的项目,并向我们提交修改后的 PR,我们将会认真查阅和回复。

部署 MQTT 服务器

要将应用程序连接到 EMQX Cloud,您需要创建并配置一个部署。

Serverless 部署

  1. 在 EMQX Cloud 控制台中创建一个 Serverless 部署
  2. 部署创建并运行后,进入部署的概览 页面,获取 MQTT 连接信息,包括:
    • Broker 地址
    • 端口号(Serverless 部署仅支持 TLS 端口)
  3. Serverless 部署仅支持 TLS 连接。请务必从概览页面下载 CA 证书,并使用 8883 端口进行 TLS 连接。
  4. 在部署中通过访问控制 -> 客户端认证配置默认认证信息(用户名/密码)。

更多详情请参考:Serverless 连接指引

专有版或 BYOC 部署

  1. 您可以在 EMQX Cloud 控制台中创建一个专有版BYOC 部署。
  2. 创建完成后,进入部署的概览页面,获取 MQTT 连接信息,包括:
    • Broker 地址
    • MQTT 和 WebSocket 的 TCP 与 TLS 端口(支持 TCP 和 TLS 连接)
  3. 在部署中通过访问控制 -> 客户端认证 配置默认认证信息(用户名/密码)。

详细端口配置请参考:专有版 / BYOC 连接指引

连接配置

连接信息

部署概览页面可获取到连接地址和端口信息

认证信息

EMQX Cloud 所有部署均开启了用户认证,因此使用 MQTTX 进行测试连接时,需要填写用户名和密码字段

访问控制 > 客户端认证 中设置用户名和密码,可逐一添加,也可批量导入认证信息。

连接协议

  • 通过 MQTT 协议连接到部署

    MQTTX 使用 MQTT 协议

  • 通过 WebSocket 协议连接到部署

    MQTTX 使用 WS 协议

  • 通过 MQTT over TLS/SSL 协议连接到部署

    MQTTX 使用 MQTTS 协议

  • 通过 WebSocket over TLS/SSL 协议连接到部署

    MQTTX 使用 WSS 协议

名称和客户端 ID

名称是本次连接的一个标识,客户端 ID 已经被默认填写,可以点击右侧的刷新图标进行刷新。正确填写上述信息后,点击右上角的连接按钮即可连接到 EMQX Cloud 部署。

更多内容