QEMU 机密虚拟机(Confidential Guest Support)架构与实战指南

原创2026-09-22 19:22:451,882 阅读
文章标签:虚拟化JIT编译操作系统硬件仿真嵌入式高性能计算

QEMU 机密虚拟机(Confidential Guest Support)架构与实战指南

传统虚拟化模型中,hypervisor(如 QEMU)对客户机内存与全部状态拥有完全访问权限,一旦 hypervisor 被攻破,其承载的所有客户机都将随之沦陷。为此,AMD、Intel、IBM 等厂商在硬件与固件层面提供了多种机制,让客户机至少在"免受恶意/被攻破的 hypervisor 窃取"方面获得保护——这类客户机被统称为 Secure Guests / Confidential Guests。QEMU 将这些机制统一抽象为 Confidential Guest Support(CGS),通过两个命令行参数即可启用。本文以 docs/system/confidential-guest-support.rst 为主干,结合 QEMU 源码(include/system/confidential-guest-support.h、target/i386/sev.c、qapi/qom.json 等)深入讲解 CGS 的启用方式、统一抽象模型,以及 AMD SEV/SEV-ES/SEV-SNP、Intel TDX、POWER PEF、s390x PV、AWS Nitro Enclaves 五大机制各自的原理与实操要点,读完即可上手运行各类机密虚拟机并理解其底层实现。

什么是 Confidential Guest Support

传统虚拟化中,hypervisor 对客户机内存及其他状态拥有完全访问权,因此被攻破的 hypervisor 可以攻破其任意客户机。不少平台在硬件/固件层面加入了保护机制,赋予客户机"至少部分地"抵御恶意 hypervisor 的能力——这在公有云等场景下尤为关键(例如租户不希望云平台管理员或遭入侵的 hypervisor 读取自己的明文数据)。

这些机制名称各异、工作模式不同,常被称作 Secure Guests 或 Confidential Guests。QEMU 使用 Confidential Guest Support(机密客户机支持) 这一术语,将其与"客户机安全"的其他方面(如防御来自其他客户机的攻击、来自网络的攻击)明确区分开。其核心威胁模型是:hypervisor 本身不可信,客户的机密性由硬件/固件保证。

在 QEMU 源码中,这一抽象由 include/system/confidential-guest-support.h 承载:

  • 顶层类型 TYPE_CONFIDENTIAL_GUEST_SUPPORT(字符串名 "confidential-guest-support"),所有机密机制对象(sev-guest、sev-snp-guest、tdx-guest、pef-guest、s390-pv-guest 等)都注册为该类型的子类(见 qapi/qom.json 中 object-types 枚举);
  • 基类结构 ConfidentialGuestSupport 包含 require_guest_memfd(要求机器用 guest_memfd 作为 RAM 后端)与 ready 标志。ready 是 CGS 初始化代码完成"潜在安全客户机可开始执行指令"前设置的自检标志——由于不同机制对初始化时机的依赖各不相同,QEMU 无法在通用 machine init 路径中统一配置 CGS,为避免"用户请求了安全特性却被静默忽略",QEMU 会在初始化后期检查该标志:若请求了 CGS 但 ready 未被置位,将直接 abort;
  • 类结构 ConfidentialGuestSupportClass 定义了一系列虚函数接口:kvm_init、kvm_reset、check_support(校验平台/配置是否支持,参数如 ConfidentialGuestPlatformType、平台版本、shared_gpa_boundary 共享内存边界等)、set_guest_state(按页面类型与 GPA 预置/测量客户机内存、设置 vCPU 初始状态,如 SEV-ES 的 vmcb_save_area)、set_guest_policy(设置客户机策略)、get_mem_map_entry(遍历系统内存映射)以及 can_rebuild_guest_state。

其中的枚举类型直观反映了机制差异,例如平台类型 CGS_PLATFORM_SEV / CGS_PLATFORM_SEV_ES / CGS_PLATFORM_SEV_SNP,页面类型 CGS_PAGE_TYPE_NORMAL / VMSA / ZERO / UNMEASURED / SECRETS / CPUID / REQUIRED_MEMORY。机器侧,MachineState 通过 cgs 字段持有该对象(见 include/hw/core/boards.h)。

运行一个机密客户机:两个核心命令行参数

要运行机密客户机,只需添加两个命令行参数:

  1. 使用 -object 创建一个"confidential guest support"对象,具体类型与参数随所选机制而定;
  2. 将机器参数 confidential-guest-support 设为第 1 步对象的 id。

以 AMD SEV 为例:

qemu-system-x86_64 \
    <other parameters> \
    -machine ...,confidential-guest-support=sev0 \
    -object sev-guest,id=sev0,cbitpos=47,reduced-phys-bits=1

要点说明:

  • -machine 参数中的 ... 表示原有机器参数(如 -machine q35,accel=kvm,...),只需在末尾追加 confidential-guest-support=<object-id>;
  • -object sev-guest,id=sev0,... 创建类型为 sev-guest 的 CGS 对象。SEV 场景下 cbitpos(C-bit 在页表项中的位置,AMD 平台通常为 47/51 等)与 reduced-phys-bits(启用加密后物理地址位数缩减量)是两个关键参数,其定义见 qapi/qom.json 中的 SevCommonProperties(sev-device、cbitpos、reduced-phys-bits、kernel-hashes、debug-swap)。

当前支持的机密机制一览

根据 docs/system/confidential-guest-support.rst,QEMU 当前支持的机密客户机机制包括:

机制 适用平台 对应 CGS 对象 详细文档
AMD Secure Encrypted Virtualization(SEV/SEV-ES/SEV-SNP) AMD x86 sev-guest / sev-snp-guest docs/system/i386/amd-memory-encryption.rst
Intel Trust Domain Extension(TDX) Intel x86 tdx-guest docs/system/i386/tdx.rst
POWER Protected Execution Facility(PEF) IBM POWER9/POWER10 pef-guest docs/system/ppc/pseries.rst 中的 PEF 章节
s390x Protected Virtualization(PV) IBM Z s390-pv-guest docs/system/s390x/protvirt.rst
AWS Nitro Enclaves AWS EC2(x86_64 / aarch64) 由 nitro 加速器 + nitro 机器类型承载 docs/system/nitro.rst

后续版本可能支持更多机制。从源码结构看,每新增一种机制,通常需要实现 ConfidentialGuestSupportClass 的一组回调(kvm_init/kvm_reset/set_guest_state/set_guest_policy 等)并在 qapi/qom.json 中登记新的对象类型与属性结构,机制间复用同一套 CGS 框架。

AMD SEV / SEV-ES / SEV-SNP

原理与密钥管理

SEV(Secure Encrypted Virtualization) 是 AMD 处理器上的特性,是 AMD-V 架构的扩展,支持在 KVM 管理下运行加密虚拟机。加密 VM 的页面(代码与数据)只有客户机自身才能解密,且每个加密 VM 关联一个唯一的加密密钥——若其他实体用不同密钥访问其数据,只会得到无法理解的乱码。

密钥管理由 AMD SOC 中独立的 AMD 安全处理器(AMD-SP) 负责。AMD-SP 内运行的固件提供命令支持完整的 VM 生命周期:启动(launch)、快照(snapshot)、迁移(migrate)与调试(debug)加密客户机。这些 SEV 命令通过 KVM_MEMORY_ENCRYPT_OP ioctl 下发。

SEV-ES(Encrypted State) 在 SEV 基础上进一步保护客户机寄存器状态。为允许 hypervisor 代客户机执行某些操作,架构上支持在特定 VMEXIT 发生前通知客户机操作系统,由客户机自行决定向 hypervisor 选择性共享信息以完成所请求的功能。

启动流程(SEV 与 SEV-ES)

启动加密客户机前必须先加密启动镜像(如 BIOS)。MEMORY_ENCRYPT_OP ioctl 提供四个命令完成该过程:

  • LAUNCH_START:首先调用,在固件内创建加密启动上下文。为此客户机所有者(Guest Owner)必须提供客户机策略(guest policy)、其公钥 DH 证书(PDH)与会话参数。这些输入应视为二进制 blob 原样传给 SEV 固件。其中客户机策略以明文传递,hypervisor 可以读取但不得修改——任何修改都会导致测量值(measurement)不符。策略是 4 字节数据结构,含若干标志位,用于限制运行中 SEV 客户机可执行的操作;
  • LAUNCH_UPDATE_DATA:使用 LAUNCH_START 创建的上下文加密内存区域,需要时可多次调用以加密不同内存区域,并在加密过程中同步计算内存内容的测量值;
  • LAUNCH_UPDATE_VMSA:仅 SEV-ES 客户机使用,加密所有 vCPU 的 VM 保存区(VMSA,即虚拟机寄存器状态),同样在加密过程中计算测量值;
  • LAUNCH_MEASURE:取回加密内存(SEV-ES 还包括加密 VMSA)的测量值。该测量值是内存/VMSA 内容的签名,可发给客户机所有者作为"内存与 VMSA 被固件正确加密"的证明。客户机所有者可先验证测量值,再提供机密信息;
  • LAUNCH_FINISH:完成客户机启动,销毁加密上下文。

这四个命令共同为 VM 生成新的内存加密密钥、加密启动镜像,并提供可用于启动成功证明(attestation)的测量值。LAUNCH_MEASURE 的实现可见 target/i386/sev.c 的 sev_launch_get_measure():先查询测量 blob 长度,再通过 KVM_SEV_LAUNCH_MEASURE ioctl 取回数据,base64 编码后保存(SEV-ES 场景会先调用 sev_launch_update_vmsa 测量所有 VMSA)。

通过 policy 属性启用 SEV-ES

客户机策略通过 policy 属性提供。默认策略值在 qapi/qom.json 中定义为 0x1;设置 bit 2("SEV-ES required") 即启动 SEV-ES 客户机(0x5):

# SEV 客户机
${QEMU} sev-guest,id=sev0,policy=0x1...

# SEV-ES 客户机(bit 2 置位)
${QEMU} sev-guest,id=sev0,policy=0x5...

DH 证书与会话参数通过 dh-cert-file 与 session-file 属性提供,用于与客户机所有者建立密码学会话、协商用于 attestation 的密钥:

${QEMU} sev-guest,id=sev0,dh-cert-file=<file1>,session-file=<file2>

完整启动命令行

启动 SEV 客户机:

${QEMU} \
    -machine ...,confidential-guest-support=sev0 \
    -object sev-guest,id=sev0,cbitpos=47,reduced-phys-bits=1

启动 SEV-ES 客户机(追加 policy=0x5):

${QEMU} \
    -machine ...,confidential-guest-support=sev0 \
    -object sev-guest,id=sev0,cbitpos=47,reduced-phys-bits=1,policy=0x5

SEV-ES 的已知限制

由于客户机寄存器状态已加密、VMM/hypervisor 无法更新,SEV-ES 客户机相比 SEV 有以下限制:

  • 不支持 SMM:SMM 需要更新客户机寄存器状态;
  • 不支持重启(reboot):系统复位需要更新客户机寄存器状态;
  • 需要内核态 irqchip(in-kernel irqchip):把管理 AP 启动的负担交给 hypervisor。

计算预期的客户机启动测量值(Guest Owner 侧验证)

要验证客户机启动测量值,Guest Owner 必须用与 AMD-SP 完全相同的方式计算它(SEV API 规范 6.5.1 节描述 AMD-SP 操作):

  1. GCTX.LD 最终确定,产生导入客户机的所有明文数据的哈希摘要;
  2. 启动测量值按如下公式计算:
HMAC(0x04 || API_MAJOR || API_MINOR || BUILD || GCTX.POLICY || GCTX.LD || MNONCE; GCTX.TIK)

其中 || 表示拼接。

各取值的获取方式:

  • API_MAJOR、API_MINOR、BUILD、GCTX.POLICY:通过 QMP 命令 query-sev 获取(返回 api-major、api-minor、build-id、policy 等字段,见 qapi/misc-i386.json);
  • MNONCE:query-sev-launch-measure 响应中 base64 解码后 data 字段的最后 16 字节(见 qapi/misc-i386.json 的 QMP 定义);
  • GCTX.LD:SHA256(firmware_blob || kernel_hashes_blob || vmsas_blob),其中:
    • firmware_blob:整个固件 flash 文件的内容(如 OVMF.fd)。注意必须构建无状态(stateless)固件、不使用 NVRAM 存储,因为 NVRAM 区域不在测量范围内,使用依赖 NVRAM 状态的固件是不安全的;
    • kernel_hashes_blob:若使用内核且开启 kernel-hashes=on,则为 PaddedSevHashTable 的内容(含零填充),该结构包含传给客户机的 kernel、initrd、cmdline 的哈希。PaddedSevHashTable 结构体定义于 target/i386/sev.c:SevHashTable 内含 GUID、长度与 cmdline/initrd/kernel 三个哈希条目,PaddedSevHashTable 将其按 16 字节对齐填充(源码中 QEMU_BUILD_BUG_ON(sizeof(PaddedSevHashTable) % 16 != 0) 保证对齐);
    • vmsas_blob:若启用 SEV-ES(policy & 0x4 != 0),为所有 vCPU VMSA 的拼接。每个 VMSA 长 4096 字节,其内容定义于 Linux 内核源码的 struct vmcb_save_area(或 AMD APM Vol.2 表 B-2)。

若未使用内核哈希或未启用 SEV-ES,则相应使用空 blob。

启动 SEV-SNP 客户机

SEV-SNP(Secure Nested Paging)启动使用 MEMORY_ENCRYPT_OP ioctl 的三个命令:SNP_LAUNCH_START、SNP_LAUNCH_UPDATE、SNP_LAUNCH_FINISH,与 SEV-SNP 固件通信以生成新密钥并加密启动镜像。

  • SNP_LAUNCH_START:首先调用,创建固件内加密启动上下文。Guest Owner 需按 SEV-SNP 固件规范提供客户机策略等参数。可配置参数(对应 qapi/qom.json 中 sev-snp-guest 对象的属性):
参数 类型 默认值 含义
policy hex 0x30000 64 位客户机策略
guest-visible-workarounds string 0 16 字节 base64 编码的客户机 OS 可见 workarounds 字符串
  • SNP_LAUNCH_UPDATE:使用启动上下文加密内存区域,可多次调用,加密时同步计算测量值;
  • SNP_LAUNCH_FINISH:完成启动流程。可选地,固件可在结束时对 SNP_LAUNCH_UPDATE 计算的启动摘要执行校验,用户需提供纳入 attestation report 的 ID block、认证 blob 与 host data。可配置参数:
参数 类型 默认值 含义
id-block string none base64 编码的 ID block(96 字节)
id-auth string none base64 编码的认证信息(4096 字节)
author-key-enabled bool 0 认证块是否包含 author key
host-data string none 主机提供的数据(32 字节)

启动 SEV-SNP 客户机(其他参数详见 qapi/qom.json 中 sev-snp-guest 对象 QAPI schema):

${QEMU} \
    -machine ...,confidential-guest-support=sev0 \
    -object sev-snp-guest,id=sev0,cbitpos=51,reduced-phys-bits=1

注意 SEV-SNP 的 cbitpos 通常为 51(与 SEV 的 47 不同),且 SEV-SNP 的启动测量值仅客户机内部可用(query-sev-launch-measure 仅对 sev-guest 有效,见 qapi/misc-i386.json)。sev-snp-guest 还支持 vcek-disabled(禁用 VCEK 密钥、强制使用 VLEK)、secure-tsc 与 tsc-frequency(安全 TSC)等属性。

调试、快照与迁移的现状

  • 调试:SEV 客户机内存加密后,hypervisor 访问客户机内存只会得到密文。若客户机策略允许调试,理论上 hypervisor 可用 DEBUG_DECRYPT/DEBUG_ENCRYPT 命令访问客户机内存,但 QEMU 目前尚未支持;
  • 快照/恢复(Snapshot/Restore):文档标注为 TODO;
  • 热迁移(Live Migration):文档标注为 TODO。

相关 QMP 管理命令

围绕 SEV,QEMU 在 qapi/misc-i386.json 中提供了一组 QMP 命令:query-sev(查询 SEV 启用状态、API 版本、build-id、客户机状态 SevState 与类型 sev/sev-snp)、query-sev-launch-measure(获取启动测量值)、query-sev-capabilities(获取平台 PDH 证书链与 cbitpos/reduced-phys-bits)、sev-inject-launch-secret(向 SEV/SEV-ES 客户机内存注入启动密钥 blob,SEV-SNP 不支持)、query-sev-attestation-report(获取客户机 attestation report)。这组命令是自动化部署与远程证明流程的关键接口。

Intel Trust Domain Extension(TDX)

Intel TDX(Trust Domain eXtensions) 扩展了 VMX 与 MKTME(多密钥全内存加密),引入名为 Trust Domain(TD) 的新类型虚拟机客户机。TD 运行在专门设计的 CPU 模式下,保护其内存内容与 CPU 状态免受包括宿主 VMM 在内的任何其他软件窥探——除非 TD 自身显式共享。

前置条件与 TDVF

  • 物理机需加载并初始化 TDX 模块,且 KVM hypervisor 支持并启用 TDX。满足后,KVM_CAP_VM_TYPES 会报告支持 KVM_X86_TDX_VM;
  • TDVF(Trust Domain Virtual Firmware) 用于为启动 TD 客户机 OS 提供 TD 服务,需在 TD 启动前复制到客户机私有内存并测量。KVM vcpu ioctl KVM_TDX_INIT_MEM_REGION 可用于将 TDVF 内容填充进私有内存。由于 TDX 不支持只读 memslot,TDVF 不能映射为 pflash 设备,而是以 RAM 形式工作,用 -bios 选项加载:-bios OVMF.fd(OVMF 是实现了 TDVF 支持的开源固件)。

特性配置:Attributes / XFAM / CPUID

与非 TDX VM 不同,TD 的 CPU 特性(由 CPU 或 MSR 枚举)并非完全由 VMM 控制。VMM 只能在 VM 范围的 MEMORY_ENCRYPT_OP ioctl 的 KVM_TDX_INIT_VM 命令上配置 TD 的部分特性。可配置特性分三类:

  • Attributes(属性):
    • PKS(bit 30):控制是否向 TD 暴露 Supervisor Protection Keys,进而决定相关 CPUID 位与 CR4 位;
    • PERFMON(bit 63):控制是否向 TD 暴露 PMU;
  • XSAVE 相关特性(XFAM):64 位掩码,格式与 XCR0 或 IA32_XSS MSR 相同,决定 TD 客户机可用的扩展特性集合;
  • CPUID 特性:仅部分 CPUID leaf 的部分位可由 VMM 直接配置。

能配置哪些特性由 TDX capabilities 报告:VM 范围 MEMORY_ENCRYPT_OP ioctl 的 KVM_TDX_CAPABILITIES 命令返回 struct kvm_tdx_capabilities 数据结构,说明支持的 attributes、XFAM 与 CPUID 配置。

QEMU 侧的配置属性

tdx-guest 对象(属性定义见 qapi/qom.json):

  • attributes:直接配置原始 64 位 TD attributes。注意用户需自行保证值的合法性,因为部分位当前 QEMU/KVM 可能尚不支持;
  • sept-ve-disable:控制 bit 28,即关闭 TD 访问 PENDING 页面时 EPT violation 到 #VE 的转换。部分客户机 OS(如 Linux TD guest)要求置位,否则拒绝启动;
  • mrconfigid / mrowner / mrownerconfig:base64 编码的 SHA384 摘要,分别用于非所有者定义的配置 ID、TD 所有者 ID、所有者定义的配置 ID(默认全零);
  • quote-generation-socket:Quote 生成服务(QGS)的 socket 地址。QGS 是宿主机上的守护进程,没有它客户机将无法获取用于 attestation 的 TD quote。

MSR 特性:当前 KVM 不支持 TDX 的 MSR 特性(如 MSR_IA32_ARCH_CAPABILITIES)配置,待 KVM 支持后 QEMU 再启用,属未来工作。

特性校验与告警

QEMU 会检查由给定 CPU 模型与显式特性调整(+featureA/-featureB)决定的最终 CPU 特性是否受支持,可能产生两类告警:

  • 特性不受支持:
    warning: host doesn't support requested feature: CPUID.07H:EBX.intel-pt [bit 25]
    
  • 显式禁用 TDX 的 fixed-1 特性时强制启用:
    warning: TDX forcibly sets the feature: CPUID.80000007H:EDX.invtsc [bit 8]
    
    后者是 QEMU 专为 TDX 新增的检查——TDX 存在 fixed-1 特性,由 TDX 模块强制启用,VMM 无法禁用。

启动一个 TD

启动 TD 的必要命令行选项是 tdx-guest 对象与 split kernel-irqchip:

qemu-system-x86_64 \
    -accel kvm \
    -cpu host \
    -object tdx-guest,id=tdx0 \
    -machine ...,confidential-guest-support=tdx0 \
    -bios OVMF.fd

限制、调试与 attestation

  • 限制:
    • kernel-irqchip 必须为 split(若保持默认 auto,TDX 客户机会自动设为 split);
    • 私有内存不支持只读;
    • 不支持 SMM(SMM 需要操作客户机寄存器状态,TDX 不允许)。
  • 调试:TD attributes 的 bit 0 为 DEBUG 位,决定 TD 是否以 off-TD 调试模式运行。调试模式下可通过特定 SEAMCALL 访问 TD 的 vCPU 状态与私有内存,这需要 KVM 暴露相应 API 及对应 QEMU 改动,属未来工作;
  • TD attestation:TD 客户机先调用 TDG.MR.REPORT 获取 REPORT,再由 SGX Quoting Enclave(QE)将 REPORT 转换为可远程验证的 Quote。由于当前 KVM 缺少支持,QEMU 中的 TD attestation 支持列为未来工作;
  • 热迁移:未来工作。

POWER Protected Execution Facility(PEF)

PEF(Protected Execution Facility),也称 Secure Guest 支持,是 IBM POWER9 与 POWER10 处理器的特性。若安装了包含 Ultravisor 的合适固件,CPU 会获得额外的内存保护模式:Ultravisor 管理一个 hypervisor 无法访问的安全内存池。

QEMU 中启用该特性后,客户机可通过 ultracall 进入"安全模式"(secure mode),将其大部分内存转移到安全内存,从而避免被攻破的 hypervisor 窃听。

启动一个允许进入 PEF 安全模式的客户机:

$ qemu-system-ppc64 \
    -object pef-guest,id=pef0 \
    -machine confidential-guest-support=pef0 \
    ...

热迁移:PEF 客户机的热迁移尚未实现。为保证一致性,QEMU 在启用 PEF 特性时禁止迁移——无论客户机是否实际进入了安全模式。

s390x Protected Virtualization(PV)

在 s390x 上,受保护虚拟机(PVM) 的内存与大部分寄存器对 hypervisor 加密或不可访问,运行期间实际上禁止了 VM 内省(introspection)。静态存储时 PVM 已加密,只能由特定 IBM Z 机器的固件实体 Ultravisor 解密。

前置条件

  • 需要具备 Protected Virtualization 特性的机器,由 Ultravisor Call facility(stfle bit 158) 指示;
  • 宿主内核命令行需设置 prot_virt=1 以在启动时初始化 Ultravisor;
  • 必须使用 KVM hypervisor。

满足上述条件后,能力 KVM_CAP_S390_PROTECTED 将指示该 LPAR 上 KVM 支持 PVM。相关 KVM 实现位于 target/s390x/kvm/pv.c。

运行一个 PVM

需要选择包含 Unpack facility(stfle bit 161,由特性 unpack/S390_FEAT_UNPACK 表示) 的 CPU 模型,并添加:

-object s390-pv-guest,id=pv0 \
-machine confidential-guest-support=pv0

添加这些选项会:

  • 确保 unpack facility 可用;
  • 默认对所有 I/O 设备启用 IOMMU;
  • 初始化 PV 机制。

已知限制:

  • vfio 透传设备目前不受支持;
  • 主机侧大页(huge page)后备存储不受支持(但客户机内部仍可按其 facility 使用大页)。

启动过程

安全客户机镜像可以从磁盘加载,也可以在 QEMU 命令行上提供:

  • 从磁盘启动:由未修改的 s390-ccw BIOS 完成——解释 bootmap、将多个组件读入内存、把控制权转交给其中一个组件(zipl stage3)。Stage3 做若干修正后,将控制权转交给客户机内存中的程序(通常是 OS 内核)。安全镜像还额外前置了一个组件(stage3a),使用新的 diag308 子码 8 和 10 触发进入安全模式的转换;
  • 从命令行镜像启动:要求 -kernel 传入的文件具备与磁盘启动相同的内存布局(包含加密组件 kernel/initrd/cmdline、stage3a loader 与元数据)。使用该方式时,-initrd 与 -cmdline 选项无效。PVM 镜像的制备使用 s390-tools 工具集中的 genprotimg 工具。

AWS Nitro Enclaves

AWS Nitro Enclaves 是与 EC2 实例并排运行的隔离计算环境:通过从父实例划分 CPU 与内存资源,在 Nitro Hypervisor 管理的机密 VM 中启动一个已签名的 EIF(Enclave Image Format) 文件。QEMU 支持在启用 enclave 的 EC2 实例上,使用 nitro 加速器与 nitro 机器类型启动 Nitro Enclave。

前置条件

  • 已启用 Nitro Enclaves 的 EC2 实例;
  • 已加载 nitro_enclaves 内核模块(提供 /dev/nitro_enclaves);
  • 通过 nitro-enclaves-allocator 将 CPU 核分配给 Nitro Enclaves 池;
  • 通过 nitro-enclaves-allocator 为 Nitro Enclaves 分配大页内存。

快速开始

从预构建的 EIF 文件启动:

$ qemu-system-x86_64 -accel nitro,debug-mode=on -M nitro -nographic \
    -smp 2 -m 512M -kernel enclave.eif

从独立的内核与 initrd 文件启动:

$ qemu-system-x86_64 -accel nitro,debug-mode=on -M nitro -nographic \
    -smp 2 -m 512M -kernel vmlinuz -initrd initrd.cpio \
    -append "console=ttyS0"

同样的命令也适用于 Graviton 系列 EC2 实例上的 qemu-system-aarch64。

加速器与机器类型

nitro 加速器(-accel nitro)驱动 /dev/nitro_enclaves 设备来创建与管理 Nitro Enclave,负责:创建 enclave VM 槽位、捐献内存区域(必须是大页后备)、添加 vCPU(必须是完整物理核)、启动 enclave、通知 vsock 总线设备 enclave 的 CID。

加速器选项:

  • debug-mode=on|off:启用调试模式。启用后 Nitro Hypervisor 通过 vsock 端口暴露 enclave 串行控制台输出,机器模型自动连接。调试模式下 PCR 值为零。默认 off。

nitro 机器类型(-M nitro)是极简、架构无关的机器,只提供 Nitro Enclave 所需内容:RAM(memfd 大页后备)、vCPU(默认 host CPU 类型)、以及带心跳设备(vsock server,端口 9000)与串行控制台桥(vsock client,仅调试模式)的 Nitro vsock 总线。

与 Nitro Enclave 的通信仅限于 virtio-vsock。Enclave 在启动时被分配 CID,可用 -accel nitro,enclave-cid=<N> 请求指定 CID(0 表示由 hypervisor 选择)。分配的 CID 可从 vsock 桥设备读取:

(qemu) qom-get /machine/peripheral/nitro-vsock enclave-cid

EIF 镜像格式与资源要求

  • EIF 检测:当 -kernel 指向 EIF 文件(通过 .eif 魔数检测)时,直接加载进客户机内存;当 -kernel 指向普通内核镜像(如 bzImage/Image)时,机器会自动从 -kernel、-initrd、-append 现场组装一个最小 EIF,实现无需外部 EIF 工具的标准直接内核启动;
  • CPU 要求:Nitro Enclave 需要完整物理 CPU 核。在超线程系统上,-smp 必须是每核线程数的倍数(通常为 2)。Enclave 只能消耗捐献给 Nitro Enclave CPU 池的核,可用 nitro-enclaves-allocator 或直接写 nitro_enclaves CPU 池参数配置,例如分配 vCPU 1、2、3:
    $ echo 1,2,3 | sudo tee /sys/module/nitro_enclaves/parameters/ne_cpus
    
    注意在 x86-64 系统上,超线程兄弟核并不连续,必须成对加入池中;可用 lstopo、lscpu 等工具查看实例 CPU 拓扑;
  • 内存要求:Enclave 内存必须大页后备。机器自动创建启用大页的 memfd 内存后端,需先在系统中预留大页。例如在 4 KiB PAGE_SIZE 系统上预留 1 GiB 内存:
    $ echo 512 | sudo tee /proc/sys/vm/nr_hugepages
    

模拟的 Nitro Enclave

除原生 Nitro Enclaves 调用外,还可使用模拟的 nitro-enclave 机器目标(见 docs/system/i386/nitro-enclave.rst),它实现了 x86 Nitro Enclave 设备模型。区别在于:-M nitro 将虚拟机设备模拟委托给 Nitro Hypervisor,而 -M nitro-enclave 自行实现全部设备,因此在非 EC2 实例上也能运行。若需要基于合法 AWS 证书的 NSM attestation,则必须使用 -M nitro——-M nitro-enclave 模型不提供 AWS 签名的 attestation 文档。

总结与选型参考

QEMU 的 Confidential Guest Support 通过统一的 -object + -machine confidential-guest-support= 两参数接口,屏蔽了五大平台机制(AMD SEV 家族、Intel TDX、POWER PEF、s390x PV、AWS Nitro Enclaves)的巨大差异;底层由 include/system/confidential-guest-support.h 定义的通用对象框架统一管理初始化、重置、策略设置、内存映射与客户机状态注入。

选型时可按平台快速对齐:AMD x86 用 sev-guest(SEV/SEV-ES)或 sev-snp-guest(SEV-SNP,提供更强的完整性与反重放保护);Intel x86 用 tdx-guest(注意 split irqchip 与 -bios 加载 TDVF 的要求);IBM POWER 用 pef-guest;IBM Z 用 s390-pv-guest(注意 unpack facility 与 IOMMU 默认开启);AWS EC2 场景用 nitro 加速器 + -M nitro(模拟场景用 -M nitro-enclave)。其中 SEV 家族已具备较完整的 QMP 管理命令与测量值计算流程,而 TDX 的调试/attestation/迁移、SEV 的快照与热迁移等功能目前仍标记为未来工作,生产环境部署前建议逐一核对各机制文档中标注的 TODO 项与限制。

登录后查看全文
qemu