MQTT 已經是物聯網事實上的標準通訊協議。在目前市面上提供的各類開源 MQTT 伺服器中，最常見的是 Linux 平臺為基礎，對於 Windows 平臺的支援較少，即使支援也存在效能較弱、功能單一、版本相容性等問題。

然而在工業自動化和建築智慧領域，有許多場景仍然依賴於 Windows 的生態環境。特別是工控上位機仍然大量使用 C# 開發執行在安裝 Windows 的工控機中，有的成本敏感場景甚至還在使用 WinCE 作業系統。為了能讓這些使用者也能在 Windows 上使用到方便易用、輕量小巧、功能齊全的 MQTT 訊息服務，超輕量級物聯網邊緣 [MQTT 訊息伺服器 NanoMQ](https://nanomq.io/zh) 依賴其強大的跨平臺和可相容能力，透過 MinGW 的 POSIX 編譯環境成功移植到了各類 Windows 環境。

本文將以 NanoMQ 為例，演示如何透過安裝包和原始碼編譯兩種安裝方式，在 Windows 系統中快速搭建一個可以支援多協議連線的物聯網 MQTT 訊息伺服器。

## NanoMQ 簡介

NanoMQ 是 EMQ 推出的面向物聯網邊緣計算場景的超輕量級高效能 **MQTT** 訊息伺服器+訊息匯流排（Github 地址: https://github.com/emqx/nanomq），具有超輕量、高吞吐、低延遲、相容性高和可移植等優點，能夠在各類作業系統和 CPU 架構上部署。

![圖片1.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/66a8ca4a87a14d42a997324316948b2c~tplv-k3u1fbpfcp-watermark.image?)
目前 **NanoMQ** 具有的功能有：

- 完整支援**MQTT 3.1.1/5.0**。
- 嵌入式規則引擎，支援訊息的實時處理和持久化。
- 支援雲端橋接，並可以進行訊息離線快取和自動重傳。
- 提供豐富的 HTTP REST APIs，方便雲邊協同和遠端運維監控。
- 多協議支援 ：MQTT over WebSocket， ZeroMQ 和 nanomsg 等。
- 支援第三方 HTTP 認證和 WebHook 整合方式。

## 安裝包安裝

第一種方法我們將直接使用二進位制安裝包進行安裝。

### 下載安裝包

首先進入 NanoMQ 官網下載頁面：https://nanomq.io/zh/downloads，並選擇 Windows 平臺下載安裝包：

![圖片2.png](https://p1-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/50426ef5f0fb459ca3267614595cf899~tplv-k3u1fbpfcp-watermark.image?)

從 NanoMQ 官網下載 Windows 釋出包

目前最新的 NanoMQ Windows Release 版本是 0.10.5。

### 安裝包安裝

下載會得到一個 msi 格式的安裝包，雙擊進行安裝。

![NanoMQ 安裝包](https://assets.emqx.com/images/12f966985547af7ba79a27ff1bc2ce3b.png?imageMogr2/thumbnail/1520x)

下載的安裝包

選擇安裝路徑和所需安裝的功能，安裝包也包含了 NanoSDK 的庫檔案：

![圖片三.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/ca4bbda0c816459abdae3ed673eecb6e~tplv-k3u1fbpfcp-watermark.image?)

安裝完成後程式自動退出。

### 測試和啟動 NanoMQ 服務

目前 NanoMQ 還不包含視覺化介面，所以需要透過命令列或者服務啟動，啟動方式如下：

開啟命令列視窗或者 PowerShell，輸入 nanomq 可以看到：

![圖片4.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/fe1af78c5cc44327b9405b1d47db65a9~tplv-k3u1fbpfcp-watermark.image?)

檢查命令是否能夠正常使用

說明系統已經成功安裝了 NanoMQ，可以透過輸入 --help 瞭解具體有哪些命令選項。

啟動的話可以使用 `nanomq start --conf C:\nanomq\config\nanomq.conf` 配置檔案指定的路徑請根據第二步的安裝選擇的路徑找到對應的配置檔案，簡單的配置選項有：

```shell
## url
## Connect with the host and port
## 監聽的埠和IP地址
## Value: nmq-tcp://host:port
url=nmq-tcp://localhost:1883

## num_taskq_thread
## Use a specified number of taskq threads 
## 執行緒數，建議設定成和CPU核數相同
## Value: 1-255
num_taskq_thread=4

## max_taskq_thread
## Use a specified maximunm number of taskq threads
## 執行緒數，建議設定成和CPU核數相同
## Value: 1-255
max_taskq_thread=4

## msq_len
## The queue length in-flight window
## This is essential for performance and memory consumption
## 飛行視窗長度大小，影響broker最大記憶體佔用
## Value: 1-infinity
msq_len=256
```

在 Windows 平臺，監聽的 URL 需要設定成 `nmq-tcp://localhost:1883` 。除了 nanomq.conf 配置檔案外，其他功能的具體配置方法可以參考 [NanoMQ的文件頁面](https://nanomq.io/docs/zh/latest/)。

測試 NanoMQ 服務是否正常執行，可以使用 NanoMQ 自帶的客戶端工具直接測試：

![圖片5.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/99241c6259714d2291664727fbcca076~tplv-k3u1fbpfcp-watermark.image?)

透過 NanoMQ 的 Pub/Sub 命令，可以看到已經可以正常收發訊息，Sub 客戶端可以收到 Pub 客戶端發的 Hello 訊息。

## 原始碼編譯及執行

第二種方法是透過原始碼進行編譯安裝，這種方法允許我們在 Windows 上對 NanoMQ 進行二次開發並增加自己需要的功能。

目前 NanoMQ 在 Windows 下的編譯需要 [MinGW-w64](https://www.mingw-w64.org/downloads/#mingw-builds)、[Make](http://gnuwin32.sourceforge.net/packages/make.htm) 和 [CMake](https://cmake.org/download/)。

- **MinGW-w64** 下載地址: [https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/mingw-w64-install.exe/download](https://sourceforge.net/projects/mingw-w64/files/Toolchains targetting Win32/Personal Builds/mingw-builds/installer/mingw-w64-install.exe/download)
- **Make** 下載地址：https://sourceforge.net/projects/gnuwin32/files/make/3.81/make-3.81.exe/download?use_mirror=jaist&download=
- **CMake** 下載地址: https://cmake.org/download/

### 原始碼準備

首先需要從 NanoMQ 原始碼倉庫下載原始碼，注意 NanoMQ 內部包含一個子模組 NNG。

**NanoMQ** 原始碼倉庫: https://github.com/emqx/nanomq

下載連結：https://github.com/emqx/nanomq/archive/refs/heads/master.zip

NanoNNG 原始碼倉庫：https://github.com/nanomq/NanoNNG/tree/main

下載連結：https://github.com/nanomq/NanoNNG/archive/refs/heads/main.zip

NNG 的原始碼需要放置在 nanomq 的 nng 目錄下，準備好原始碼後就可以開始編譯。

### 編譯安裝 NanoMQ

#### 命令列編譯

> 以下命令在 Windows PowerShell 或 Git bash 中執行.

```powershell
# 1. clone 原始碼 （已透過ZIP下載原始碼則不需要這一步）
PS: D:\Project> git clone https://github.com/emqx/nanomq.git
PS: D:\Project> cd nanomq

# 2. 更新和初始化 git 子模組
PS: D:\Project\nanomq> git submodule update --init --recursive

# 3. 建立並進入 build 目錄
PS: D:\Project\nanomq> mkdir build
PS: D:\Project\nanomq> cd build

# 4. 編譯 NanoMQ
PS: D:\Project\nanomq\build> cmake -G "MinGW Makefiles" ..
PS: D:\Project\nanomq\build> make -j 8

# 5. 執行 NanoMQ
PS: D:\Project\nanomq\build> .\nanomq\nanomq.exe broker start
```

#### Visual Studio Code 中編譯

> 需提前安裝 VS Code 的 C/C++ 和 CMake 相關外掛

![圖片6.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/855792c25e82449fbbf8ac9d002f613b~tplv-k3u1fbpfcp-watermark.image?)

![圖片7.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/ffec8eb2a47e456d80c9c803fa41b62b~tplv-k3u1fbpfcp-watermark.image?)

![圖片8.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/abc9e6e22bb9480a97a822b261341c32~tplv-k3u1fbpfcp-watermark.image?)

1. 點選選擇編譯工具鏈；

2. 選擇 GCC 8.1.0 i686-w64-mingw32 （可能根據你所安裝的 MinGW 版本不同而有所不同）；

3. 點選 build 開始編譯 NanoMQ。

![圖片9.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/14ea7f73290e40a1808864417c7b3f89~tplv-k3u1fbpfcp-watermark.image?)

### 執行測試

除了 NanoMQ 自帶的客戶端工具，還可以使用 [開源 MQTT 測試客戶端工具 MQTT X](https://mqttx.app/zh) 來進行基礎的訊息收發測試。

MQTT X 下載地址：https://www.emqx.com/zh/try?product=MQTTX

![圖片10.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/906b073f67b645498f3f0d14039293d0~tplv-k3u1fbpfcp-watermark.image?)

從 MQTTX 可以看到訊息能夠透過 NanoMQ 進行正常收發。

## 結語

至此，我們已經成功在 Windows 平臺搭建了完整的 MQTT Broker，為廣大 Windows 生態使用者和其他無法使用 Linux 環境的場景提供了一個輕量且效能強大功能齊全的 MQTT 訊息伺服器。後續我們還將進一步介紹如何在 Windows 上使用 NanoMQ 的規則引擎和 WebHook 等更多高階功能。

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

在 Windows 上搭建 MQTT 訊息伺服器

相關文章