[EMQX](https://www.emqx.com/zh/products/emqx) 是一款全球下載量超千萬的大規模分散式物聯網 [MQTT 伺服器](https://www.emqx.io/zh)，自 2013 年在 GitHub 釋出開源版本以來，獲得了來自 50 多個國家和地區的 20000 餘家企業使用者的廣泛認可，累計連線物聯閘道器鍵裝置超過 1 億臺。

不久前，[EMQX 釋出了 5.0 版本](https://www.emqx.com/zh/blog/emqx-v-5-0-released)，該版本在訊息傳輸的可靠性、產品體驗的易用性等方面也進行了大幅最佳化升級，是 MQTT 領域的一個里程碑式的成果。在釋出前效能測試中，EMQX 團隊透過一個 23 節點的叢集達成了 [1 億 MQTT 連線](https://www.emqx.com/zh/blog/how-emqx-5-0-achieves-100-million-mqtt-connections)+每秒 100 萬訊息吞吐，這使得 EMQX 5.0 成為目前為止全球最具擴充套件性的 MQTT 伺服器。

EMQX 目前支援在 Linux、Windows、macOS、Raspbian 等系統中執行，也支援使用 Docker、Kubernetes、Terraform 部署。本文將以 EMQX 開源版 5.0.4 為例，介紹如何在 Ubuntu 系統中搭建一個單節點的 MQTT 伺服器，並對搭建過程中容易遇到的常見問題進行逐一演示。

## 安裝 EMQX

本文使用的演示環境為：阿里雲上海區域2核4G（ecs.c7.large），**Ubuntu 20.04 64位**。

### 使用 APT 安裝 EMQX

APT 是 Ubuntu 自帶的包管理器，建議優先使用 APT 安裝 EMQX。同時，EMQX 也提供了官方的 APT 源及一鍵式配置指令碼，方便使用者快速安裝 EMQX。

1. 配置 EMQX APT 源。

```awk
   curl -s https://assets.emqx.com/scripts/install-emqx-deb.sh | sudo bash
   ```

複製如上命令到 Ubuntu 終端下執行，如下圖即表示配置成功。

[![配置 APT 源](http://img.blog.itpub.net/blog/2022/08/26/c8c2a7af82668abc.png?x-oss-process=style/bb "配置 APT 源")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "配置 APT 源")

2. 安裝 EMQX 最新版。

```routeros
   sudo apt-get install emqx
   ```

3. 安裝成功後，使用如下命令啟動 EMQX。

```crmsh
   sudo emqx start
   ```

如下圖，若啟動成功，將會提示：`EMQX 5.0.4 is started successfully!`。若命令長時間無響應，請透過 [EMQX 執行情況檢查](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu#emqx-執行情況檢查) 章節說明檢視相關埠是否被佔用。

[![啟動 MQTT 伺服器](http://img.blog.itpub.net/blog/2022/08/26/edd47f78c70af831.png?x-oss-process=style/bb "啟動 MQTT 伺服器")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "啟動 MQTT 伺服器")

4. EMQX 管理命令

EMQX 提供了命令列工具，方便使用者對 EMQX 進行啟動、關閉、進入控制檯等操作。如下圖，在終端執行 `sudo emqx` 檢視 EMQX 相關管理命令。

[![EMQX 管理命令](http://img.blog.itpub.net/blog/2022/08/26/cf2220df1dbc4be5.png?x-oss-process=style/bb "EMQX 管理命令")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "EMQX 管理命令")

### 使用 tar.gz 包安裝 EMQX

當伺服器無公網接入或需要快速部署、驗證 EMQX 功能時可使用 `tag.gz` 包安裝，該安裝方式無任何第三方依賴且管理方便。

#### 下載安裝包

訪問 EMQX 下載地址 https://www.emqx.io/zh/downloads?os=Ubuntu。選中 `Package` 標籤，安裝包型別選擇 `Ubuntu20.04 amd64/tag.gz`，然後點選右邊的複製圖示（這將會複製整行 wget 下載命令）。

[![下載 EMQX](http://img.blog.itpub.net/blog/2022/08/26/61b157696d23a6ac.png?x-oss-process=style/bb "下載 EMQX")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "下載 EMQX")

將下載命令貼上至伺服器命令列終端，執行下載操作。

[![下載 EMQX1](http://img.blog.itpub.net/blog/2022/08/26/9a500a71919172ab.png?x-oss-process=style/bb "下載 EMQX1")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "下載 EMQX1")

#### 解壓安裝

在伺服器終端執行如下命令，該命令將會把壓縮包解壓至當前目錄下的 `emqx` 目錄。

> 本次演示將會安裝在當前使用者的家目錄下，即 `~/emqx/`

```apache
mkdir -p emqx && tar -zxvf emqx-5.0.4-ubuntu20.04-amd64.tar.gz -C emqx
```

接下來可使用如下命令啟動 EMQX

```awk
./emqx/bin/emqx start
```

若啟動成功，將會提示：`EMQX 5.0.4 is started successfully!`。若命令長時間無響應，請透過 [EMQX 執行情況檢查](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu#emqx-執行情況檢查) 章節說明檢視相關埠是否被佔用。

## EMQX 執行情況檢查

### 埠監聽情況

使用命令 `netstat -tunlp` 檢查 EMQX 埠執行情況，預設情況下 EMQX 會啟動如下埠，若有異常請檢查埠占用情況。

> 該命令也可在 EMQX 安裝前執行，確保相關埠未被佔用。

[![MQTT 伺服器埠](http://img.blog.itpub.net/blog/2022/08/26/e321b09e4758a0f8.png?x-oss-process=style/bb "MQTT 伺服器埠")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT 伺服器埠")

[![表格](http://img.blog.itpub.net/blog/2022/08/26/80079d40ffb060d0.png?x-oss-process=style/bb "表格")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "表格")

### 訪問 Dashboard

EMQX 提供了 Dashboard，以方便使用者透過 Web 頁面管理、監控 EMQX 並配置所需的功能。EMQX 成功啟動之後可以透過瀏覽器開啟 `http://localhost:18083/`（將 localhost 替換為實際 IP 地址）訪問 Dashboard。

> 訪問 Dashboard 之前需要確保伺服器的防火牆開啟了 18083 埠

Dashboard 的預設使用者名稱為 `admin`，密碼為 `public`，第一次登入成功後會提示修改密碼。密碼修改完成後，我們也可以在 Settings 頁面將 Dahshboard 的語言改為 `簡體中文`。

[![MQTT Dashboard](http://img.blog.itpub.net/blog/2022/08/26/1b1d316b5f2f3675.png?x-oss-process=style/bb "MQTT Dashboard")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT Dashboard")

## MQTT 連線測試

接下來我們點選左側選單欄裡面的 `WebSocket 客戶端` ，該客戶端可測試 MQTT over Websocket，驗證 MQTT 伺服器是否已部署成功。

> 需要確保防火牆已開啟 8083 埠訪問許可權

### 連線至 MQTT 伺服器

如下圖，該工具已根據訪問地址自動填充了主機名，我們直接點選`連線`按鈕。

[![MQTT over WebSocket 連線至 MQTT 伺服器](http://img.blog.itpub.net/blog/2022/08/26/3ab858c311c50e1d.png?x-oss-process=style/bb "MQTT over WebSocket 連線至 MQTT 伺服器")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT over WebSocket 連線至 MQTT 伺服器")

如下圖，提示連線成功。

[![MQTT over WebSocket 連線至 MQTT 伺服器成功](http://img.blog.itpub.net/blog/2022/08/26/1c46e3fede4856cc.png?x-oss-process=style/bb "MQTT over WebSocket 連線至 MQTT 伺服器成功")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT over WebSocket 連線至 MQTT 伺服器成功")

### 訂閱主題

如下圖，訂閱一個 `testtopic` 主題。

[![MQTT over WebSocket 訂閱主題](http://img.blog.itpub.net/blog/2022/08/26/aa79b385a875e8d6.png?x-oss-process=style/bb "MQTT over WebSocket 訂閱主題")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT over WebSocket 訂閱主題")

### 訊息釋出

如下圖，我們向 `testtopic` 釋出了兩條訊息，且接收成功，表明 MQTT 伺服器已部署成功且在正常執行。

[![MQTT over WebSocket 訊息釋出](http://img.blog.itpub.net/blog/2022/08/26/7dafcf83882a8f0d.png?x-oss-process=style/bb "MQTT over WebSocket 訊息釋出")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT over WebSocket 訊息釋出")

至此，我們已完成了 MQTT 伺服器的搭建及連線測試，但是該伺服器僅僅只能用於測試，若要部署生產環境下可用的 MQTT 伺服器，我們還需要進行最重要的認證配置。

## 配置認證

預設情況下，EMQX 將允許任何客戶端連線，直到使用者建立了認證器。認證器將根據客戶端提供的認證資訊對其進行身份驗證，只有認證透過，客戶端才能成功連線。接下來我們將演示如何使用 EMQX 內建的資料庫進行使用者名稱、密碼認證。

> EMQX 也提供了與多種後端資料庫的認證整合支援，包括 MySQL、PostgreSQL、MongoDB 和 Redis。
>
> 檢視文件瞭解更多認證方式：https://www.emqx.io/docs/zh/v5.0/security/authn/authn.html

### 建立認證

EMQX 從 5.0 開始支援在 Dashbaord 配置認證，以方便使用者能更加方便、快速的建立安全的 MQTT 服務。我們點選 `訪問控制` 選單下的 `認證` 進入認證配置頁面，然後點選最右側的 `建立` 按鈕。

[![建立認證](http://img.blog.itpub.net/blog/2022/08/26/0a39c1cdf1d92efe.png?x-oss-process=style/bb "建立認證")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "建立認證")

選擇 `Password-Based` 選項，然後點選 `下一步`。

[![選擇 Password-Based](http://img.blog.itpub.net/blog/2022/08/26/b276f92b3f086e5f.png?x-oss-process=style/bb "選擇 Password-Based")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "選擇 Password-Based")

資料庫選擇 `Built-in Database`，然後點選 `下一步`。

[![選擇 Built-in Database](http://img.blog.itpub.net/blog/2022/08/26/8fe63af2dee2d6bb.png?x-oss-process=style/bb "選擇 Built-in Database")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "選擇 Built-in Database")

接下來選擇賬戶型別、加密方式、加鹽方式，並點選 `建立`。

> 這裡我們使用預設配置，讀者可根據業務實際需求進行選擇。

[![建立認證1](http://img.blog.itpub.net/blog/2022/08/26/4076b66b58bc2b0f.png?x-oss-process=style/bb "建立認證1")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "建立認證1")

### 新增使用者

認證建立成功後如下圖。接下來我們點選 `使用者管理`新增使用者。

[![使用者管理](http://img.blog.itpub.net/blog/2022/08/26/1a0ee2ca07e35fc9.png?x-oss-process=style/bb "使用者管理")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "使用者管理")

進入使用者管理頁面後，我們點選最右側的 `新增` 按鈕，並在彈出框裡設定使用者名稱與密碼，之後點選 `儲存`。

[![新增使用者](http://img.blog.itpub.net/blog/2022/08/26/158f98d8b6387056.png?x-oss-process=style/bb "新增使用者")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "新增使用者")

如下圖表示建立成功。

[![新增使用者成功](http://img.blog.itpub.net/blog/2022/08/26/6b568096e1c80f0d.png?x-oss-process=style/bb "新增使用者成功")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "新增使用者成功")

### 測試認證

接下來我們使用 Dashboard 提供的 Websocket 工具來測試認證是否已配置成功。在連線配置裡輸入剛才建立的使用者名稱與密碼，然後點選`連線`。

[![連線](http://img.blog.itpub.net/blog/2022/08/26/6178ba5146ff4e5f.png?x-oss-process=style/bb "連線")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "連線")

將會看到右側彈窗提示已連線。

[![MQTT 連結成功](http://img.blog.itpub.net/blog/2022/08/26/149dca27033ac85a.png?x-oss-process=style/bb "MQTT 連結成功")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT 連結成功")

接下來我們使用一個未建立的使用者名稱 `test1`，點選連線將會看到如下連線失敗資訊。

[![MQTT 連線失敗](http://img.blog.itpub.net/blog/2022/08/26/b65ab72ff37767ff.png?x-oss-process=style/bb "MQTT 連線失敗")](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu "MQTT 連線失敗")
至此，我們已完成了 EMQX 的認證配置，搭建了一臺可用於生產環境的單節點 MQTT 伺服器。若要保證 MQTT 伺服器的高可用，還需要建立多個節點的 EMQX 叢集，建立叢集的具體細節本文不再詳述，讀者可參考 [EMQX 叢集文件](https://www.emqx.io/docs/zh/v5.0/deploy/cluster/intro.html) 進行配置。

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu](https://www.emqx.com/zh/blog/how-to-install-emqx-mqtt-broker-on-ubuntu)

如何在 Ubuntu 上安裝 EMQX MQTT 伺服器

相關文章