本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # MQTT 3.1.1 代理程式 (Moquette) Moquette MQTT 3.1.1 代理程式 2.3.6 版已發行[https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) Moquette MQTT 3.1.1 代理程式元件 v2.3.6 已推出。此版本包含一般錯誤修正和改善。Moquette MQTT 3.1.1 代理程式 2.3.5 版已發行[https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) Moquette MQTT 3.1.1 代理程式元件 v2.3.5 已推出。此版本將 Moquette 更新至 0.17 版。Moquette MQTT 3.1.1 代理程式 2.3.4 版已發行[https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) Moquette MQTT 3.1.1 代理程式元件 v2.3.4 已推出。 Moquette MQTT 代理程式元件 (`aws.greengrass.clientdevices.mqtt.Moquette`) 會處理用戶端裝置和 Greengrass 核心裝置之間的 MQTT 訊息。此元件提供修改版本的 [Moquette MQTT 代理程式](https://github.com/moquette-io/moquette)。部署此 MQTT 代理程式以執行輕量型 MQTT 代理程式。如需如何選擇 MQTT 代理程式的詳細資訊，請參閱 [選擇 MQTT 代理程式](choose-local-mqtt-broker.md)。此代理程式實作 MQTT 3.1.1 通訊協定。它包含對 QoS 0、QoS 1、QoS 2 保留訊息、最後遺囑訊息和持久性工作階段的支援。 **注意** 用戶端裝置是連線至 Greengrass 核心裝置的本機 IoT 裝置，用於傳送 MQTT 訊息和要處理的資料。如需詳細資訊，請參閱[與本機 IoT 裝置互動](interact-with-local-iot-devices.md)。 **Topics** + [ ## 版本 ](#mqtt-broker-moquette-component-versions) + [ ## 類型 ](#mqtt-broker-moquette-component-type) + [ ## 作業系統 ](#mqtt-broker-moquette-component-os-support) + [ ## 要求 ](#mqtt-broker-moquette-component-requirements) + [ ## 相依性 ](#mqtt-broker-moquette-component-dependencies) + [ ## Configuration ](#mqtt-broker-moquette-component-configuration) + [ ## 本機日誌檔案 ](#mqtt-broker-moquette-component-log-file) + [ ## 變更記錄 ](#mqtt-broker-moquette-component-changelog) ## 版本此元件具有下列版本： + 2.3.x 版本 + 2.2.x 版本 + 2.1.x + 2.0.x ## 類型此元件是外掛程式元件 (`aws.greengrass.plugin`)。[Greengrass 核心](greengrass-nucleus-component.md)會在與核心相同的 Java 虛擬機器 (JVM) 中執行此元件。當您在核心裝置上變更此元件的版本時，核心會重新啟動。此元件使用與 Greengrass 核相同的日誌檔案。如需詳細資訊，請參閱[監控 AWS IoT Greengrass 日誌](monitor-logs.md)。如需詳細資訊，請參閱[元件類型](develop-greengrass-components.md#component-types)。 ## 作業系統此元件可以安裝在執行下列作業系統的核心裝置上： + Linux + Windows ## 要求此元件有下列需求： + 核心裝置必須能夠在 MQTT 中介裝置操作的連接埠上接受連線。此元件預設會在連接埠 8883 上執行 MQTT 代理程式。您可以在設定此元件時指定不同的連接埠。如果您指定不同的連接埠，並使用 [MQTT 橋接器元件](mqtt-bridge-component.md)將 MQTT 訊息轉送至其他代理程式，則必須使用 MQTT 橋接器 v2.1.0 或更新版本。將其設定為使用 MQTT 中介裝置操作所在的連接埠。如果您指定不同的連接埠，並使用 [IP 偵測器元件](ip-detector-component.md)來管理 MQTT 代理程式端點，則必須使用 IP 偵測器 v2.1.0 或更新版本。將其設定為報告 MQTT 中介裝置操作所在的連接埠。 + 支援在 VPC 中執行 Moquette MQTT 代理程式元件。 ## 相依性當您部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件[發行版本的](#mqtt-broker-moquette-component-changelog)相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在 [AWS IoT Greengrass 主控台](https://console.aws.amazon.com//greengrass)中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找**相依性**清單。 ------ #### [ 2.3.7 ] 下表列出此元件 2.3.7 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.2.0 <2.6.0 | 硬式 | ------ #### [ 2.3.2 – 2.3.6 ] 下表列出此元件 2.3.2 至 2.3.6 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.2.0 <2.5.0 | 硬式 | ------ #### [ 2.3.0 and 2.3.1 ] 下表列出此元件 2.3.0 和 2.3.1 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.2.0 <2.4.0 | 硬式 | ------ #### [ 2.2.0 ] 下表列出此元件 2.2.0 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.2.0 <2.3.0 | 硬式 | ------ #### [ 2.1.0 ] 下表列出此元件 2.1.0 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.0.0 <2.2.0 | 硬式 | ------ #### [ 2.0.0 - 2.0.2 ] 下表列出此元件 2.0.0 到 2.0.2 版的相依性。 | 相依性 | 相容版本 | 相依性類型 | | --- | --- | --- | | [用戶端裝置身分驗證](client-device-auth-component.md) | >=2.0.0 <2.1.0 | 硬式 | ------ 如需元件相依性的詳細資訊，請參閱[元件配方參考](component-recipe-reference.md#recipe-reference-component-dependencies)。 ## Configuration 此元件提供下列組態參數，您可以在部署元件時自訂這些參數。 `moquette` （選用）要使用的 [Moquette MQTT 代理程式](https://github.com/moquette-io/moquette)組態。您可以在此元件中設定 Moqeutte 組態選項的子集。如需詳細資訊，請參閱 [Moquette 組態檔案中](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf)的內嵌註解。此物件包含下列資訊： `ssl_port` （選用） MQTT 中介裝置操作所在的連接埠。如果您指定不同的連接埠，並使用 [MQTT 橋接器元件](mqtt-bridge-component.md)將 MQTT 訊息轉送至其他代理程式，則必須使用 MQTT 橋接器 v2.1.0 或更新版本。將其設定為使用 MQTT 中介裝置操作所在的連接埠。如果您指定不同的連接埠，並使用 [IP 偵測器元件](ip-detector-component.md)來管理 MQTT 代理程式端點，則必須使用 IP 偵測器 v2.1.0 或更新版本。將其設定為報告 MQTT 中介裝置操作所在的連接埠。預設：`8883` `host` （選用） MQTT 中介裝置繫結的界面。例如，您可以變更此參數，以便 MQTT 代理程式僅繫結至特定本機網路。預設：`0.0.0.0`（繫結至所有網路介面） startupTimeoutSeconds （選用）元件啟動的時間上限，以秒為單位。`BROKEN` 如果元件超過此逾時，元件的狀態會變更為。預設：`120` **Example 範例：組態合併更新** 下列範例組態指定在連接埠 443 上操作 MQTT 代理程式。 ``` { "moquette": { "ssl_port": "443" } } ``` ## 本機日誌檔案此元件使用與 [Greengrass 核](greengrass-nucleus-component.md)元件相同的日誌檔案。 ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.log ``` ------ **檢視此元件的日誌** + 在核心裝置上執行下列命令，以即時檢視此元件的日誌檔案。將 `/greengrass/v2`或 *C：\$1greengrass\$1v2* 取代為 AWS IoT Greengrass 根資料夾的路徑。 ------ #### [ Linux ] ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows (PowerShell) ] ``` Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait ``` ------ ## 變更記錄下表說明每個版本元件的變更。 | **版本** | **變更** | | --- | --- | | 2.3.7 | 針對[用戶端裝置驗證](client-device-auth-component.md) 2.5.0 版更新版本。 | | 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.2 | 針對[用戶端裝置驗證](client-device-auth-component.md) 2.4.0 版更新版本。 | | 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.3.0 | 新增憑證鏈的支援。 | | 2.2.0 | 針對[用戶端裝置驗證](client-device-auth-component.md) 2.2.0 版更新版本。 | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) | | 2.0.1 | 針對 Greengrass nucleus 2.4.0 版更新版本。 | | 2.0.0 | 初始版本。 |