本文將以 [MQTT.fx](http://www.mqttfx.jensd.de/) 作為 [MQTT 客戶端](https://www.emqx.com/zh/blog/introduction-to-the-commonly-used-mqtt-client-library)測試工具，接入 [MQTT 雲服務 - EMQ X Cloud](https://www.emqx.com/zh/cloud)。透過本文，你將能快速瞭解 MQTT.fx 的基礎用法以及 MQTT 協議的基本概念與使用。

## MQTT.fx 簡介

[MQTT.fx](http://www.mqttfx.jensd.de/) 是目前最為流行的 MQTT 桌面客戶端工具，[MQTT.fx](http://www.mqttfx.jensd.de/) 1.0 Major 版本由 [Jens Deters](https://www.jensd.de/wordpress/) 使用[JavaFX](https://en.wikipedia.org/wiki/JavaFX) 技術開發，即為 Java 虛擬機器應用。遺憾的是 [MQTT.fx](http://www.mqttfx.jensd.de/) 目前已經停止維護，並轉為由 Softblade 公司資助開發另發行了其商業版本 [MQTT.fx® 5.0](https://softblade.de/en/mqtt-fx/)，採用收費許可證方式經營該軟體。本文中的 [MQTT.fx](http://www.mqttfx.jensd.de/) 不經特殊說明即特指 1.0 版本。

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

- 基本訂閱/推送/連線功能
- 使用者認證
- SSL/TLS連線支援
- [易用的訊息編輯欄](https://github.com/Jerady/mqttfx-payload-decoders)
- 支援代理

此外 [MQTT.fx](http://www.mqttfx.jensd.de/) 也有其他優秀特性:

- 軟體自由，其開源協議為 [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0)
- 支援跨平臺
- 支援 $SYS 主題訂閱管理 MQTT Broker
- 完整的日誌控制檯
- 支援 JavaScript 指令碼處理訊息
- 支援預定義模版

但同時也有缺陷：

- 不支援 [MQTT 5.0](https://www.emqx.com/zh/mqtt/mqtt5) 協議
- 一次只能建立一個連線，不方便多連線除錯
- 不支援 WebSocket 協議，無法除錯 MQTT over Webscoket 的情況

## EMQ X Cloud 簡介

[EMQ X Cloud](https://www.emqx.com/zh/cloud) 是由 [EMQ](https://www.emqx.com/zh) 公司推出的可連線海量物聯網裝置，整合各類資料庫及業務系統的全託管雲原生 MQTT 服務。作為**全球首個全託管的** [**MQTT 5.0**](https://www.emqx.com/zh/mqtt/mqtt5) **公有云服務**，EMQ X Cloud 提供了一站式運維代管、獨有隔離環境的 MQTT 訊息服務。

在萬物互聯的時代，EMQ X Cloud 可以幫助使用者快速構建面向物聯網領域的行業應用，輕鬆實現物聯網資料的採集、傳輸、計算和持久化。

本文將使用 EMQ X Cloud 提供的 [免費公共 MQTT 伺服器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker) 作為本次測試的 MQTT 伺服器地址，伺服器接入資訊如下：

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

更多詳情請訪問 [EMQ X Cloud 官網](https://www.emqx.com/zh/cloud)，或檢視 [EMQ X Cloud 文件](https://docs.emqx.cn/cloud/latest/)。

## MQTT.fx 使用

### 預覽

其主頁面如下圖所示，最上方為 MQTT Broker 連線位址列，及其連線配置。其下方功能 Tabs 含有 Publish 釋出欄、Subscribe 訂閱欄、Scripts 指令碼欄、Broker Status 狀態訊息欄、Log 日誌資訊控制欄。

![MQTT.fx 預覽](https://static.emqx.net/images/571a6128a2fd2d71de4c6892997194dd.png)

其中每一個 Tab 均支援拖拽成為單獨視窗，如下圖所示：

![MQTT.fx 獨立視窗](https://static.emqx.net/images/63fafd1866bf97e55a2d87a41cda901e.png)

### 連線

首先 MQTT client 與 Broker 通訊需要建立連線。點選連線位址列中輸入框右邊的配置圖示，進入具體的連線配置。

![MQTT.fx 連線按鈕](https://static.emqx.net/images/3203ab53b9ccd95a1fa777cf96a1822a.png)

選擇 Profile Type 為 MQTT Broker。Broker Address 填入 `broker-cn.emqx.io`，Broker Port 填入 `1883`，如下圖所示：

> broker-cn.emqx.io 為國內伺服器，broker.emqx.io 為國外伺服器，讀者可自行選擇一個進行連線。

![MQTT.fx 連線配置](https://static.emqx.net/images/987021efd99c587008e00061c5abaabf.png)

點選OK，確認配置，回到主介面，點選 Connect ，可見右邊的圓圈變為綠色，表示當前連線連通，如下圖所示：

![MQTT.fx 連線成功](https://static.emqx.net/images/61c7866eebc762e0fdb7dca8ca669611.png)

### 訂閱/傳送訊息

完成連線的建立之後，即可開始訂閱訊息。因為 MQTT 協議採用的是訂閱/推送的方式，所以我們需要在連線之後訂閱主題，之後主題上有訊息產生即可收到來自 EMQ X Cloud 推送。

![EMQ X Platform](https://static.emqx.net/images/7c3fd862db7bfdc16ef51bbcda0d5b2c.png)

點選進入 Subscribe Tab 下，在主題框中輸入 `/testTopic/1`，點選 Subscribe 訂閱按鈕，在左側出現訂閱的主題列表，訂閱的主題目前訊息數量為0，如下圖所示:

![MQTT.fx 主題訂閱](https://static.emqx.net/images/1e911b2c418c6f072dcb6969f8a95e4c.png)

之後，我們將把訊息推送到 Broker，回到 Publish 下，並且輸入主題 `/testTopic/1`，並在訊息輸入框中輸入"hello world"等訊息，如下圖所示：

![MQTT.fx 訊息釋出](https://static.emqx.net/images/fa9bd621a9dee67a07ad481924c2b93c.png)

點選 Publish 傳送，回到 Subscribe Tab，發現訂閱的主題`/testTopic/1`收到訊息，如下圖所示：

![MQTT.fx 訊息接收](https://static.emqx.net/images/43c8f23108d248f172a978e499b4d446.png)

我們使用 MQTT.fx 這一客戶端向 EMQ X Cloud 下的 `/testTopic/1` 主題傳送了訊息"hello wolrd"，訂閱了這個主題的所有客戶端都會收到這個訊息，包括剛剛訂閱了該主題的傳送客戶端。

### 指令碼

使用指令碼可以更加靈活地自定義訊息推送邏輯，點選 Script Tab，點選 Edit 對指令碼內容進行修改，修改為以下內容：

```jsx
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 指令碼](https://static.emqx.net/images/1504963bd1d751dd481cd995faaccc03.png)

### 日誌

在日誌內，我們可以檢視 MQTT.fx 與 EMQ X Cloud 互動過程，例如主題訂閱，訊息推送，訊息接收等：

![MQTT.fx 日誌](https://static.emqx.net/images/cc3b9ee768d37b6cce66316135db261c.png)

### 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](https://static.emqx.net/images/f8f23d25ea6fba54837bea19e1076081.png)

點選連線，可以看到右邊的鎖圖示是關閉的，表示啟用了 SSL，檢視日誌，發現 SSL 連線相關埠 8883 相關字樣，連線 SSL/TLS 成功。

![MQTT.fx 連線日誌](https://static.emqx.net/images/5ea2e8316df5c33d907b6d784309a025.png)

![MQTT.fx SSL/TLS 狀態](https://static.emqx.net/images/b3efb08a666b6c3dca2485b5fb5b403a.png)

以上就是使用 MQTT.fx 接入 EMQ X Cloud 的簡單示例，更多詳情可訪問 [EMQ X Cloud](https://www.emqx.com/zh/cloud)。

>版權宣告： 本文為  [EMQ]( https://www.emqx.io/cn/) 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/connecting-to-emqx-cloud-with-mqttfx](https://www.emqx.com/zh/blog/connecting-to-emqx-cloud-with-mqttfx)
>
>技術支援：如對本文或 EMQ 相關產品有疑問，可訪問 EMQ 問答社群 [https://askemq.com](https://askemq.com) 提問，我們將會及時回覆支援。

使用 MQTT.fx 接入 EMQ X Cloud

相關文章