7 月，NanoMQ 繼續保持穩步更新。v0.10.0 於 8 月初正式釋出（https://github.com/emqx/nanomq/releases/tag/0.10.1 ）。此版本主要增強了橋接功能，新增了釋出訊息的 HTTP API。同時還為 NanoSDK 增加了 MQTT 5.0 支援。各項效能最佳化和缺陷修復也在持續進行中。

## 橋接功能更新

橋接功能在 0.10 版本得到了重大更新，增加了多路橋接、AWS IoT Core 內建橋接等功能。這些更新同時也影響了配置檔案的格式，v0.10 與 v0.9.0 之前的橋接配置檔案（nanomq_bridge.conf）不再相容，使用者升級時需要注意更新配置檔案格式。

### 多路 MQTT 橋接配置

在物聯網領域，異構計算和計算解除安裝是常見的場景，端側各類無線感測網路的資料往往需要與多個雲端同步或被多個應用重複消費。[MQTT broker](https://www.emqx.com/zh/mqtt/public-mqtt5-broker) 是解決資料流可重用需求的捷徑，而 NanoMQ 作為主要針對邊緣計算場景的訊息服務，多雲橋接也是使用者普遍需要的功能。在 v0.9.0 之前，NanoMQ 的 MQTT 橋接只支援單一目標。多路 MQTT 橋接經過測試驗證後在 0.10 版本正式推出，能夠支援使用者透過自定義橋接命名來讓 NanoMQ 同時與多個遠端 MQTT 服務進行實時資料同步。

[![多路 MQTT 橋接](http://img.blog.itpub.net/blog/2022/08/04/3d60e36dc037b89b.png?x-oss-process=style/bb "多路 MQTT 橋接")](https://www.emqx.com/zh/blog/nanomq-newsletter-202207 "多路 MQTT 橋接")

比如我們想要讓 NanoMQ 將特定主題（msg1/#, msg2/#）的訊息都同步到雲端，同時從雲端的主題（cmd/topic1）收取訊息並轉發給本地的裝置。簡單配置示例如下：

```ini
## Take EMQX & EMQX cloud as example ##
## 以同時橋接到 EMQX 公共伺服器和 EMQX Cloud 為例，配置橋接URL ##
bridge.mqtt.emqx.address=mqtt-tcp://broker.emqx.io:1883
bridge.mqtt.cloud.address=mqtt-tcp://emqx.cloud:1883

## 設定橋接的MQTT協議版本，可選MQTT V4和MQTT V5 ##
bridge.mqtt.emqx.proto_ver=4
bridge.mqtt.cloud.proto_ver=4

## 開啟橋接狀態 ##
bridge.mqtt.emqx.bridge_mode=true
bridge.mqtt.cloud.bridge_mode=true

## 設定橋接客戶端的Client ID ##
bridge.mqtt.emqx.clientid=bridge_client
bridge.mqtt.cloud.clientid=bridge_client

## 設定橋接客戶端的心跳間隔 ##
bridge.mqtt.emqx.keepalive=60
bridge.mqtt.cloud.keepalive=60

## 設定需要上行同步資料的主題 ##
bridge.mqtt.emqx.forwards=msg1/#,msg2/#
bridge.mqtt.cloud.forwards=msg1/#,msg2/#

## 設定需要下行同步資料的主題 ##
bridge.mqtt.emqx.subscription.1.topic=cmd/topic1
bridge.mqtt.cloud.subscription.1.topic=cmd/topic1
```

之後啟動 NanoMQ，就會根據配置的遠端 MQTT 服務的 URL 來自動啟動橋接通道，並管理和監控連線健康狀態和同步資料。

特別提醒：增加了多路橋接功能後的版本使用不同格式的橋接配置檔案，所以 v0.10 不再和 v0.9.0 之前的 nanomq_bridge.conf 相容。

### AWS Bridge

AWS IoT Core 是在歐美廣泛使用的公有云 IoT 服務之一。但由於其與標準 MQTT 連線多有不同，且不支援 QoS 2 通訊質量，讓許多使用標準 MQTT SDK 的客戶端裝置難以連線和享受出海服務。

NanoMQ 0.10 版本增加了內建 AWS 橋接功能來解決這一問題。**NanoMQ** 負責將接收到的指定 *topic* 的資料轉發到遠端 **AWS IoT MQTT Broker**，並從 **AWS IoT MQTT Broker** 訂閱指定 *topic*。

使用此內建橋接功能需要預設環境裡已經安裝了 AWS 的 IoT SDK：

#### 安裝AWS SDK

```awk
## 下載原始碼
wget https://github.com/aws/aws-iot-device-sdk-embedded-C/releases/download/202108.00/aws-iot-device-sdk-embedded-C-202108.00.zip

## 解壓
unzip aws-iot-device-sdk-embedded-C-202108.00.zip

## 編譯
cd aws-iot-device-sdk-embedded-C
mkdir build
cmake -G Ninja -DBUILD_DEMOS=OFF -DCMAKE_C_STANDARD=99 -DINSTALL_TO_SYSTEM=ON ..
ninja

## 安裝到系統
sudo ninja install 
sudo cp ../demos/logging-stack/logging_*.h  /usr/local/include/aws/
sudo ldconfig
```

然後配置 NanoMQ 預設路徑下的配置檔案/etc/nanomq_aws_bridge.conf，或透過命令列啟動 NanoMQ 時指定配置檔案 nanomq start --bridge <nanomq_aws_bridge.conf>

#### 配置引數

- 橋接模式開關(預設false關閉)

```ini
  bridge.mqtt.aws.bridge_mode=true
  ```

- AWS IoT Core Endpoint 地址

```stylus
  bridge.mqtt.aws.host=a2zegtl0x5owup-ats.iot.us-west-2.amazonaws.com
  bridge.mqtt.aws.port=8883
  ```

- MQTT 協議版本

```ini
  bridge.mqtt.aws.proto_ver=4
  ```

- 轉發 Topic (多個 topic 用逗號,隔開)

```ini
  bridge.mqtt.aws.forwards=topic_1,topic_2
  ```

- 訂閱 Topic

```stylus
  bridge.mqtt.aws.subscription.1.topic=cmd/topic1
  bridge.mqtt.aws.subscription.1.qos=1
  ...
  bridge.mqtt.aws.subscription.{n}.topic=cmd/topicn
  bridge.mqtt.aws.subscription.{n}.qos=1
  ```

NanoMQ 就能夠與 AWS IoT Core 建立橋接，進行資料同步。

由於 AWS 的 C 嵌入式 SDK 不支援跨平臺，所以目前此功能並未打包進二進位制安裝包中。需要使用 AWS 橋接的使用者需透過以下命令自行編譯安裝 NanoMQ 的 AWS IoT Core 橋接功能。

```cmake
cmake -G Ninja .. -DENABLE_AWS_BRIDGE=ON

sudo ninja install
```

## 新增 HTTP API

MQTT 是基於非同步模式設計的訊息協議，但在許多場景裡仍然會和許多第三方應用透過 HTTP REST API 互動，這就需要 MQTT 服務能夠同時相容支援並轉換非同步和同步模式。所以 NanoMQ 在 0.10 版本響應使用者的呼聲也加入了支援透過 HTTP API 進行釋出訊息的功能。

簡單的使用方式示例如下：

#### HTTP 釋出訊息

/api/v4/mqtt/publish

```applescript
$ curl -i --basic -u admin:public -X POST "http://localhost:8081/api/v4/mqtt/publish" -d \
'{"topic":"a/b/c", "payload":"Hello World", "qos":1, "retain":false, "clientid":"example"}}'

## NanoMQ回覆：
{"code":0}
```

#### HTTP 批次釋出訊息

/api/v4/mqtt/publish_batch

```capnproto
$ curl -i --basic -u admin:public -X POST "http://localhost:8081/api/v4/mqtt/publish_batch" -d '[{"topic":"a/b/c","payload":"Hello World","qos":1,"retain":false,"clientid":"example"},{"topic":"a/b/c","payload":"Hello World Again","qos":0,"retain":false,"clientid":"example"}]'

## NanoMQ回覆：
{"data":[{"topic":"a/b/c","code":0},{"topic":"a/b/c","code":0}],"code":0}
```

## NanoSDK 支援 MQTT 5.0

NanoSDK 在此前支援了以 QUIC 作為 MQTT 傳輸層來解決弱網環境和網路切換等問題。

7 月中，此專案得到了重大更新：新發布的 NanoSDK 0.7.0 版本支援 MQTT 5.0，並增加更多針對 MQTT 使用者的高度封裝 API。目前 NanoSDK 已經能夠支援 MQTT 5.0 協議的大部分功能特性。

## NanoMQ 命令列工具分離

NanoMQ 0.10 還有一個改動需要使用者注意，此版本開始將原有的命令列工具箱與 MQTT Broker 服務分離，從不同的命令入口啟動。

原 NanoMQ 啟動命令：

```clean
## NanoMQ Broker：
nanomq broker start
## NanoMQ 客戶端：
nanomq pub --url "mqtt-tcp://broker.emqx.io:1883" -t topic -m hello
```

0.10 版本後的啟動命令：

```clean
## NanoMQ Broker：
nanomq start
## NanoMQ 客戶端：
nanomq_cli pub --url "mqtt-tcp://broker.emqx.io:1883" -t topic -m hello
```

## 即將到來 ：MQTT 5.0 + MQTT over QUIC 橋接

得益於 NanoSDK 對 MQTT 5.0 和 QUIC 傳輸層的支援，NanoMQ 的橋接功能即將在 0.11 版本得到重大升級。使用者將能夠選擇 MQTT 5.0 版本進行橋接，或者使用 QUIC 作為橋接連線的傳輸層，從而為無法整合 QUIC SDK 或者沒有合適 MQTT over QUIC SDK 選擇的本地端側裝置提供傳輸層轉換，以配合 EMQX 5.0 發揮 QUIC 在弱網環境下的優勢。

關於 QUIC 的詳解請參考: [MQTT over QUIC：物聯網訊息傳輸還有更多可能](https://www.emqx.com/zh/blog/mqtt-over-quic)

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/nanomq-newsletter-202207](https://www.emqx.com/zh/blog/nanomq-newsletter-202207)</nanomq_aws_bridge.conf>

NanoMQ Newsletter 2022-07｜v0.10：多路橋接、NanoSDK 支援 MQTT 5.0

相關文章