异机复验
在自己的 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 versionverifier 当前配方使用 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.jsonmeasurements.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。