检测主机是否为 EC2 实例

您可能需要了解您的应用程序或网站是否在 EC2 实例上运行，尤其是在您拥有混合计算环境的情况下。您可以使用以下选项之一确定您的应用程序或网站的主机是否为 EC2 实例。

Options

检查实例身份文档
检查系统 UUID
检查系统虚拟机生成标识符

检查实例身份文档

每个实例都有一个签名的实例身份文档，您可以通过加密方式验证该文档。您可以使用实例元数据服务（IMDS）查找这些文档。

有关更多信息，请参阅实例身份文档。

检查系统 UUID

您可以获取系统 UID 并查看 EC2 的 UID 开头的八位字节（在 Linux 中，这可能是小写的 ec2）。此方法速度快，但可能不准确，因为不是 EC2 实例的系统也有很小的几率使用以这些字符开头的 UUID。此外，某些版本的 SMBIOS 使用小端序格式，在 UUID 的开头不包含 EC2。对于使用 SMBIOS 2.4 for Windows 的 EC2 实例，或除 Amazon Linux（具有自己的 SMBIOS 实现）之外的 Linux 发行版，可能就是这种情况。

Linux 示例：从 DMI 获取 UUID（仅限 HVM AMI）

通过以下命令使用桌面管理界面 (DMI) 获取 UUID：


[ec2-user ~]$ sudo dmidecode --string system-uuid

在以下示例输出中，UUID 以“EC2”开头，表示该系统可能是 EC2 实例。


EC2E1916-9099-7CAF-FD21-012345ABCDEF

在以下示例输出中，UUID 以 little-endian 格式表示。


45E12AEC-DCD1-B213-94ED-012345ABCDEF

或者，对于在 Nitro 系统上构建的实例，您可以使用以下命令：


[ec2-user ~]$ cat /sys/devices/virtual/dmi/id/board_asset_tag

如果输出是实例 ID，如下面的示例输出所示，则说明系统是 EC2 实例：


i-0af01c0123456789a

Linux 示例：从管理程序获取 UUID（仅限 PV AMI）

使用以下命令从管理程序获取 UUID：


[ec2-user ~]$ cat /sys/hypervisor/uuid

在以下示例输出中，UUID 以“ec2”开头，表示该系统可能是 EC2 实例。


ec2e1916-9099-7caf-fd21-012345abcdef

Windows 示例：使用 WMI 或 Windows PowerShell 获取 UUID

使用如下 Windows Management Instrumentation 命令行 (WMIC)：


wmic path win32_computersystemproduct get uuid

或者，如果您使用 Windows PowerShell，则可使用 Get-WmiObject cmdlet，如下所示：


PS C:\> Get-WmiObject -query "select uuid from Win32_ComputerSystemProduct" | Select UUID

在以下示例输出中，UUID 以“EC2”开头，表示该系统可能是 EC2 实例。


EC2AE145-D1DC-13B2-94ED-012345ABCDEF

对于使用 SMBIOS 2.4 的实例，可能用 little-endian 格式表示 UUID，例如：


45E12AEC-DCD1-B213-94ED-012345ABCDEF

检查系统虚拟机生成标识符

虚拟机生成标识符由被解释为加密随机整数标识符的 128 位的唯一缓冲区组成。您可以检索虚拟机生成标识符来识别 Amazon Elastic Compute Cloud 实例。生成标识符通过 ACPI 表条目在实例的来宾操作系统中公开。如果您的计算机被克隆、复制或导入到 AWS，例如使用 VM Import/Export，该值将改变。

示例：从 Linux 中检索虚拟机生成标识符

您可以使用以下命令从运行 Linux 的实例中检索虚拟机生成标识符。

Amazon Linux 2

根据需要，使用以下命令更新现有软件包：
```
sudo yum update
```

如有必要，使用以下命令获取 busybox 软件包：


sudo curl https://www.rpmfind.net/linux/epel/next/8/Everything/x86_64/Packages/b/busybox-1.35.0-2.el8.next.x86_64.rpm --output busybox.rpm

如有必要，使用以下命令安装必备软件包：
```
sudo yum install busybox.rpm iasl -y
```

运行以下 iasl 命令从 ACPI 表中生成输出：


sudo iasl -p ./SSDT2 -d /sys/firmware/acpi/tables/SSDT2

运行以下命令以查看 iasl 命令的输出：


cat SSDT2.dsl

输出应该产生检索虚拟机生成标识符所需的地址空间：


Intel ACPI Component Architecture
ASL+ Optimizing Compiler/Disassembler version 20190509
Copyright (c) 2000 - 2019 Intel Corporation

File appears to be binary: found 32 non-ASCII characters, disassembling
Binary file appears to be a valid ACPI table, disassembling
Input file /sys/firmware/acpi/tables/SSDT2, Length 0x7B (123) bytes
ACPI: SSDT 0x0000000000000000 00007B (v01 AMAZON AMZNSSDT 00000001 AMZN 00000001)
Pass 1 parse of [SSDT]
Pass 2 parse of [SSDT]
Parsing Deferred Opcodes (Methods/Buffers/Packages/Regions)

Parsing completed
Disassembly completed
ASL Output:    ./SSDT2.dsl - 1065 bytes
$
/*
* Intel ACPI Component Architecture
* AML/ASL+ Disassembler version 20190509 (64-bit version)
* Copyright (c) 2000 - 2019 Intel Corporation
*
* Disassembling to symbolic ASL+ operators
*
* Disassembly of /sys/firmware/acpi/tables/SSDT2, Tue Mar 29 16:15:14 2022
*
* Original Table Header:
*     Signature        "SSDT"
*     Length           0x0000007B (123)
*     Revision         0x01
*     Checksum         0xB8
*     OEM ID           "AMAZON"
*     OEM Table ID     "AMZNSSDT"
*     OEM Revision     0x00000001 (1)
*     Compiler ID      "AMZN"
*     Compiler Version 0x00000001 (1)
*/
DefinitionBlock ("", "SSDT", 1, "AMAZON", "AMZNSSDT", 0x00000001)
{
Scope (\_SB)
{
    Device (VMGN)
    {
        Name (_CID, "VM_Gen_Counter")  // _CID: Compatible ID
        Name (_DDN, "VM_Gen_Counter")  // _DDN: DOS Device Name
        Name (_HID, "AMZN0000")  // _HID: Hardware ID
        Name (ADDR, Package (0x02)
        {
            0xFED01000,
            Zero
        })
    }
}
}

（可选）使用以下命令提升终端对剩余步骤的权限：
```
sudo -s
```
使用以下命令存储以前收集的地址空间：
```
VMGN_ADDR=0xFED01000
```

使用以下命令迭代地址空间并构建虚拟机生成标识符：


for offset in 0x0 0x4 0x8 0xc; do busybox devmem $(($VMGN_ADDR + $offset)) | sed 's/0x//' | sed -z '$ s/\n$//' >> vmgenid; done

使用以下命令从输出文件中检索虚拟机生成标识符：
```
cat vmgenid ; echo
```
您的输出应类似于以下内容：
```
EC2F335D979132C4165896753E72BD1C
```

Ubuntu

根据需要，使用以下命令更新现有软件包：
```
sudo apt update
```
如有必要，使用以下命令安装必备软件包：
```
sudo apt install busybox iasl -y
```

运行以下 iasl 命令从 ACPI 表中生成输出：


sudo iasl -p ./SSDT2 -d /sys/firmware/acpi/tables/SSDT2

运行以下命令以查看 iasl 命令的输出：


cat SSDT2.dsl

输出应该产生检索虚拟机生成标识符所需的地址空间：

Intel ACPI Component Architecture
ASL+ Optimizing Compiler/Disassembler version 20190509
Copyright (c) 2000 - 2019 Intel Corporation

File appears to be binary: found 32 non-ASCII characters, disassembling
Binary file appears to be a valid ACPI table, disassembling
Input file /sys/firmware/acpi/tables/SSDT2, Length 0x7B (123) bytes
ACPI: SSDT 0x0000000000000000 00007B (v01 AMAZON AMZNSSDT 00000001 AMZN 00000001)
Pass 1 parse of [SSDT]
Pass 2 parse of [SSDT]
Parsing Deferred Opcodes (Methods/Buffers/Packages/Regions)

Parsing completed
Disassembly completed
ASL Output:    ./SSDT2.dsl - 1065 bytes
$
/*
* Intel ACPI Component Architecture
* AML/ASL+ Disassembler version 20190509 (64-bit version)
* Copyright (c) 2000 - 2019 Intel Corporation
*
* Disassembling to symbolic ASL+ operators
*
* Disassembly of /sys/firmware/acpi/tables/SSDT2, Tue Mar 29 16:15:14 2022
*
* Original Table Header:
*     Signature        "SSDT"
*     Length           0x0000007B (123)
*     Revision         0x01
*     Checksum         0xB8
*     OEM ID           "AMAZON"
*     OEM Table ID     "AMZNSSDT"
*     OEM Revision     0x00000001 (1)
*     Compiler ID      "AMZN"
*     Compiler Version 0x00000001 (1)
*/
DefinitionBlock ("", "SSDT", 1, "AMAZON", "AMZNSSDT", 0x00000001)
{
Scope (\_SB)
{
    Device (VMGN)
    {
        Name (_CID, "VM_Gen_Counter")  // _CID: Compatible ID
        Name (_DDN, "VM_Gen_Counter")  // _DDN: DOS Device Name
        Name (_HID, "AMZN0000")  // _HID: Hardware ID
        Name (ADDR, Package (0x02)
        {
            0xFED01000,
            Zero
        })
    }
}
}

（可选）使用以下命令提升终端对剩余步骤的权限：
```
sudo -s
```
使用以下命令存储以前收集的地址空间：
```
VMGN_ADDR=0xFED01000
```

使用以下命令迭代地址空间并构建虚拟机生成标识符：


for offset in 0x0 0x4 0x8 0xc; do busybox devmem $(($VMGN_ADDR + $offset)) | sed 's/0x//' | sed -z '$ s/\n$//' >> vmgenid; done

使用以下命令从输出文件中检索虚拟机生成标识符：
```
cat vmgenid ; echo
```
您的输出应类似于以下内容：
```
EC2F335D979132C4165896753E72BD1C
```

示例：从 Windows 中检索虚拟机生成标识符

您可以创建示例应用程序以从运行 Windows 的实例中检索虚拟机生成标识符。有关更多信息，请参阅 Microsoft 文档中的获取虚拟机生成标识符。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

示例：AMI 启动索引值

实例身份文档