

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將 IPv6 用於本機傳訊
<a name="use-ipv6"></a>

您可以設定 IP 偵測器元件使用 IPv6 傳送本機訊息。

**注意**  
您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用 IPv6 傳送本機訊息。

您可以部署 [IP 偵測器元件](ip-detector-component.md)來偵測和使用 IPv6 地址。您必須更新 IP 偵測器元件的組態，以使用 IPv6 而非 IPv4。如需詳細資訊，請參閱[使用 IP 偵測器自動管理端點](manage-core-device-endpoints.md#use-ip-detector)。

**Topics**
+ [設定 IP 偵測器以使用 IPv6](#configure-ip-detector-ipv6)

## 設定 IP 偵測器以使用 IPv6
<a name="configure-ip-detector-ipv6"></a>

如果您有簡單的網路設定，例如與核心裝置位於相同網路上的用戶端裝置，您可以部署 [IP 偵測器元件](ip-detector-component.md)以使用 IPv6 進行本機傳訊。

IP 偵測器元件會覆寫您手動設定的端點。

**重要**  
核心裝置的 AWS IoT 政策必須允許 使用 IP 偵測器元件的`greengrass:UpdateConnectivityInfo`許可。如需詳細資訊，請參閱[AWS IoT 資料平面操作的 政策](device-auth.md#iot-policies)及[設定 AWS IoT 物件政策](connect-client-devices.md#configure-iot-policy-requirement)。

您可以執行下列任一動作來部署 IP 偵測器元件：
+ 使用 主控台中的**設定探索**頁面。如需詳細資訊，請參閱[設定雲端探索 （主控台）](connect-client-devices.md#configure-cloud-discovery-console)。
+ 建立和修訂部署以包含 IP 偵測器。您可以使用 主控台 AWS CLI、 或 AWS API 來管理部署。如需詳細資訊，請參閱[建立部署](create-deployments.md)。

### 部署 IP 偵測器元件 （主控台）
<a name="deploy-ip-detector-console-ipv6"></a>

1. 在[AWS IoT Greengrass 主控台](https://console.aws.amazon.com/greengrass)導覽功能表中，選擇**元件**。

1. 在**元件**頁面上，選擇**公有元件**索引標籤，然後選擇 **aws.greengrass.clientdevices.IPDetector**。

1. 在 **aws.greengrass.clientdevices.IPDetector** 頁面中，選擇**部署**。

1. <a name="deploy-component-choose-deployment-step"></a>從**新增至部署**中，選擇要修改的現有部署，或選擇建立新的部署，然後選擇**下一步**。

1. <a name="deploy-component-choose-target-step"></a>如果您選擇建立新的部署，請選擇部署的目標核心裝置或物件群組。在**指定目標**頁面的**部署目標**下，選擇核心裝置或物件群組，然後選擇**下一步**。

1. 在**選取元件**頁面上，確認已選取**aws.greengrass.clientdevices.IPDetector**元件，選擇**下一步**。

1. 在**設定元件**頁面上，選取 **aws.greengrass.clientdevices.IPDetector**，然後執行下列動作：

   1. 選擇**設定元件**。

   1. 在**設定aws.greengrass.clientdevices.IPDetector**模態、**組態更新**下，**在要合併的組態中**，您可以輸入組態更新來設定 IP 偵測器元件。您可以指定下列任何組態選項。將 `includeIPv4Addrs` 設定為 `false`，將 `includeIPv6Addrs` 設定為 `true`。然後，您可以更新其他 IPv6 組態選項。
      + `defaultPort` – <a name="ip-detector-component-configuration-default-port-definition"></a>（選用） 此元件偵測到 IP 地址時要報告的 MQTT 代理程式連接埠。如果您將 MQTT 代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。
      + `includeIPv4LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv4 回送地址。這些是 IP 地址，例如 `localhost`，裝置可以自行通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。
      + `includeIPv4LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv4 [連結本機地址](https://en.wikipedia.org/wiki/Link-local_address)。如果核心裝置的網路沒有動態主機組態協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。
      + `includeIPv6LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv6 回送地址。這些是 IP 地址，例如 `localhost`，裝置可以自行通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。您必須將 `includeIPv4Addrs` 設定為 `false`，並將 `includeIPv6Addrs` 設定為 `true`，才能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
      + `includeIPv6LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv6 [連結本機地址](https://en.wikipedia.org/wiki/Link-local_address)。如果核心裝置的網路沒有動態主機組態協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。您必須將 `includeIPv4Addrs` 設定為 `false`，並將 `includeIPv6Addrs` 設定為 `true`，才能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
      + `includeIPv4Addrs` – <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>（選用） 預設值設為 true。您可以啟用此選項來發佈核心裝置上找到的 IPv4 地址。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
      + `includeIPv6Addrs` – <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>（選用） 您可以啟用此選項來發佈核心裝置上找到的 IPv6 地址。`includeIPv4Addrs`設定為 `false` 以使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。

      組態更新看起來可能會類似下列範例。

      ```
      {
        "defaultPort": "8883",
        "includeIPv4LoopbackAddrs": false,
        "includeIPv4LinkLocalAddrs": false,
        "includeIPv6LoopbackAddrs": true,
        "includeIPv6LinkLocalAddrs": true,
        "includeIPv4Addrs": false,
        "includeIPv6Addrs": true
      }
      ```

   1. 選擇**確認**以關閉模態，然後選擇**下一步**。

1. <a name="deploy-component-configure-advanced-settings-step"></a>在**設定進階設定**頁面上，保留預設組態設定，然後選擇 **下一步**。

1. <a name="deploy-component-review-and-deploy-step"></a>在 **Review (檢閱)** 頁面，選擇 **Deploy (部署)**。

   部署可能需要一分鐘的時間才能完成。

### 部署 IP 偵測器元件 (AWS CLI)
<a name="deploy-ip-detector-cli-ipv6"></a>

若要部署 IP 偵測器元件，請建立包含在 `components` 物件`aws.greengrass.clientdevices.IPDetector`中的部署文件，並指定元件的組態更新。遵循 中的指示[建立部署](create-deployments.md)建立新的部署或修改現有的部署。

您可以在建立部署文件時指定下列任一選項來設定 IP 偵測器元件：
+ `defaultPort` – <a name="ip-detector-component-configuration-default-port-definition"></a>（選用） 此元件偵測到 IP 地址時要報告的 MQTT 代理程式連接埠。如果您將 MQTT 代理程式設定為使用與預設連接埠 8883 不同的連接埠，則必須指定此參數。
+ `includeIPv4LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv4 回送地址。這些是 IP 地址，例如 `localhost`，裝置可以自行通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。
+ `includeIPv4LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv4 [連結本機地址](https://en.wikipedia.org/wiki/Link-local_address)。如果核心裝置的網路沒有動態主機組態協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。
+ `includeIPv6LoopbackAddrs` – <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv6 回送地址。這些是 IP 地址，例如 `localhost`，裝置可以自行通訊。在核心裝置和用戶端裝置在相同系統上執行的測試環境中使用此選項。您必須將 `includeIPv4Addrs` 設定為 `false`，並將 `includeIPv6Addrs` 設定為 `true`，才能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
+ `includeIPv6LinkLocalAddrs` – <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>（選用） 您可以啟用此選項來偵測和報告 IPv6 [連結本機地址](https://en.wikipedia.org/wiki/Link-local_address)。如果核心裝置的網路沒有動態主機組態協定 (DHCP) 或靜態指派的 IP 地址，請使用此選項。您必須將 `includeIPv4Addrs` 設定為 `false`，並將 `includeIPv6Addrs` 設定為 `true`，才能使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
+ `includeIPv4Addrs` – <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>（選用） 預設值設為 true。您可以啟用此選項來發佈核心裝置上找到的 IPv4 地址。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。
+ `includeIPv6Addrs` – <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>（選用） 您可以啟用此選項來發佈核心裝置上找到的 IPv6 地址。`includeIPv4Addrs`設定為 `false` 以使用此選項。您必須擁有 IP 偵測器 v2.2.0 或更新版本，才能使用此選項。

下列範例部分部署文件指定 使用 IPv6。

```
{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}
```