跳到正文

异机复验 ​

在自己的 Linux 环境中,从公开源码和配方重建网关系统,计算 RTMR1、RTMR2。复现完成后,再用这些值 验证线上网关。

这里的“离线复现”指不连接远端 TDX 服务器;下载源码、依赖和构建工具仍需联网。无需 API 密钥或 TDX 硬件,也不会调用模型。

1.准备环境 ​

使用干净的 x86_64 Ubuntu 24.04 环境,建议 2 vCPU、4 GB 内存,至少 20 GB 空闲磁盘。macOS、Windows 用户可使用符合条件的 Linux 虚拟机;ARM 环境不能直接照此执行。

以下命令在同一个 root 终端中执行。构建需要 root 权限,且应使用专门的构建环境,避免已有 mkosi、ukify 或 Go 影响结果。

bash
sudo -i
apt update
apt install -y git jq curl python3-venv python3-pefile

git clone https://github.com/Falicitas/zeroseal-verifier
cd zeroseal-verifier

网络需能访问 Ubuntu 软件源及 snapshot 服务、GitHub 和 Go 模块源。完整环境要求见 verifier 构建环境。

2.选择版本和工具链 ​

measurements.jsonl 每行记录一次发布。先选定版本,再安装对应工具链:

bash
ZS_VERIFY_VERSION=$(tail -n 1 measurements.jsonl | jq -r '.version')
jq --arg version "$ZS_VERIFY_VERSION" \
  'select(.version == $version) | {version, gateway_commit, go_version}' \
  measurements.jsonl

这会选中当前仓库的最新发布。验证历史版本时,将 ZS_VERIFY_VERSION 改为记录中已有的版本号,并使用与该版本配套的仓库配方。

Go 版本必须与所选发布行完全一致。以下命令在干净环境中安装该版本:

bash
ZS_GO_VERSION=$(jq -r --arg version "$ZS_VERIFY_VERSION" \
  'select(.version == $version) | .go_version' measurements.jsonl)
curl -fL "https://go.dev/dl/${ZS_GO_VERSION}.linux-amd64.tar.gz" \
  -o /tmp/zeroseal-go.tar.gz
tar -C /usr/local -xzf /tmp/zeroseal-go.tar.gz
export PATH="/usr/local/go/bin:$PATH"
go version

verifier 当前配方使用 mkosi 26:

bash
python3 -m venv ~/mkosi-venv
~/mkosi-venv/bin/pip install 'git+https://github.com/systemd/mkosi.git@v26'
~/mkosi-venv/bin/mkosi --version

还需准备 systemd-ukify 255.4-1ubuntu8.17。在提供该版本的 Ubuntu 软件源中安装并检查:

bash
apt install -y systemd-ukify=255.4-1ubuntu8.17
dpkg-query -W systemd-ukify
command -v ukify

找不到指定版本时,先准备与配方一致的软件源或构建环境,不用最新版替代。mkosi、ukify 的版本目前写在 verifier 部署常量 中,尚未写入发布记录;更新配方时需一并核对。

3.运行复现 ​

仍在 zeroseal-verifier 目录中执行:

bash
./verify.sh "$ZS_VERIFY_VERSION"

首次运行可能需要几十分钟。脚本会询问是否下载约 330 MB 的 tools 压缩包,输入 y 后继续。新下载的包会先核对 tools_sha256,通过后才解压;已有 mkosi.tools/ 时会跳过该步校验。首次独立复验应从干净目录开始。

步骤检查内容
[0/5]构建工具树的压缩包哈希
[1/5]按发布记录的源码 commit 和 Go 版本编译 Gateway,核对二进制哈希
[2/5]从固定快照取得 shim、grub、stub;核对 shim 和 grub,stub 随后由 UKI 哈希覆盖
[3/5]重建 rootfs 和 verity 哈希树,核对 roothash
[4/5]重建 UKI,核对 uki_sha256
[5/5]按度量顺序计算 RTMR1、RTMR2,与发布记录比对

全部通过后,末尾会显示所选版本的复现成功提示,并在当前目录生成 reproduced.json:

bash
jq '{version, rtmr1, rtmr2, roothash, uki_sha256, reproduced_at}' reproduced.json

measurements.jsonl 是发布方声明;reproduced.json 保存这次本机计算的值。它证明这些产物能按公开配方复现,尚未证明线上服务器正在运行它们。下一步是 在线验证。

复现失败时 ​

情况检查方式
Go 版本不符对照所选发布行的 go_version,检查当前终端实际使用的 go。
tools 下载或哈希校验失败核对 tools_url、文件是否完整及 tools_sha256。非交互执行时,需提前将压缩包下载到仓库根目录。
Ubuntu snapshot 超时或返回错误检查下载日志和网络后重试,保留固定快照日期;换成当前软件源会改变产物。
rootfs 或 UKI 哈希不符核对 mkosi、ukify、Go 版本、构建源码和配方;不要修改期望值来让检查通过。
RTMR 不符先确认前面的产物均匹配,再核对所选版本及对应配方中的启动参数、磁盘路径和 MOK 配置。

脚本会重建 gateway-src/ 和相关构建产物,不要把自己的代码改动放在这些目录中。脚本会截短 mkosi 日志;出现构建错误时,应保留日志并在干净目录重新复现,不能仅看末尾输出判断成功,也不沿用旧的 reproduced.json 宣称本次成功。

RTMR1、RTMR2 的覆盖范围及固件层限制见 保护范围。完整配方与原始说明见 zeroseal-verifier。