使用 MQTT.fx 接入 EMQ X Cloud

本文将以 MQTT.fx 作为 MQTT 客户端测试工具，接入 MQTT 云服务 - EMQ X Cloud。通过本文，你将能快速了解 MQTT.fx 的基础用法以及 MQTT 协议的基本概念与使用。

MQTT.fx 简介

MQTT.fx 是目前最为流行的 MQTT 桌面客户端工具，MQTT.fx 1.0 Major 版本由 Jens Deters 使用JavaFX 技术开发，即为 Java 虚拟机应用。遗憾的是 MQTT.fx 目前已经停止维护，并转为由 Softblade 公司资助开发另发行了其商业版本 MQTT.fx® 5.0，采用收费许可证方式经营该软件。本文中的 MQTT.fx 不经特殊说明即特指 1.0 版本。

它包含主流的 MQTT 客户端功能：

基本订阅/推送/连接功能
用户认证
SSL/TLS连接支持
易用的消息编辑栏
支持代理

此外 MQTT.fx 也有其他优秀特性:

软件自由，其开源协议为 Apache 2.0 license
支持跨平台
支持 $SYS 主题订阅管理 MQTT Broker
完整的日志控制台
支持 JavaScript 脚本处理消息
支持预定义模版

但同时也有缺陷：

不支持 MQTT 5.0 协议
一次只能建立一个连接，不方便多连接调试
不支持 WebSocket 协议，无法调试 MQTT over Webscoket 的情况

EMQ X Cloud 简介

EMQ X Cloud 是由 EMQ 公司推出的可连接海量物联网设备，集成各类数据库及业务系统的全托管云原生 MQTT 服务。作为全球首个全托管的 MQTT 5.0 公有云服务，EMQ X Cloud 提供了一站式运维代管、独有隔离环境的 MQTT 消息服务。

在万物互联的时代，EMQ X Cloud 可以帮助用户快速构建面向物联网领域的行业应用，轻松实现物联网数据的采集、传输、计算和持久化。

本文将使用 EMQ X Cloud 提供的免费公共 MQTT 服务器作为本次测试的 MQTT 服务器地址，服务器接入信息如下：

Broker: broker-cn.emqx.io
TCP Port: 1883
SSL/TLS Port: 8883

更多详情请访问 EMQ X Cloud 官网，或查看 EMQ X Cloud 文档。

MQTT.fx 使用

预览

其主页面如下图所示，最上方为 MQTT Broker 连接地址栏，及其连接配置。其下方功能 Tabs 含有 Publish 发布栏、Subscribe 订阅栏、Scripts 脚本栏、Broker Status 状态消息栏、Log 日志信息控制栏。

MQTT.fx 预览

扫描二维码关注公众号，回复： 13319082 查看本文章

其中每一个 Tab 均支持拖拽成为单独窗口，如下图所示：

MQTT.fx 独立窗口

连接

首先 MQTT client 与 Broker 通讯需要建立连接。点击连接地址栏中输入框右边的配置图标，进入具体的连接配置。

MQTT.fx 连接按钮

选择 Profile Type 为 MQTT Broker。Broker Address 填入 broker-cn.emqx.io，Broker Port 填入 1883，如下图所示：

broker-cn.emqx.io 为国内服务器，broker.emqx.io 为国外服务器，读者可自行选择一个进行连接。

MQTT.fx 连接配置

点击OK，确认配置，回到主界面，点击 Connect ，可见右边的圆圈变为绿色，表示当前连接连通，如下图所示：

MQTT.fx 连接成功

订阅/发送消息

完成连接的建立之后，即可开始订阅消息。因为 MQTT 协议采用的是订阅/推送的方式，所以我们需要在连接之后订阅主题，之后主题上有消息产生即可收到来自 EMQ X Cloud 推送。

EMQ X Platform

点击进入 Subscribe Tab 下，在主题框中输入 /testTopic/1，点击 Subscribe 订阅按钮，在左侧出现订阅的主题列表，订阅的主题目前消息数量为0，如下图所示:

MQTT.fx 主题订阅

之后，我们将把消息推送到 Broker，回到 Publish 下，并且输入主题 /testTopic/1，并在消息输入框中输入"hello world"等消息，如下图所示：

MQTT.fx 消息发布

点击 Publish 发送，回到 Subscribe Tab，发现订阅的主题/testTopic/1收到消息，如下图所示：

MQTT.fx 消息接收

我们使用 MQTT.fx 这一客户端向 EMQ X Cloud 下的 /testTopic/1 主题发送了消息"hello wolrd"，订阅了这个主题的所有客户端都会收到这个消息，包括刚刚订阅了该主题的发送客户端。

脚本

使用脚本可以更加灵活地自定义消息推送逻辑，点击 Script Tab，点击 Edit 对脚本内容进行修改，修改为以下内容：

function execute(action) {
    mqttManager.publish("/testTopic/1", "hello world from script");
    return action;
}

其中 mqttManager 是 MQTT.fx 脚本功能开放的 API，主要有：

publish()，推送消息
subscribe()，订阅主题
unsubscribe()，取消主题订阅
output，输出消息到控制台

点击 Execute 执行，之后回到 Subscribe 下发现消息增加，其内容为 “hello world from script”。脚本发送功能正常，如下图所示：

MQTT.fx 脚本

日志

在日志内，我们可以查看 MQTT.fx 与 EMQ X Cloud 交互过程，例如主题订阅，消息推送，消息接收等：

MQTT.fx 日志

SSL/TLS连接

以 CA 自签名服务为例子，展示如何启用 SSL 协议连接到 EMQ X Cloud。

打开设置，和普通连接一样填写好 Broker Address 和 Broker Port（分别为 broker.emqx.io 和 8883），选择 SSL/TLS 项，选择 TLSv1.2 协议，勾选 CA signed server certficate，之后选择应用，如下图所示：

MQTT.fx SSL/TLS

点击连接，可以看到右边的锁图标是关闭的，表示启用了 SSL，查看日志，发现 SSL 连接相关端口 8883 相关字样，连接 SSL/TLS 成功。

MQTT.fx 连接日志

MQTT.fx SSL/TLS 状态

以上就是使用 MQTT.fx 接入 EMQ X Cloud 的简单示例，更多详情可访问 EMQ X Cloud。

版权声明：本文为 EMQ 原创，转载请注明出处。

原文链接：https://www.emqx.com/zh/blog/connecting-to-emqx-cloud-with-mqttfx

技术支持：如对本文或 EMQ 相关产品有疑问，可访问 EMQ 问答社区 https://askemq.com 提问，我们将会及时回复支持。