近年來，隨著物聯網技術的快速發展，MQTT（Message Queuing Telemetry Transport）作為一種輕量級的通訊協議，被廣泛應用于物聯網設備之間的通訊。EMQX平臺作為一款開源的MQTT消息服務器，提供了穩定可靠的消息傳輸服務。本次教程中，我們將探討如何基于EMQX平臺自建MQTT服務器，并實現設備之間的高效通訊。無論是在工業控制、智能家居還是智能城市等領域，搭建自己的MQTT服務器都能為我們帶來更大的靈活性和可擴展性。讓我們一起深入了解這個過程，為物聯網應用打下堅實的基礎。

開始前，我們需要準備一臺服務器，本地或是公網服務器均可。此次教程我們使用的是本地服務器，服務器系統使用的是Debian 12系統，公網服務器的方法相同。為了方便新人操作，這里推薦使用Docker搭建方法，可以避免環境不同導致的錯誤。

一

服務器中安裝Docker以及Docker Compose

在開始之前，我們需要確認服務器的 root 賬號是否正常啟用。本教程將使用 ssh 的 root 賬號連接服務器，請確保服務器能夠通過 ssh 工具正常連接。

首先，通過 ssh 連接服務器。這里大家可以任意選擇連接的方法，原理相同，不需要完全一致。這里我們為了方便，直接使用本地終端命令 ssh 連接服務器：

接下來，我們需要在服務器上安裝 Docker 和 Docker Compose。如果已經安裝完成，可以跳過此步驟。關于 Docker 和 Docker Compose 的安裝方法，大家可以參考官網手冊（https://docs.docker.com/desktop/install/linux-install/ ）進行安裝，也可以使用我們為大家準備的命令進行安裝。

首先，更新并安裝會用到的工具：

apt-get update && apt-get install -y wget vim

完成后，通過以下命令安裝 Docker：

wget -qO- get.docker.com | bash

安裝完成后，我們可以使用 docker -v 命令查看是否安裝成功。

然后，我們開始安裝 Docker Compose。在 Docker 的官方文檔中可以找到相關的安裝教程。

curl -SL https://github.com/docker/compose/releases/download/v2.19.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

安裝完成后，將可執行權限應用于安裝目標路徑中的獨立二進制文件：

sudo chmod +x /usr/local/bin/docker-compose

然后，使用 docker-compose --version 命令查看版本，檢查安裝是否成功。

至此，我們已經成功安裝了 Docker 和 Docker Compose。接下來，我們將正式開始部署 EMQX 服務。

二

在 Docker 中部署 EMQX 服務

在 EMQX 官網中，我們點擊 Download 進入下載頁面，可以找到不同系統的教程。

在本次教程中，我們將使用 Docker 部署，因此我們看到 Docker 部署頁面的教程。

這里演示使用 SSH 的方式連接服務器。我們可以參考官方介紹進行部署。

使用 Docker 指令直接部署，可以使用以下命令：

docker pull emqx/emqx:5.1.1

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:5.1.1

安裝完成后，可以使用 docker ps 命令查看是否安裝成功。

安裝完成后，打開瀏覽器，并在地址欄中輸入 http://localhost:18083/（localhost 可以用您的 IP 地址替換）以訪問 EMQX 儀表板，您可以從那里連接到客戶端或檢查運行狀態。

默認用戶名和密碼：

admin

public

首次登錄時，會要求修改密碼。根據提示修改密碼即可：

之后，我們即可進入 EMQX 管理頁面。

至此，EMQX 已成功安裝到我們的服務器內。接下來，我們可以通過配置 EMQX 平臺將 MQTT 設備接入服務器。

三

使用 MQTT 將設備連接到 EMQX 服務器

接下來，我們將使用串口服務器 NB114 模擬實際設備，演示設備如何使用 MQTT 協議連接 EMQX 服務器。在連接過程中，我們將使用上位機軟件和串口調試助手軟件（XCOM）。這些軟件可在產品相關頁面下載，如果您對產品的連接通訊方法不熟悉，可以參考產品的快速入門教程。在這里，我們假設您已經成功連通了設備。

這里我們不詳細介紹 EMQX 的配置，您可以參考官方提供的手冊進行配置。我們將重點介紹如何進行連接和通訊。

在默認情況下，EMQX 可以直接通過 MQTT 協議連接，無需額外的設置。在“訪問控制→客戶端授權”頁面中，可以配置客戶端的訪問規則。

為了方便，我們不進行修改，直接打開上位機軟件，配置 NB114 進行連接。

其中，“目標 IP”即為 EMQX 的 IP 地址。

“目標端口”為 MQTT 端口號（1883）。在“平臺”中選擇“標準 MQTT 3.1.1”，并填寫“ClientID”、“UserName”、“PassWord”、“訂閱與發布主題”。由于 EMQX 并未配置訪問規則，我們可以任意填寫這些信息，不會影響設備的連接。完成配置后，點擊“保存”并重啟設備。稍等片刻，即可看到設備已經成功連接到服務器。我們在 EMQX 服務器中的“監控→客戶端”頁面中可以查看到設備的連接狀態。

接下來，我們測試發布和訂閱主題是否正常。首先，我們需要打開 EMQX 平臺中的“問題分析→WebSocket 客戶端”頁面，并將協議版本設置為 3.1.1，其余內容可以保持不變。完成后，點擊“連接”。

接下來，我們需要設置訂閱和發布主題，將其設置為剛才在 NB114 中填寫的訂閱和發布主題。注意，這里填寫的訂閱和發布主題需要交叉填寫（訂閱填寫發布的內容，發布填寫訂閱的內容）。完成后，在訂閱主題中，需要先點擊“訂閱”，確保 WebSocket 客戶端能夠收到消息。

接下來，我們打開串口調試助手（XCOM）軟件，填寫 NB114 的參數，并選擇連接。

隨后，我們發送任意內容，即可在 WebSocket 客戶端的訂閱列表中查看到相關信息。

此時，我們再點擊發布主題后面的“發布”按鈕，即可在 XCOM 軟件中查看到相關信息。

至此，我們已經成功實現了 NB114 與 EMQX 服務器之間的通訊。

所有教程相關的內容都已經講解完成。在本次教程中，我們從 EMQX 服務器的搭建開始，到最終實現設備與服務器之間的基礎通訊，全部講解完畢。當然，本次教程的內容相當基礎，設備的連接并未設置任何相關的限制，這樣是相當不安全并且浪費資源的。如果您需要將這些內容應用到實際項目中，可以參考 EMQX 手冊中的相關內容進行配置。