本地调试控制台

（可选）要在开发计算机上查看本地调试控制台，可以通过 SSH 转发控制台端口。但是，您必须先在核心设备的 SSH 配置文件中启用 AllowTcpForwarding 选项。默认情况下，此选项处于启用状态。在开发计算机上运行以下命令，即可在开发计算机上查看 localhost:1441 控制面板。

ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address

创建会话以使用本地调试控制台。创建会话时，会生成用于身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。如果您在组件配置中启用 HTTPS，则本地调试控制台还会创建证书来保证安全连接。HTTPS 默认处于启用状态。

使用 C Amazon IoT Greengrass LI 创建会话。此命令会生成一个含 43 个字符的随机密码，该密码将在 8 小时后过期。将/greengrass/v2或C:\greengrass\v2替换为 Amazon IoT Greengrass V2 根文件夹的路径。

如果您已将本地调试控制台配置为使用 HTTPS，则命令输出如下所示。打开本地调试控制台时，您可以使用证书指纹来验证连接是否安全。

Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password expires at: 2021-04-01T17:01:43.921999931-07:00
The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1

调试视图组件会创建一个持续 8 小时的会话。之后，您必须生成新的密码以再次查看本地调试控制台。

打开并登录控制台。在 Greengrass 核心设备上查看控制面板，如果您通过 SSH 转发端口，则可以在开发计算机上查看控制面板。请执行以下操作之一：

• 如果您在本地调试控制台中启用了 HTTPS（默认设置），请执行以下操作：

  1. 在核心设备上打开 https://localhost:1441，如果通过 SSH 转发端口，则在开发计算机上打开。

     您的浏览器可能会显示有关安全证书无效的安全警告。

  2. 如果您的浏览器显示安全警告，请验证证书是否合法并绕过安全警告。执行以下操作：

     1. 找到证书的 SHA-256 或 SHA-1 指纹，并验证它是否与 get-debug-password 命令之前打印的 SHA-256 或 SHA-1 指纹相匹配。您的浏览器可能会提供其中一个或两个指纹。要查看证书及其指纹，请查阅浏览器的文档。在某些浏览器中，证书指纹被称为拇指指纹。

        注意

        如果证书指纹不匹配，请转至 步骤 2 创建新会话。如果证书指纹仍然不匹配，则您的连接可能不安全。

     2. 如果证书指纹匹配，请绕过浏览器的安全警告，打开本地调试控制台。请查阅浏览器的文档以绕过浏览器安全警告。

  3. 使用 get-debug-password 命令之前打印的用户名和密码登录网站。

     本地调试控制台打开。

  4. 如果本地调试控制台显示错误提示由于 TLS 握手失败 WebSocket 而无法连接，则必须绕过该 URL 的自签名安全警告。 WebSocket

     

     执行以下操作：

     1. 在打开本地调试控制台的同一浏览器中打开 https://localhost:1442。

     2. 验证证书并绕过安全警告。

        绕过警告后，您的浏览器可能会显示 HTTP 404 页面。

     3. 再次打开 https://localhost:1441。

        本地调试控制台会显示有关核心设备的信息。

• 如果您在本地调试控制台中禁用了 HTTPS，请执行以下操作：

  1. 在核心设备上打开 http://localhost:1441，如果通过 SSH 转发端口，则在开发计算机上打开。

  2. 使用 get-debug-password 命令之前打印的用户名和密码登录网站。

     本地调试控制台打开。

（可选）要在开发计算机上查看本地调试控制台，可以通过 SSH 转发控制台端口。但是，您必须先在核心设备的 SSH 配置文件中启用 AllowTcpForwarding 选项。默认情况下，此选项处于启用状态。在开发计算机上运行以下命令，即可在开发计算机上查看 localhost:1441 控制面板。

ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address

创建会话以使用本地调试控制台。创建会话时，会生成用于身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。

使用 C Amazon IoT Greengrass LI 创建会话。此命令会生成一个含 43 个字符的随机密码，该密码将在 8 小时后过期。将/greengrass/v2或C:\greengrass\v2替换为 Amazon IoT Greengrass V2 根文件夹的路径。

该命令输出如以下示例所示。

Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password will expire at: 2021-04-01T17:01:43.921999931-07:00

调试视图组件会创建一个持续 4 小时的会话，然后您必须生成新密码才能再次查看本地调试控制台。

在核心设备上打开 http://localhost:1441，如果通过 SSH 转发端口，则在开发计算机上打开。

使用 get-debug-password 命令之前打印的用户名和密码登录网站。

本地调试控制台打开。