Mosquitto 是一個小型輕量的開源 MQTT 伺服器，由 C/C++ 語言編寫，採用單核心單執行緒架構，支援部署在資源有限的嵌入式裝置，接入少量 MQTT 裝置終端，並實現了 [MQTT 5.0](https://www.emqx.com/zh/mqtt/mqtt5) 和 3.1.1版本協議。Mosquitto 完整支援了 [MQTT 協議](https://www.emqx.com/zh/mqtt) 特性，但基礎功能上 Mosquitto 叢集功能羸弱，官方和第三方實現的叢集方案均難以支撐物聯網大規模海量連線的效能需求。

因此 Mosquitto 並不適合用來做規模化服務的 MQTT 伺服器，但由於其足夠輕量精簡，可以執行在任何低功率微控制器包括嵌入式感測器、手機裝置、嵌入式微處理器上，是物聯網邊緣訊息接入較好的技術選型之一，結合其橋接功能可以實現訊息的本地處理與雲端透傳。

EMQX 是一款大規模分散式物聯網 MQTT 訊息伺服器，可以高效可靠連線海量物聯網裝置，實時處理分發訊息與事件流資料。EMQX 節點可以被其他型別的 [MQTT 伺服器](https://www.emqx.com/zh/products/emqx) 和 [MQTT 雲服務](https://www.emqx.com/zh/cloud)橋接，實現跨平臺的訊息訂閱和傳送。本文我們將以一個配置例項來演示如何橋接 Mosquitto MQTT 訊息至 EMQX。

## 場景描述

假設我們有一個 EMQX 伺服器叢集 `emqx1`，和一臺 Mosquitto 伺服器，我們需要在 Mosquitto 上建立一條橋接，把所有感測器主題 `sensor/#` 訊息轉發至 `emqx1` 叢集，並從 EMQX 訂閱所有控制主題 `control/#`。

[![橋接 Mosquitto](http://img.blog.itpub.net/blog/2022/09/13/b7ec69cf7db3dbc6.jpeg?x-oss-process=style/bb "橋接 Mosquitto")](https://www.emqx.com/zh/blog/bridging-mosquitto-to-emqx-cluster "橋接 Mosquitto")

**EMQX**

得益於 EMQX 標準的 MQTT 協議支援，Mosquitto 可以橋接至任意版本的 EMQX，此處使用 [EMQX Cloud](https://www.emqx.com/zh/cloud) 提供的 [免費的線上 MQTT 伺服器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker) 進行測試：

[![](http://img.blog.itpub.net/blog/2022/09/13/17ca0eecea6e9f7c.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/bridging-mosquitto-to-emqx-cluster)

**Mosquitto**

本文使用的 Mosquitto 版本為 2.0.14，下載安裝方式詳見 [Mosquitto Download](https://mosquitto.org/download/)：

[![](http://img.blog.itpub.net/blog/2022/09/13/4a912baf449c44a9.png?x-oss-process=style/bb)](https://www.emqx.com/zh/blog/bridging-mosquitto-to-emqx-cluster)

## 簡單的 Mosquitto MQTT 橋接示例

配置 Mosquitto 的橋接需要在安裝後修改 `mosquitto.conf` 檔案，對於每一個橋接，需要配置的基本內容有：

- 遠端的 EMQX 伺服器的地址和埠
- MQTT 協議引數，如協議版本，keepalive, clean_session等（如不配置則使用預設值）
- EMQX 需要的客戶端登入資訊
- 需要橋接的訊息的主題
- 配置橋接主題對映（預設無對映）

以下是最終的配置檔案，下文會詳細講解每個部分配置的釋義：

```apache
connection emqx1
address broker.emqx.io:1883
bridge_protocol_version mqttv50
remote_clientid emqx_c
remote_username emqx_u
remote_password public
topic sensor/# out 1
topic control/# in 1
```

#### 新建 MQTT 橋接

開啟 `mosquitto.conf` 檔案，在配置檔案末尾增加一個 MQTT 橋接配置，使用 emqx1 作為 connection 名稱：

```nginx
connection emqx1
```

#### 配置橋接遠端節點的地址和埠

```stylus
address broker.emqx.io:1883
```

#### 配置 MQTT 協議版本

Mosquitto 橋接使用的 MQTT 協議版本預設為 3.1.1，EMQX 完整支援 MQTT 5.0 特性，此處使用 MQTT 5.0 版本進行橋接：

```jboss-cli
bridge_protocol_version mqttv50
```

#### 配置遠端節點客戶端 ID

```basic
remote_clientid emqx_c
```

#### 配置遠端節點使用者名稱

```basic
remote_username emqx_u
```

#### 配置遠端節點密碼

```basic
remote_password public
```

#### 指定需要橋接的 MQTT 主題

橋接主題的配置格式為 `topic <topic> [[[out | in | both] qos-level] local-prefix remote-prefix]`，它定義了橋接轉發和接收的規則，其中：

- `<topic>`指定了需要橋接的主題，支援萬用字元
- 方向可以是 out, in 或者 both
  - out: 將本地主題資料傳送到遠端 Broker
  - in: 訂閱遠端 Broker 的主題，將資料釋出到本地
  - both: 在同一個主題上進行雙向橋接
- `qos-level`為橋接的 QoS 級別， 如不指定則使用被轉發訊息原 QoS
- `local-prefix` 與 `remote-prefix` 對應本地和遠端字首，用於主題對映時在轉發和接收的訊息主題上加上相應字首，以便應用可以識別訊息來源。

對應本文場景可以新增以下兩條橋接規則：

```nginx
topic sensor/# out 1
topic control/# in 1
```

在配置完成後，需要重新啟動 Mosquitto 使 MQTT 橋接配置生效。

## 配置 EMQX 伺服器

使用公共伺服器時不需要配置任何引數。實際應用中，為了使 Mosquitto MQTT 訊息橋接成功，需要視使用者 EMQX 的安全配置情況決定是否配置相應的客戶端[認證](https://www.emqx.io/docs/zh/v5.0/security/authn/authn.html)和[授權](https://www.emqx.io/docs/zh/v5.0/security/authz/authz.html)資訊。

## 測試配置

我們可以使用 [MQTT 客戶端工具](https://www.emqx.com/zh/blog/mqtt-client-tools)來測試 MQTT 橋接的配置是否成功，此處使用的是 [MQTT X CLI](https://mqttx.app/zh/cli)，一款由 EMQ 開發的強大而易用的 MQTT 5.0 命令列工具。

### 測試橋接的 out 方向

在遠端 EMQX 上訂閱 `sensor/#`主題，等待接收 Mosquitto 橋接上報的資料：

```lua
mqttx sub -t "sensor/#" -h broker.emqx.io
```

在本地 Mosquitto 的 `sensor/1/temperature` 主題上釋出訊息，該訊息將在 Mosquitto 中釋出，同時橋接至遠端 EMQX：

```apache
mqttx pub -t "sensor/1/temperature" -m "37.5" -q 1
```

此時遠端 EMQX 應當能收到 Mosquitto 橋接上報的訊息：

```apache
payload:  37.5
```

### 測試橋接的 in 方向

在本地 Mosquitto上訂閱 `control/#` 主題，該主題將接收到遠端 EMQX 上釋出的訊息：

```armasm
mqttx sub -t "control/#"
```

在遠端 EMQX 的 `control/t/1` 主題上釋出訊息，訊息將在 EMQX 叢集中傳遞，同時橋接到 Mosquitto 本地：

```stylus
mqttx pub -t "control/t/1" -m "I'm EMQX" -h broker.emqx.io
```

此時在 Mosquitto 上應能收到該訊息：

```vbnet
payload:  I'm EMQX
```

除了 Mosquitto 外，由 EMQ 開源的[超輕量級 MQTT 訊息伺服器 NanoMQ](https://nanomq.io/zh) 同樣適用於物聯網邊緣接入場景，我們將在後續的文章中帶來橋接 NanoMQ 訊息至 EMQX 的教程。

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/bridging-mosquitto-to-emqx-cluster](https://www.emqx.com/zh/blog/bridging-mosquitto-to-emqx-cluster)</topic></topic>

橋接 Mosquitto MQTT 訊息至 EMQX

相關文章