Skip to content

连接 MQTTX ​

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

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

MQTTX 的用户界面借助聊天软件的形式简化了页面的操作逻辑,用户可以快速创建连接保存并同时建立多个连接客户端,方便用户快速测试 MQTT/TCP、MQTT/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 部署。

更多内容 ​