近日，由 EMQ 開源的 [MQTT 5.0 跨平臺桌面客戶端 MQTT X](https://mqttx.app/zh) 釋出了 1.8.0 版本。MQTT X 為連線測試各類 [MQTT 訊息伺服器](https://www.emqx.io/zh)而生，支援快速建立多個同時線上的 [MQTT 客戶端](https://www.emqx.io/zh/mqtt-client)連線，採用一鍵式的連線方式和簡潔的圖形介面，幫助使用者便捷地測試 MQTT/TCP、MQTT/TLS、MQTT/WebSocket 的連線、釋出、訂閱功能，探索更多 [MQTT 協議](https://www.emqx.com/zh/mqtt)特性。

最新發布的 v1.8.0 除了透過新增的快速複製連線功能最佳化使用體驗之外，還擴充套件了兩個新的使用場景，即增加了 CLI（命令列） 和 Web 端這兩種新的互動方式 。這使得 MQTT X 1.8.0 成為支援使用場景最完整的 MQTT 測試客戶端。使用者可以根據使用需求，自行選擇下載桌面客戶端、使用終端命令列或是在桌面瀏覽器上快速完成對 MQTT 的連線測試。

## MQTT X CLI：在終端快速開發和除錯 MQTT 服務與應用

隨著 MQTT 協議在物聯網領域的廣泛使用，越來越多的使用者選擇使用 MQTT X 進行物聯網連線測試。對於部分使用者如服務端開發者、服務運維人員等來說，下載桌面客戶端可能會佔用系統的大量磁碟空間，每次測試前都需要在帶有圖形化介面的作業系統中開啟客戶端應用來除錯。在這種情況下，桌面客戶端這種使用方式就變得不太友好。

因此 MQTT X 增加了命令列這一互動形式——MQTT X CLI。這是一款全開源的 MQTT 5.0 命令列客戶端工具，即命令列上的 MQTT X。**開發者無需使用圖形化介面，就能透過 MQTT X CLI 使用命令列快速開發和除錯 MQTT 服務與應用。**從而實現以下使用目標：

- 在伺服器終端內就可以測試已經部署好的 MQTT 服務
- 透過編輯和使用命令列指令碼完成 MQTT 服務的快速測試
- 使用命令列指令碼來完成一些簡單的壓力測試或自動化測試

> MQTT X CLI 網站：https://mqttx.app/zh/cli
>
> MQTT X CLI v1.8.0 版本下載：https://github.com/emqx/MQTTX/releases/tag/v1.8.0
>
> MQTT X CLI GitHub 倉庫：https://github.com/emqx/MQTTX/tree/main/cli

[![MQTT CLI](http://img.blog.itpub.net/blog/2022/07/25/b4385029711f3775.jpeg?x-oss-process=style/bb "MQTT CLI")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "MQTT CLI")

## 便捷高效：無需依賴環境即可安裝使用

### 安裝

MQTT X CLI 可以快速下載並安裝到 macOS、Linux 和 Windows 系統上，**安裝前不需要任何的依賴環境準備**，只需在終端內執行命令，即可安裝和使用 MQTT X CLI。

對於 macOS 和 Linux 系統的使用者，我們提供了快捷的安裝方法，使用命令列可以快速下載二進位制檔案，並安裝最新的 MQTT X CLI 穩定版到作業系統上。Windows 使用者則可以到 MQTT X 的[釋出頁面](https://github.com/emqx/MQTTX/releases)內，找到對應的系統架構的 `exe` 包，手動下載後使用。

> 注意：下載安裝時請注意區分當前使用系統環境的 CPU 架構

#### **macOS**

- **Homebrew**

macOS 使用者可以透過 Homebrew 來快速安裝和使用 MQTT X CLI

```awk
  brew install emqx/mqttx/mqttx-cli
  ```

- **Intel Chip**

```awk
  curl -LO https://www.emqx.com/zh/downloads/MQTTX/v1.8.0/mqttx-cli-macos-x64
  sudo install ./mqttx-cli-macos-x64 /usr/local/bin/mqttx
  ```

- **Apple Silicon**

```awk
  curl -LO https://www.emqx.com/zh/downloads/MQTTX/v1.8.0/mqttx-cli-macos-arm64
  sudo install ./mqttx-cli-macos-arm64 /usr/local/bin/mqttx
  ```

#### **Linux**

- **x86-64**

```awk
  curl -LO https://www.emqx.com/zh/downloads/MQTTX/v1.8.0/mqttx-cli-linux-x64
  sudo install ./mqttx-cli-linux-x64 /usr/local/bin/mqttx
  ```

- **ARM64**

```awk
  curl -LO https://www.emqx.com/zh/downloads/MQTTX/v1.8.0/mqttx-cli-linux-arm64
  sudo install ./mqttx-cli-linux-arm64 /usr/local/bin/mqttx
  ```

#### **Windows**

Windows 使用者請到 MQTT X 的下載頁面內手動下載對應的 `exe` 檔案來使用，下載地址：https://github.com/emqx/MQTTX/releases/tag/v1.8.0

[![Windows MQTT](http://img.blog.itpub.net/blog/2022/07/25/733740d35c6bde09.png?x-oss-process=style/bb "Windows MQTT")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "Windows MQTT")

#### **NPM**

除上述方法外，我們還提供了使用 `npm` 的安裝方式，這樣無論當前是什麼作業系統環境，只要您的系統中有 `Node.js` 環境，就可以快速安裝和使用。

```avrasm
npm install mqttx-cli -g
```

### 快速開始

在完成下載安裝後，便可在終端內直接輸入 `mqttx` 命令來執行和使用了。您可以加 `-V` 引數來驗證 MQTT X CLI 是否安裝成功，當輸出一個版本號時，就證明 MQTT X CLI 已經成功安裝。

```crystal
$ mqttx -V
1.8.0
```

為測試 MQTT X CLI 的使用，我們需要準備一個 MQTT 服務，本文將使用 EMQ 提供的 [免費公共 MQTT 伺服器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker)，該服務基於 [MQTT 物聯網雲平臺 - EMQX Cloud](https://www.emqx.com/zh/cloud) 建立，伺服器接入資訊如下：

- Broker: `broker.emqx.io`
- TCP Port: **1883**
- WebSocket Port: **8083**

準備好 MQTT 服務後，我們就可以在終端內使用命令列來完成訊息的釋出與訂閱了，我們先在一個終端視窗內，編輯一條訂閱主題的命令。

**訂閱**

```sml
mqttx sub -t 'mqttx/cli' -h 'broker.emqx.io' -p 1883
```

在完成訂閱後，我們再新建一個終端視窗，編輯一條釋出到剛才訂閱的主題的訊息的命令。

**釋出**

```nginx
mqttx pub -t 'mqttx/cli' -h 'broker.emqx.io' -p 1883 -m 'hello from MQTTX CLI!'
```

此時我們可以在訂閱主題命令的視窗內，看到一條剛才釋出過來的訊息。

[![MQTT CLI1](http://img.blog.itpub.net/blog/2022/07/25/1363483f39ea336e.png?x-oss-process=style/bb "MQTT CLI1")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "MQTT CLI1")

**釋出多條訊息**

MQTT X CLI 還支援一個 `pub` 命令可以釋出多條訊息的功能，只需要在編輯是在命令中新增一個 `-M` 引數和 `-s` 引數，每次輸入完成後換行即可。

```sml
mqttx pub -t 'mqttx/cli' -h 'broker.emqx.io' -p 1883 -s -M
```

[![MQTT CLI2](http://img.blog.itpub.net/blog/2022/07/25/f42f0c06e19f576e.png?x-oss-process=style/bb "MQTT CLI2")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "MQTT CLI2")

最後，我們再透過使用 MQTT X 的桌面客戶端來和 MQTT X CLI 來連線到同一個 MQTT 服務，來測試和驗證 MQTT X CLI 的功能，我們使用 MQTT X CLI 釋出一條訊息，透過 MQTT X 桌面客戶端來接收，再反向使用 MQTT X 桌面客戶端來傳送一條訊息到 MQTT X CLI。此時，我們可以看到兩邊都收到了各自收發的訊息。

[![MQTT 桌面客戶端](http://img.blog.itpub.net/blog/2022/07/25/6b6406bbdc9d1d1b.png?x-oss-process=style/bb "MQTT 桌面客戶端")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "MQTT 桌面客戶端")

[![MQTT CLI3](http://img.blog.itpub.net/blog/2022/07/25/52a55a3b4e65db1d.png?x-oss-process=style/bb "MQTT CLI3")](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool "MQTT CLI3")

## 結語

至此，我們就完成了使用 MQTT X CLI 對 MQTT 訊息釋出訂閱功能的測試和驗證。除上述常用功能使用外，MQTT X CLI 還支援設定遺囑訊息、使用 SSL/TLS 來測試 mqtts 的連線等。未來還將支援 MQTT 5.0 連線。

MQTT X CLI 的釋出，為物聯網開發者進行 MQTT 連線測試提供了一種新的選擇。而對命令列呼叫、桌面客戶端下載和線上瀏覽器這幾種互動形式的完整支援，使得 MQTT X 1.8.0 可幫助不同使用場景需求的使用者完成對 MQTT 服務或應用的開發與除錯，從而提高使用者自身相關業務能力與穩定性。簡單易用的測試客戶端工具 MQTT X 結合高效可靠的物聯網訊息伺服器 EMQX，將幫助物聯網開發者構建具有競爭力的物聯網平臺與應用。

## 附：使用幫助

您可以在命令列內輸入 `--help` 引數來獲取使用幫助，或查閱下方的使用參數列來使用 MQTT X CLI。

```applescript
# 獲取 mqttx 命令的幫助
mqttx --help

# 獲取訂閱命令的幫助
mqttx sub --help

# 獲取釋出命令的幫助
mqttx pub --help
```

### 使用**引數對照表**

[![](http://img.blog.itpub.net/blog/2022/07/25/be7d7570ffa2c7a0.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool)
[![](http://img.blog.itpub.net/blog/2022/07/25/c9450b6e39046a26.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool)

**訂閱**

[![](http://img.blog.itpub.net/blog/2022/07/25/585569e607fc1653.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool)

**釋出**

[![](http://img.blog.itpub.net/blog/2022/07/25/2f1c2c2346314c1e.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool)

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool](https://www.emqx.com/zh/blog/powerful-and-easy-to-use-mqtt-5-command-line-tool)

MQTT X CLI 正式釋出：強大易用的 MQTT 5.0 命令列工具

相關文章