本文將以 [MQTTBox](https://github.com/workswithweb/MQTTBox) 作為 [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)。透過本文，你將能快速瞭解 MQTTBox 的基礎用法以及 MQTT 協議的基本概念與使用。

## MQTTBox 簡介

[MQTTBox](https://github.com/workswithweb/MQTTBox) 是 Sathya Vikram 個人開發的 MQTT 客戶端工具，最初僅在 Chrome 上作為擴充安裝使用， 後經重寫開源成為桌面端跨平臺軟體。介面簡單直接，支援多個客戶端同時線上，但客戶端之間的切換、互發訊息等互動還是有一些不便。MQTTBox 藉助 Chrome 實現強大的跨平臺特性，結合簡單的負載測試功能，是一款值得嘗試的 MQTT 客戶端工具。

MQTTBox 完整的支援了以下功能：

- 透過支援 Chrome OS，Linux，macOS，Windows 的 Chrome 儲存易於安裝，支援 Linux、macOS、Windows 獨立安裝
- 支援 MQTT、MQTT over WebSocket，多種 TCP 加密方式的連線
- 儲存傳送的訊息歷史記錄
- 複製/貼上歷史記錄中的訊息
- 儲存訂閱訊息歷史記錄
- 簡單的效能測試，對 Broker 的負載做出測試並透過圖表視覺化檢視測試結果

## 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/)。

## MQTTBox 使用

### MQTT 連線

#### 初始化頁面

開啟軟體後，進入到軟體主介面，點選頂部選單欄的 `Create MQTT Clinet` 按鈕，進入到建立 MQTT 客戶端頁。

![MQTTBox 介面](https://img-blog.csdnimg.cn/img_convert/528e93d0fa6bf9a4f04fa0318e91aad0.png)

#### 建立連線

進入到建立 MQTT 客戶端頁面後，填寫 Host、選擇連線協議等 MQTT 相關配置資訊後，點選底部的 `Save` 按鈕即可立即建立一個連線客戶端。

> 注意：填寫 Host 時，需填入完整的地址，包含連線的埠號。如果是 WebSocket 連線，還需加上 Path。如果 MQTT Broker 開啟使用者名稱/密碼認證的，還需要在配置頁面內輸入 Username / Password

![MQTTBox 建立連線](https://img-blog.csdnimg.cn/img_convert/623d3379ec1e0b0d40f409eaa43c41e6.png)

此時儲存成功後，會進入到一個客戶端詳情頁面，如果右上角的按鈕顯示 `Connected` 並且為綠色，即表示該 MQTT 客戶端已經成功連線，再次點選後可以斷開客戶端連線。

### 訂閱主題

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

在 MQTTBox 的客戶端詳情頁面中預設有兩個傳送和訂閱的輸入框。如果有多個訂閱或者不同的釋出內容，可以新增多個，點選頂部選單欄中的 `Add publisher` 和 `Add subscriber` 按鈕可以新增和管理多個釋出訂閱。

我們先在右側的黃色框內輸入 Topic：`testtopic/mqttbox`，選擇 QoS 等級後，點選 `Subscribe` 按鈕即可訂閱相關 Topic。

### MQTT 訊息釋出

然後我們在藍色的框內輸入要釋出的 Topic，這裡輸入剛才訂閱過的 `testtopic/mqttbox`，選擇 QoS 級別，選擇預設的 Payload Type，支援 `String / JSON / XML / Characters`，我們 Payload 的框內輸入一段 JSON 後，點選 Publish 按鈕。

此時我們可以看到右邊的訂閱框內，出現了剛才釋出的訊息。至此，我們已經建立了一個 MQTT 客戶端併成功測試了連線、釋出、訂閱等功能。

![MQTTBox 訊息釋出](https://img-blog.csdnimg.cn/img_convert/5526bd8bca5ee4ad52304f3c2d867810.png)

### TLS/SSL 連線

除普通連線外，MQTTBox 還支援 TLS/SSL 連線。

如使用 EMQ X Cloud 的話，可以參考該[文件](https://docs.emqx.cn/cloud/latest/deployments/tls_ssl.html#%E8%AF%81%E4%B9%A6%E9%99%90%E5%88%B6)來建立證書。我們可以進入到客戶端詳情頁中，選擇協議為 mqtts/tls 或者 wss，然後選擇儲存。

如果是雙向認證的話，可以在配置頁面中選擇 CA 證書檔案，客戶端證書和客戶端 Key 檔案，再選擇連線。連線前請確定 TLS/SSL 連線的埠並做修改。

![MQTTBox TLS/SSL 連線](https://img-blog.csdnimg.cn/img_convert/d331ee73c19464730922c7289c05298e.png)

>版權宣告： 本文為  [EMQ]( https://www.emqx.io/cn/) 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/connecting-to-emqx-cloud-with-mqttbox](https://www.emqx.com/zh/blog/connecting-to-emqx-cloud-with-mqttbox)

使用 MQTTBox 接入 EMQ X Cloud

相關文章