7623 字
38 分钟

铭瑄 B660I 默认 UUID 重复:从 Linux 排查到 UEFI 持久修改

2026-11-17,我准备把一台使用铭瑄 MS-PC Farm B660I 的主机加入 Kubernetes,发现它与另一台同型号机器的 product_uuid 完全相同:

03000200-0400-0500-0006-000700080009

这串值带有明显的默认填充特征。主机名、MAC 和 machine-id 各自独立,但固件没有给两台机器提供不同的 System UUID。

最初想在 Linux 下直接处理。实际走下来,遇到了三层问题:厂商发行版的平台限制、旧内核驱动与 Linux 6.8 的接口差异、老工具找不到 UEFI 公布的 SMBIOS 入口。修复入口以后,还碰到了旧 ROM/SMI 编辑初始化。

最后成功写入的是未经修改的原厂 EFI DMIEdit 5.27.04.0014。我用独立的一次性 UEFI 启动项运行它,先读取、只写一次、再读取,然后返回原有 Ubuntu。删除临时启动项后,又做了一次普通重启:新 UUID 仍然存在,sysfs 与独立物理读取一致。

本文把 Linux 调研、驱动补丁、失败定位、只读研究探针、EFI 执行脚本和重启验收放在一起。只读探针没有用于写入;普通重启持久性已验证,断电冷启动和回退写入没有演练。

时间均为北京时间。主机名、地址、新 UUID 和归档路径使用示例,原厂工具版本、摘要、关键错误、二进制偏移和验收结果按实际保留。文中的新 UUID f5e244d2-9dd7-4ceb-913e-8a286cdef7b1 只用于说明字节序;执行步骤会为每台机器重新生成 UUIDv4。

现场条件与最终路线#

项目本次环境
主机示例node-a / 192.0.2.31
主板产品名Maxsun MS-PC Farm B660I
SMBIOS 产品版本E1.9G
BIOSAMI 5.27,日期 2024-03-22
系统Ubuntu 24.04.4 LTS
内核6.8.0-100-generic,x86-64
SMBIOS 表版本3.6
启动模式UEFI
Secure Boot原本已关闭,没有在本次改变设置
系统盘 / ESP/dev/sda / /dev/sda1,ESP 挂载在 /boot/efi
正常启动项Boot0001 Ubuntu,指向 \EFI\ubuntu\shimx64.efi
业务状态尚未加入集群,接入流程暂停,无运行中的集群业务

本次没有给已有 Kubernetes Node 在线换身份,也没有迁移业务。若机器已经承载工作负载,需要另外核对维护窗口、硬件身份的使用方和恢复路径,不能把这次独立主机的结果当作该场景的验收。

整个过程可以按四个阶段看:

阶段实际结果
SECO / ASUS Linux 工具驱动可以适配,程序仍被发行版的平台检查拒绝
技嘉包中的 AMIDELNX 5.16驱动通过,初始化 SMBIOS 报 D5
对 5.16 制作只读研究副本修复 UEFI 入口,去掉读取不需要的编辑初始化后,/SU 返回 R/Done
原厂 EFI 5.27.04.0014原生读、单次写、读后检查全部返回 0,普通重启后保持新 UUID

先确认改的是哪一种身份#

目标是 SMBIOS Type 1 / System Information 的 UUID,Linux 通过下面的接口暴露它:

Terminal window
hostname
uname -r
sudo cat /sys/class/dmi/id/product_uuid
sudo dmidecode -t 0 -t 1 -t 2

它与以下项目各自独立:

身份所属层级
product_uuid固件 SMBIOS Type 1
/etc/machine-id当前操作系统安装
文件系统 UUID / GPT PARTUUID磁盘、分区、文件系统
MAC 地址网卡或网络配置
Kubernetes Node 名称、对象 UID集群对象与节点注册

修改 machine-id、挂载一个替代文件或只改 Kubernetes 的展示字段,都不能证明固件里的 System UUID 已改变。

/sys/class/dmi/id/product_uuid 也是只读导出。本机权限为 0400;更关键的是,内核的 DMI 属性没有对应的写入回调。给它 chmod 或向它 echo,不是固件写接口。Linux 6.8 的 dmi-id.c

Kubernetes 的部署文档要求每个节点具有唯一的 hostname、MAC 和 product_uuid。不过,部署前提与程序是否做跨节点强制检查要分开看:本次对应的 kubeadm 1.35.9 预检代码没有扫描现有节点来检查 product_uuid 重复,不能据此断言它必然使 join 失败。我是在接入前解决这项固件元数据缺陷,没有使用 ignore-preflight-errors,也没有伪造节点身份。部署前提、本次版本的预检源码

Linux 工具存在,厂商发行版却有自己的条件#

调研起点是 SECO 的 Modify SMBIOS Information 文档。它提供 Linux 版 AmiDeLnx64,/SU 操作 System UUID;不带新值读取,带新值写入。文档里针对 SECO 产品的字段限制,也不能直接当成其他品牌主板的支持声明。

只读查询与写入命令只差一个参数,所以初期只运行:

Terminal window
sudo ./AmiDeLnx64 /SU

候选工具的结果如下:

工具来源本次结果
AmiDeLnx64 5.27.0016SECO Apollo Lake 工具包平台检查拒绝,退出 73 / 0x49
SECO Git 仓库版SECO 官方 GitLabhash 与上面完全相同,没有重复运行
SECO 包内 5.26 旧版同一官方工具包静态检查仍有 SECO 定制标识,没有作为通用版运行
iDmiEditLnx64 5.27.06.0018ASUS NUC 官方工具包同样返回 0x49
amidelnx_26_64 5.16技嘉 GSM CLI 1.00能继续到驱动和 SMBIOS 初始化,随后报 D5
AMIDEEFIx64.EFI 5.27.04.0014Qotom 官方 SN&UUID 工具包最后在真实主机 EFI 环境读写成功

SECO 和 ASUS 的错误都是:

This tool is not supported on this system.
49 - Error: A platform condition has prevented executing.

跟踪显示,它们在读取只读 SMBIOS 表之后退出,尚未打开驱动设备。SECO 二进制还有自己的产品定制标识。由此只能确认这些发行版拒绝当前平台,不能推导出铭瑄固件没有 DMI 写接口。也不能仅凭 BIOS 与工具都写着“5.27”就认定兼容。

第一处适配:Linux 6.8 的 vm_flags 已经只读#

SECO 工具内置的驱动源码在本机实编时,首先报:

error: assignment of read-only member 'vm_flags'
vma->vm_flags |= VM_LOCKED;

该处改为内核提供的接口:

vma->vm_flags |= VM_LOCKED;
vm_flags_set(vma, VM_LOCKED);

它保留原有标志含义,没有改变映射过滤规则。Linux 6.8 的 vm_area_struct、对应的内存管理接口

这一代驱动完成了编译、加载、驱动信息 ioctl 和 SMM mailbox 的只读 mmap 检查。驱动信息返回 (1, 16, 1, 0),实际修改的 mmap 路径也被触发过。这些检查证明驱动基础接口可用,没有证明用户态编辑器通过平台检查,更没有证明可以持久写入。

加载专有、树外、未签名模块后,内核 taint 变为 12289,对应 P/O/E。卸载模块不会清除此标记。本次最终重启后为 0,没有设置驱动自动加载,也没有把模块安装到系统目录。

新驱动的一行补丁保存在附件 vm-flags-set.patch。

旧版生成命令的副作用:SUBDIRS 误入内核构建#

技嘉包里的工具说明标注 DMIEDIT_LNX-5.16,目标为 Aptio V。它能通过 /GENDRV 生成驱动源码,但旧 Makefile 使用:

make -C $(KERNEL) SUBDIRS=$(PWD) modules

第一次让它生成驱动时,当前构建系统没有把旧参数当成外部模块目录,转而触发头文件树的 syncconfig。由于缺少 flex 而失败,删除了 autoconf.h、rustc_cfg,并重编译了四个构建辅助文件。工具自己却继续打印生成成功。

这次没有靠安装 flex/bison 或更新内核继续试。先核对包完整性,再重装相同版本的 generic 头文件包:

Terminal window
# 下面是本次环境的包名与版本,其他机器先查自己的已安装版本。
dpkg-query -W linux-headers-6.8.0-100 linux-headers-6.8.0-100-generic
sudo dpkg -V linux-headers-6.8.0-100 linux-headers-6.8.0-100-generic
sudo env DEBIAN_FRONTEND=noninteractive NEEDRESTART_MODE=l \
apt-get --no-install-recommends --reinstall -y install \
linux-headers-6.8.0-100-generic=6.8.0-100.100
sudo dpkg -V linux-headers-6.8.0-100 linux-headers-6.8.0-100-generic

恢复后两个包的校验没有差异,后续外部模块构建也通过。没有为此升级运行中的内核。

之后提取源码时,截获了旧工具对 make 的调用:只把它的临时源码复制出来,返回失败,不执行旧构建。下面是相同做法的示例,工作目录必须是专用实验目录:

mkdir capture-bin
cat > capture-bin/make <<'SH'
#!/bin/sh
set -eu
test -f amifldrv.c
test -f amiwrap.c
test ! -e ../legacy-generated-source
cp -R . ../legacy-generated-source
exit 1
SH
chmod 0700 capture-bin/make
PATH="$PWD/capture-bin:$PATH" ./amidelnx_26_64 /GENDRV \
KERNEL="/lib/modules/$(uname -r)/build" OUTPUT=unused-output
# 程序的“ok”不是验收;必须确认完整源码确实保存下来。
test -s legacy-generated-source/amifldrv.c
test -s legacy-generated-source/amiwrap.c
test -s legacy-generated-source/Makefile

正式构建使用 M= 外部模块流程,并对系统头文件加只读保护。不要再重放未经修正的旧生成/构建命令。

AMIDELNX 5.16 驱动的完整改动与自检#

旧驱动还需要启用已经存在的 unlocked_ioctl 分支,显式包含 linux/module.h,并修正构建参数。考虑到这是要临时加载到真实主机的代码,还补上了用户指针拷贝、非正/超限大小和分配失败检查;键盘锁定、解锁 ioctl 改为空操作,与前一代当前 AMI 驱动一致,避免读 UUID 时禁用 IRQ1。

没有增加任意物理内存映射能力,保留了只映射本驱动分配缓冲区的限制;许可证仍为 Proprietary,没有伪装许可证或跳过 modpost。

完整补丁在legacy-5.16-linux-6.8.patch,自检源码在legacy_driver_selfcheck.py。应用与构建示例:

Terminal window
cp -a legacy-generated-source legacy-driver-linux-6.8
patch -p1 -d legacy-driver-linux-6.8 < legacy-5.16-linux-6.8.patch
sudo systemd-run --wait --pipe --collect \
--working-directory="$PWD" \
-p 'ReadOnlyPaths=/usr/src /lib/modules' \
/usr/bin/make -C "/lib/modules/$(uname -r)/build" \
M="$PWD/legacy-driver-linux-6.8" modules
modinfo legacy-driver-linux-6.8/amifldrv_mod.ko

自检只访问私有缓冲区,不调用固件:

Terminal window
# 确认没有其他同名模块或设备,再做本次临时测试。
(
set -euo pipefail
test ! -e /sys/module/amifldrv_mod
test ! -e /dev/amifl
trap 'test ! -c /dev/amifl || sudo rm /dev/amifl; test ! -e /sys/module/amifldrv_mod || sudo rmmod amifldrv_mod' EXIT
sudo insmod legacy-driver-linux-6.8/amifldrv_mod.ko
major=$(awk '$2 == "amifldrv" {print $1}' /proc/devices)
test -n "$major"
sudo mknod -m 0600 /dev/amifl c "$major" 0
sudo python3 legacy_driver_selfcheck.py
)

实际通过的检查包括:非法用户指针返回 EFAULT;大小为 -1、0、超过 128 KiB 时返回 EINVAL;64 KiB 分配、只读映射、初始化内容读取、释放均成功。

厂商旧 ABI 只回填了部分字段,不能要求它没回填的 kvirtlen、kmallocptr 非零。我最初的自检在这里加了不成立的断言,修正后改用实际读取初始化模式来验证映射。构建时缺少 vmlinux 而跳过 BTF,并不是这次的失败点。

D5:工具只在传统 BIOS 地址区找入口#

驱动与缓冲区能工作后,原始 5.16 的 /SU 继续报:

Error: Fail At Getting DMI Data.
d5 - Error: DMI Data read failed.

退出码是十进制 213,即 0xD5。trace 里已经有模块加载、缓冲区分配和 mmap 成功,所以继续修改驱动不能解释这个错误。

反汇编把路径定位为:

GetDMI()
└─ SearchPort("_SM_")
└─ MapPhyMem(0x000f0000, 0x0000ffff)

对应指令的关键部分:

0x420465 mov $0xffff, %esi
0x42046a mov $0xf0000, %edi
0x42046f call MapPhyMem

它只扫描传统区域,没有查询 UEFI 配置表。本机却同时在 EFI systab 公布了两种入口:

Terminal window
sudo cat /sys/firmware/efi/systab
sudo od -An -tx1 /sys/firmware/dmi/tables/smbios_entry_point

本次启动采样如下,这些地址会随启动或固件布局变化,不是可复制的常量:

项目本次值
SMBIOS3 / _SM3_ 入口0x67b34000
SMBIOS / _SM_ 兼容入口0x67b35000
两者公布的表版本3.6
两者指向的表地址0x67b31000
表长4741 字节
结构数量81

两种入口都通过签名、长度和校验和检查;兼容入口的 _DMI_ 中间校验和也通过。按入口地址只读读取物理内存,得到的表与内核导出的 /sys/firmware/dmi/tables/DMI 逐字节相同,Type 1 中的 UUID 也相同。

这里容易混淆:32 位兼容入口的格式,不代表把表版本降成 SMBIOS 2.x。 固件的这两个入口都描述同一张 3.6 表,只是入口结构和地址字段格式不同。UEFI 上应从配置表取得入口,不能把传统区域扫描当成全部情况。SMBIOS 3.6 规范 5.2.1 / 5.2.2、Linux 6.8 的入口发现代码

修复 D5 以后,还有 D7 与旧 SMI 查询#

我没有改写 EFI 配置表,也没有把假 DMI 表放到传统地址区。研究副本只重定向 GetDMI() 的入口发现调用,让它映射固件真实提供的兼容入口。

这样确实读到了完整表,D5 消失,随后出现:

d7 - Error: System doesn't support.

D7 来自另一条旧逻辑:GetROMLast16BYTES() 读取传统 ROM 特征,根据 bIsEFI 选择编辑路径,后面还有 InitSMBIfc()。这与已经取得的表内 UUID 是不同的初始化要求。

启动时另有两处重复的 SMI 0x7F 内存洞查询:一处在 DMI 模块注册里,另一处在分配回退中。当进程不被允许启用端口 I/O 时,分别在 0x420424、0x40b1e3 的端口指令退出。只改其中一处,仍会在另一处失败。

ReadDMIMM() 的 UUID 读取函数只解析已经加载的 pArray。因此只读副本可以让表加载成功后进入原来的读取输出路径,省去这次读取不需要的 ROM/SMI 编辑初始化和硬件查询。

我还给副本加了两道限制:物理表映射改为 PROT_READ;SetSMBIOSStructureField() 入口改为立即中止指令。这是一份专门用于读取验证的研究副本,不是一份修好写接口的通用编辑器。

附件包含完整生成脚本与解析测试。发布示例只把现场主机校验名替换为 node-a;其他文件 hash、代码偏移和限制保留。运行前要在确认目标后调整该主机校验,不要删掉校验来对未知文件试补丁。

生成器会检查原始二进制 SHA256、两种真实入口是否指向同表、结构边界、字符串终止、Type 1 唯一性、计数和 UUID 一致性。它要求入口页对齐、表在 4 GiB 以下、表长不超过 36 KiB;没有实现 SMBIOS3-only、大表或高地址的通用支持。

只读副本的关键修改位置如下,仅适用于附件锁定的那一个 5.16 文件:

文件偏移修改用途
0xe64a0在零填充区放入 15 字节真实入口映射代码
0x60、0x68扩展原 RX 段,使新增代码可加载
0xbc7b只重定向 GetDMI 的调用,保留其他 SearchPort 调用
0xb89d成功加载表后结束只读初始化,不进入编辑接口准备
0xae04省去这份表读取副本中的 Flash 策略硬件查询
0x203f9、0xb1b4两处旧 SMI 内存洞查询走私有缓冲区回退
0x6e6d、0x20268物理映射改为只读
0x218ab字段写入入口立即中止

最终 /SU 得到:

(/SU)System UUID R Done "00020003000400050006000700080009h"

这一轮进程的 iopl(3) 被内核以 EPERM 拒绝,仍能退出 0;物理入口和表映射都是只读。读通说明表发现与读取链路成立,不能用这个结果跳到写入结论。

附件的运行方式如下。生成器只产出新目录中的文件,副本还绑定生成时的入口地址;启动周期变化后要重新核实并生成,不能重用旧地址:

Terminal window
python3 test_uuid_probe.py
sudo python3 prepare_uuid_probe.py ./amidelnx_26_64 probe-current-boot
cp legacy-driver-linux-6.8/amifldrv_mod.ko amifldrv_mod.o
# 在已核实的实验目录、root shell 中运行;工具会临时加载这个模块。
(
set -euo pipefail
test ! -e /sys/module/amifldrv_mod
test ! -e amifl
trap 'test ! -e /sys/module/amifldrv_mod || rmmod amifldrv_mod; test ! -c amifl || rm amifl' EXIT
systemd-run --wait --pipe --collect --working-directory="$PWD" \
-p RuntimeMaxSec=20 -p UMask=0077 -p LimitCORE=0 -p PrivateNetwork=yes \
-p 'CapabilityBoundingSet=~CAP_SYS_BOOT' \
-p 'SystemCallFilter=~@reboot @raw-io' -p SystemCallErrorNumber=EPERM \
-p 'InaccessiblePaths=-/run/systemd/private -/run/dbus/system_bus_socket -/dev/initctl -/dev/port' \
-p 'ReadOnlyPaths=/usr/src /lib/modules /proc/sys/kernel/watchdog' \
/usr/bin/strace -f -i -o "$PWD/read-only.strace" \
"$PWD/probe-current-boot/amidelnx-uefi-uuid-readonly" /SU
)

最后采用原厂 EFI 工具写入#

进入允许重启的维护窗口后,我改用 Qotom 官方工具目录中的 AMIDEEFIx64.EFI。这个文件在本机输出的完整版本是 5.27.04.0014,保持原样,没有取消它的平台检查,也没有解除前面研究副本的写保护来尝试修改。

工具来源为 Qotom 官方目录下的 SN&UUID Update Tool.zip。UEFI Shell 使用 pbatard/UEFI-Shell 26H2 的独立 X64 文件,基于 EDK2 stable202608。

Shell 版本也要核实。我最初找到的旧 TianoCore 归档文件没有 -exit 参数,没有部署到主机。最终文件支持 Shell 2.2 的 -exit、-nostartup、-nointerrupt:执行指定脚本后退出,不留在交互提示符,也不运行全局 startup.nsh。UEFI Shell 2.2 规范

这次采用下面的控制方式:

  1. 文件放入 ESP 的独立目录,不覆盖 Ubuntu 或默认可移动介质入口。
  2. 新建 Boot####,使用 efibootmgr -C,不加入正常 BootOrder。
  3. 只给下一次启动设置 BootNext。
  4. EFI 脚本先原生读取,成功后只执行一次 /SU 新值,保存写后读取。
  5. 脚本启动既有 Ubuntu shim;Linux 返回后检查结果。
  6. 删除临时启动项,再做一次普通重启验证持久性。

BootNext 是一次选择,BootOrder 是正常顺序。不能把临时工具放到优先启动位置后就结束维护。相关行为可对照 efibootmgr 源码与说明和 EDK2 Boot Manager 实现。

写入前:保存身份、启动状态和回退输入#

下面的例子在目标机上以 root 执行。设备名、主机名和启动项是本例的条件;先替换并核实,不要把 /dev/sda1、fs0: 或 Boot 编号当成固定规则。

Terminal window
sudo -i
umask 077
mkdir /root/uuid-lab
cd /root/uuid-lab
hostname
uname -r
cat /sys/class/dmi/id/product_uuid > uuid-before.txt
cat /proc/sys/kernel/random/boot_id > boot-id-before.txt
cat /etc/machine-id > machine-id-before.txt
dmidecode -t 1 > dmi-type1-before.txt
efibootmgr -v > efibootmgr-before.txt
findmnt /boot/efi
lsblk -o NAME,TYPE,SIZE,FSTYPE,MOUNTPOINTS
mokutil --sb-state
sha256sum /boot/efi/EFI/ubuntu/shimx64.efi \
/boot/efi/EFI/ubuntu/grubx64.efi > ubuntu-efi-before.sha256

我还检查了 cloud-init 状态、当前网络、服务启用/运行状态与管理路径。现场 cloud-init 已 disabled,系统分区没有加密;换 UUID 不会在这台机器上触发 cloud-init 的新实例初始化。原 kubelet 处于 enabled 但未引导、未运行状态,后续要恢复这个暂停状态,而不是借重启继续接入。

恢复材料包括原 UUID、原始 16 字节编码、启动顺序、系统身份与启动文件摘要。保存一个旧 UUID 不等于拥有完整 BIOS 备份,也不等于回退写入已经演练过。

UUID 字节序:参数不能直接照抄显示字符串#

这次工具显示的是 16 个原始字节,末尾的 h 是显示标记。Linux 对 SMBIOS 2.6 及以后的 UUID,将前三个字段按小端解释。Linux 的 dmi_save_uuid

以本文的脱敏示例为例:

import uuid
value = uuid.UUID('f5e244d2-9dd7-4ceb-913e-8a286cdef7b1')
print(value.bytes_le.hex().upper())
# D244E2F5D79DEB4C913E8A286CDEF7B1
print(uuid.UUID(bytes_le=bytes.fromhex('D244E2F5D79DEB4C913E8A286CDEF7B1')))
# f5e244d2-9dd7-4ceb-913e-8a286cdef7b1

不能把去掉连字符后的 value.hex 当作这个版本工具的原始字节参数,也不要把输出末尾的 h 传回写命令。现场使用的是先生成 UUIDv4,再计算 bytes_le,并在写后把原始字节重新解码核对。

为实际目标生成新值,不复用文章里的示例 UUID:

Terminal window
python3 - <<'PY'
from pathlib import Path
import json, socket, uuid
expected_host = 'node-a' # 先替换为已核实的目标主机名。
assert socket.gethostname() == expected_host
new = uuid.uuid4()
data = {
'expected_host': expected_host,
'old_uuid': Path('uuid-before.txt').read_text().strip().lower(),
'new_uuid': str(new),
'new_raw_smbios_hex': new.bytes_le.hex().upper(),
'boot_id_before': Path('boot-id-before.txt').read_text().strip(),
}
assert data['old_uuid'] != data['new_uuid']
Path('target.json').write_text(json.dumps(data, indent=2) + '\n')
print(json.dumps(data, indent=2))
PY

完整 EFI 执行脚本#

脚本固定使用 fs0:,是因为现场只有一个可映射的 EFI FAT 分区,并已核实对应关系。多 ESP、USB 或额外 FAT 卷的机器需要先确认映射;HOST.ID 存在检查不能替代目标主机和分区身份核对。

附件 RUN.NSH.in 是输入模板,不能直接启动。它保留一个 __NEW_RAW_UUID__ 标记,由下一段 Python 在验证 UUID 后替换:

@echo -off
if not exist fs0:\EFI\UUID1117\HOST.ID then
exit /b 2
endif
if exist fs0:\EFI\UUID1117\ONCE.FLG then
echo ALREADY_ATTEMPTED >> fs0:\EFI\UUID1117\STATUS.TXT
fs0:\EFI\ubuntu\shimx64.efi
exit /b 3
endif
echo UUID_CHANGE_ATTEMPT_STARTED > fs0:\EFI\UUID1117\ONCE.FLG
if not exist fs0:\EFI\UUID1117\ONCE.FLG then
exit /b 4
endif
fs0:\EFI\UUID1117\AMIDEEFIx64.EFI /SU > fs0:\EFI\UUID1117\BEFORE.TXT
set -v UUID_READ_STATUS %lasterror%
echo READ_STATUS=%UUID_READ_STATUS% > fs0:\EFI\UUID1117\STATUS.TXT
if %UUID_READ_STATUS% == 0 then
fs0:\EFI\UUID1117\AMIDEEFIx64.EFI /SU __NEW_RAW_UUID__ > fs0:\EFI\UUID1117\WRITE.TXT
set -v UUID_WRITE_STATUS %lasterror%
echo WRITE_STATUS=%UUID_WRITE_STATUS% >> fs0:\EFI\UUID1117\STATUS.TXT
fs0:\EFI\UUID1117\AMIDEEFIx64.EFI /SU > fs0:\EFI\UUID1117\AFTER.TXT
set -v UUID_AFTER_STATUS %lasterror%
echo AFTER_STATUS=%UUID_AFTER_STATUS% >> fs0:\EFI\UUID1117\STATUS.TXT
else
echo WRITE_SKIPPED_READ_FAILED >> fs0:\EFI\UUID1117\STATUS.TXT
endif
echo RETURNING_TO_UBUNTU >> fs0:\EFI\UUID1117\STATUS.TXT
fs0:\EFI\ubuntu\shimx64.efi
exit /b 1

ONCE.FLG 在读取前创建;写标记失败就退出。再次进入同一目录时跳过全部读写,直接走返回路径。状态变量都使用 set -v,不把这几个临时值保存到固件的持久 Shell 环境里。

这个门禁依据工具的返回码,不解析输出中的 R/Done,也不是厂商兼容性认证。现场同时有维护前的主板/BIOS/旧 UUID 核对,以及事后对三份原厂日志的检查。不能把它作为对任意机器批量写入的依据。

将模板、新值和 Shell 参数生成成实际文件:

Terminal window
# 当前目录已放入 target.json、RUN.NSH.in、SHELLX64.EFI、AMIDEEFIx64.EFI。
python3 - <<'PY'
from pathlib import Path
import json, uuid
t = json.loads(Path('target.json').read_text())
raw = uuid.UUID(t['new_uuid']).bytes_le.hex().upper()
assert raw == t['new_raw_smbios_hex']
template = Path('RUN.NSH.in').read_text()
assert template.count('__NEW_RAW_UUID__') == 1
script = template.replace('__NEW_RAW_UUID__', raw)
assert '__NEW_RAW_UUID__' not in script
assert sum('/SU ' + raw in line for line in script.splitlines()) == 1
script = script.replace('\r\n', '\n').replace('\n', '\r\n')
Path('RUN.NSH').write_bytes(b'\xff\xfe' + script.encode('utf-16-le'))
options = r'-nomap -noversion -nointerrupt -nostartup -exit fs0:\EFI\UUID1117\RUN.NSH'
Path('load-options.bin').write_bytes(options.encode('utf-16-le') + b'\0\0')
PY

实际上传到 ESP 的脚本是 UTF-16LE BOM、CRLF。Boot 可选参数也是 UTF-16LE,并以 NUL 结束,通过 efibootmgr -@ 原样附加,避开命令行中以 - 开头的参数被再次解释的问题。

先隔离验证,再部署到 ESP#

我在本机独立 Docker 容器里安装 QEMU、OVMF、mtools 和 dosfstools。没有给目标主机安装这些程序,也没有把真实硬盘交给 QEMU。

完整隔离测试脚本在 qa_efi_script.py。它在 /work 创建 FAT32 文件镜像,使用无网卡的 TCG 虚拟机;模拟工具只记录调用并返回成功或失败,返回 Ubuntu 的动作在实验里替换为记录标记并关闭虚拟机。

Terminal window
# 在管理机的新建空测试目录执行,放入上面生成的四个文件与测试脚本。
# 使用官方 Ubuntu 镜像;测试写入的是该目录里的 FAT 镜像文件。
docker run --rm --cpus 2 --memory 1g \
-v "$PWD:/work" ubuntu:24.04 bash -lc '
export DEBIAN_FRONTEND=noninteractive
apt-get update -qq &&
apt-get install -y --no-install-recommends \
qemu-system-x86 ovmf mtools dosfstools python3 &&
python3 /work/qa_efi_script.py
'

本次通过的四种情形是:

CASE_OK success repeat=False
CASE_OK success repeat=True
CASE_OK read-failure repeat=False
NATIVE_TOOL_RESULT READ_STATUS=0xE0
WRITE_SKIPPED_READ_FAILED
RETURNING_TO_UBUNTU
CASE_OK native repeat=False

前三项验证控制流程,第四项验证原厂工具在非 AMI 的 OVMF 中拒绝执行时仍能到达返回路径。虚拟机测试没有证明真实主板的写入能力;后者由之后真实主机的 W/Done、回读和普通重启单独验收。

新建一次性启动项,正常 BootOrder 保持#

文件放到新目录,存在同名目录时停止处理,避免覆盖旧材料:

Terminal window
test ! -e /boot/efi/EFI/UUID1117
mkdir /boot/efi/EFI/UUID1117
cp SHELLX64.EFI AMIDEEFIx64.EFI RUN.NSH /boot/efi/EFI/UUID1117/
printf 'node-a\njob=uuid-lab\n' > /boot/efi/EFI/UUID1117/HOST.ID

实际执行前,我核对了三个部署文件的摘要、目标 UUID、boot ID 和原启动状态。下面的准备代码保留这些检查,还会解码新建 Boot 变量,核对 OptionalData,只创建启动项,不设置 BootNext、不重启:

# 保存为 create_boot_entry.py,在 /root/uuid-lab 中以 root 执行。
from pathlib import Path
import hashlib, json, re, socket, struct, subprocess
t = json.loads(Path('target.json').read_text())
assert socket.gethostname() == t['expected_host']
assert Path('/sys/class/dmi/id/product_uuid').read_text().strip().lower() == t['old_uuid']
assert Path('/proc/sys/kernel/random/boot_id').read_text().strip() == t['boot_id_before']
before = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert 'BootNext:' not in before
order = re.search(r'^BootOrder: (.+)$', before, re.M).group(1)
Path('boot-order-before.txt').write_text(order + '\n')
expected = {
'SHELLX64.EFI': '4922d9885ac92d8ab58e5da4eb8ad6cbfbe651ea9cdc03a1ba67355e5ede83b1',
'AMIDEEFIx64.EFI': 'd485d2dad404177d5af73edafc9645add9a6f2f2c1e098913c3f9fe880192e86',
}
for name, digest in expected.items():
assert hashlib.sha256(Path(name).read_bytes()).hexdigest() == digest
for name in (*expected, 'RUN.NSH'):
assert Path(name).read_bytes() == (Path('/boot/efi/EFI/UUID1117') / name).read_bytes()
label = 'UUID change lab'
assert label not in before
# 本例 ESP 是 /dev/sda1。NVMe、其他分区布局必须替换磁盘与分区号。
subprocess.run(['efibootmgr', '-C', '-d', '/dev/sda', '-p', '1',
'-l', r'\EFI\UUID1117\SHELLX64.EFI', '-L', label,
'-@', str(Path('load-options.bin').resolve())], check=True)
after = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert re.search(r'^BootOrder: (.+)$', after, re.M).group(1) == order
number = re.search(r'^Boot([0-9A-Fa-f]{4})\*\s+' + re.escape(label) + r'\s', after, re.M).group(1).upper()
data = (Path('/sys/firmware/efi/efivars') /
('Boot' + number + '-8be4df61-93ca-11d2-aa0d-00e098032b8c')).read_bytes()[4:]
attributes, path_length = struct.unpack_from('<IH', data)
assert attributes & 1
position = 6
while data[position:position + 2] != b'\0\0':
assert position + 2 <= len(data)
position += 2
assert data[position + 2 + path_length:] == Path('load-options.bin').read_bytes()
Path('boot-number.txt').write_text(number + '\n')
Path('efibootmgr-prepared.txt').write_text(after)
print('Prepared Boot' + number + '; BootOrder unchanged; BootNext not armed')

不要假定新项一定是 0000 或 0002。本次恰好分配到 0000,正常顺序仍只有 0001 Ubuntu。

确认准备结果与维护窗口后,才设置一次选择并重启:

Terminal window
python3 create_boot_entry.py
efibootmgr -v

真正触发的步骤独立执行。本次使用 3 秒延迟的一次性单元,避免依赖 SSH 连接持续存在;若设置 BootNext 后无法安排重启,就撤销自己设置的值,不把未完成的准备遗留给之后的重启:

# 这是会安排真实主机重启的步骤,准备与维护窗口确认后才运行。
from pathlib import Path
import json, re, socket, subprocess
t = json.loads(Path('target.json').read_text())
number = Path('boot-number.txt').read_text().strip()
assert re.fullmatch(r'[0-9A-Fa-f]{4}', number)
assert socket.gethostname() == t['expected_host']
assert Path('/sys/class/dmi/id/product_uuid').read_text().strip().lower() == t['old_uuid']
assert Path('/proc/sys/kernel/random/boot_id').read_text().strip() == t['boot_id_before']
state = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert 'BootNext:' not in state
assert re.search(r'^BootOrder: (.+)$', state, re.M).group(1) == Path('boot-order-before.txt').read_text().strip()
subprocess.run(['efibootmgr', '-n', number], check=True)
try:
armed = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert 'BootNext: ' + number.upper() + '\n' in armed
Path('efibootmgr-armed.txt').write_text(armed)
subprocess.run(['systemd-run', '--unit=uuid-efi-once', '--on-active=3s',
'/usr/bin/systemctl', 'reboot'], check=True)
except BaseException:
current = subprocess.check_output(['efibootmgr'], text=True)
if 'BootNext: ' + number.upper() + '\n' in current:
subprocess.run(['efibootmgr', '-N'], check=True)
raise

不能覆盖另一个维护任务已经设置的 BootNext。SSH 断开后,应等待主机的新 boot ID,不能以重启前仍可复用的连接作为“已经回来”的证据。

原厂写入结果与两次启动验证#

第一次启动进入 EFI 后,原生读前、写入、读后的返回值都是 0。下面的新值已经按本文示例脱敏,R/W 状态与本次结果一致:

R Done "00020003000400050006000700080009h"
W Done "D244E2F5D79DEB4C913E8A286CDEF7B1"
R Done "D244E2F5D79DEB4C913E8A286CDEF7B1h"
READ_STATUS=0x0
WRITE_STATUS=0x0
AFTER_STATUS=0x0
RETURNING_TO_UBUNTU

23:20:13,主机第一次回到 Ubuntu,sysfs 已显示新 UUID。boot ID 与维护前不同,machine-id 不变;Ubuntu shim/grub 的 hash 也不变。

但这还不足以结束维护:EFI 工具可能已经更新了本次启动内存里的 SMBIOS 表,刚启动的 Linux 正在读取那张表。还要确认普通启动会重新得到同一个值。

我先保存 ESP 上的日志,确认 BootNext 已消费、正常 BootOrder 没变,删除本次创建的 Boot####。随后不再进入工具,再做一次普通重启。

删除前核对标签和路径,编号取自这次生成的记录:

# 第一次从 EFI 返回 Ubuntu 后,在同一个维护目录执行。
from pathlib import Path
import json, re, shutil, subprocess
t = json.loads(Path('target.json').read_text())
number = Path('boot-number.txt').read_text().strip().upper()
assert Path('/sys/class/dmi/id/product_uuid').read_text().strip().lower() == t['new_uuid']
assert Path('/proc/sys/kernel/random/boot_id').read_text().strip() != t['boot_id_before']
state = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert 'BootNext:' not in state
assert re.search(r'^BootOrder: (.+)$', state, re.M).group(1) == Path('boot-order-before.txt').read_text().strip()
line = next(line for line in state.splitlines() if line.startswith('Boot' + number + '*'))
assert 'UUID change lab' in line and 'UUID1117' in line
shutil.copytree('/boot/efi/EFI/UUID1117', 'efi-results')
Path('boot-id-after-efi.txt').write_text(Path('/proc/sys/kernel/random/boot_id').read_text())
subprocess.run(['efibootmgr', '-b', number, '-B'], check=True)
after = subprocess.check_output(['efibootmgr', '-v'], text=True)
assert 'UUID change lab' not in after and 'BootNext:' not in after
Path('efibootmgr-before-normal-reboot.txt').write_text(after)

确认保存的原厂日志有 W/Done、读后为目标值,再安排第二次普通重启:

Terminal window
systemd-run --unit=uuid-persistence-check --on-active=3s /usr/bin/systemctl reboot
周期实际时间UUID / 启动状态
维护前22:58 后采集默认 UUID,原 boot ID
进入 EFI 写入并链式启动 Ubuntu23:20:13 返回新 UUID,新 boot ID,BootCurrent 为临时项
删除临时项后普通启动23:22:38 返回新 UUID 保持,再次更换 boot ID,BootCurrent / BootOrder 均为 Ubuntu0001

普通重启后的两个独立读取路径一致:

Terminal window
cat /sys/class/dmi/id/product_uuid
sudo dmidecode --no-sysfs -s system-uuid
cat /proc/sys/kernel/random/boot_id
efibootmgr -v

--no-sysfs 的结果也是新 UUID。这里同时具备原厂 W/Done、EFI 回读、新启动周期以及独立物理读取,才把结果记为重启持久性验证通过。

清理与主机恢复#

清理只处理本次创建的对象:

  • 读取 boot-number.txt,按标签和设备路径核对 Boot#### 后删除,不能盲删固定编号。
  • 确认没有本次 BootNext,正常 BootOrder 与维护前一致。
  • 把 BEFORE.TXT、WRITE.TXT、AFTER.TXT、STATUS.TXT、标记文件和工具摘要保存到 root-only 目录。
  • 核对 HOST.ID 属于本次工作后,精确删除 ESP 的 EFI/UUID1117/;保留 Ubuntu 和默认 EFI/BOOT。
  • 对照 Type 1 输出、machine-id、磁盘/分区身份和启动文件摘要。

最终检查可以从这些命令开始:

Terminal window
cat /sys/class/dmi/id/product_uuid
dmidecode --no-sysfs -s system-uuid
cat /proc/sys/kernel/random/boot_id
cmp machine-id-before.txt /etc/machine-id
sha256sum -c ubuntu-efi-before.sha256
dmidecode -t 1 > dmi-type1-final.txt
diff -u dmi-type1-before.txt dmi-type1-final.txt
efibootmgr -v
systemctl --failed
ip -4 address show br0
ip -4 route show
chronyc -n sources
chronyc tracking

本次 Type 1 的 diff 只有 UUID 一行,正常启动项为原 Ubuntu 项,已无临时 BootNext。两次启动后才精确清理工具目录:

from pathlib import Path
import json, shutil
t = json.loads(Path('target.json').read_text())
assert Path('/sys/class/dmi/id/product_uuid').read_text().strip().lower() == t['new_uuid']
assert Path('/proc/sys/kernel/random/boot_id').read_text() != Path('boot-id-after-efi.txt').read_text()
esp = Path('/boot/efi/EFI/UUID1117')
assert 'job=uuid-lab' in (esp / 'HOST.ID').read_text()
assert Path('efi-results/WRITE.TXT').is_file()
shutil.rmtree(esp)

这里删除的是已核对归属的本次目录;不能把整个 ESP 或 EFI/BOOT 当作临时文件清理。

主机验收还包括网络和原有服务:管理地址、默认路由、双 25G/LACP、MTU 和 peer 路由保持;containerd 正常,无 failed unit。原 kubelet 尚未引导,重启后按已有 enabled 设置进入重试,已经停止以恢复接入暂停前的状态,enabled 设置保持。

时间服务最初还在等待长轮询结果。我只对原来配置的服务器触发一次 chronyc burst 4/4,没有更换服务器或修改配置;之后源选中,Leap Normal、NTPSynchronized=yes,系统偏差约 0.207 ms。

新 UUID 也同步到后续 worker 准备参数中。修改固件身份不等于恢复集群接入,没有创建 Node、bootstrap token 或 CSR。已有四节点、etcd、Ceph 和业务 VMI 在维护前后复核正常。

回退输入与仍未覆盖的部分#

保存的旧 UUID 对应原始编码为:

00020003000400050006000700080009

若确实需要回退,方法是在新的维护窗口内,用同一原厂 EFI 工具写回该值,再重复读取、普通重启与清理验收。本次没有执行回退写入,也没有做断电冷启动;不能把这两个项目写成已完成。

只读研究副本也有明确限制:它只针对附件锁定的 5.16 二进制、当前机器的真实兼容入口和小于 4 GiB 的有限表布局。它不是 SMBIOS 3.6 通用写入实现,不能拿来解除保护后修改。最终写入成功的证据只适用于本次主板、固件和原厂 EFI 工具组合。

工具来源、摘要与完整附件#

下面的 hash 标识本次实际使用或核对的文件。上游更新下载包后若摘要不同,应重新检查版本与内容,不能把新文件当作已验证的同一个输入。AMI 程序不在本站重分发。

文件本次 SHA-256
SECO 工具包9908a80c61565be1c76896ce12bb6d4fe3bc5b78df50c3b457465227c731d161
SECO AmiDeLnx64ad17835da08f24bcc1312f7dcb5864f9d29473fc0d69b9cc573b18adaa6f9c15
ASUS NUC 工具包1647aeb98a84b86286056d2b60a8f87d56677b928f45f9f674548386cf40eb4c
技嘉 GSM CLI 1.00 包e6995cc1e9ff4f9d0f8309f0966861e0d8716225f9b57d9c4f007e72d830c6e8
技嘉包内 amidelnx_26_64 5.16262741f55220b1a69d2ae1a2f72ffe1b6a70f6c11b29e4968b52369216e5fe6e
Qotom SN&UUID 包9d72e178da7b0585bf4365b02bbbcb193a40576a3d277a6da4147a80448d45f0
包内 AMIDEEFIx64.EFI 5.27.04.0014d485d2dad404177d5af73edafc9645add9a6f2f2c1e098913c3f9fe880192e86
Shell X64 26H24922d9885ac92d8ab58e5da4eb8ad6cbfbe651ea9cdc03a1ba67355e5ede83b1

SECO、ASUS 发行包来自各自产品支持渠道;技嘉包从官方工具列表取得;Qotom 包从其官方目录取得。ASUS 整包与 Shell 文件还核对了发布方公布的摘要。未给出发布方独立摘要的文件,这里的 hash 用于固定本次输入,不冒充另一份供应商签名证明。

本文配套的源文件:

其中的探针生成器只生成只读研究副本,不创建启动项、不重启、不写 UUID;EFI 模板必须先完成新值替换和校验,再进入独立维护流程。此次真正完成持久修改的步骤,是原厂 EFI 工具单次写入,以及删除临时项之后的普通重启验证。