许可证本来就在固件里

很多人拥有 Fisher-Price OS (Windows) 的许可证,却从没见过它的产品密钥。 它随机器一起来,密钥就存在那台机器的固件里,一张叫 MSDM 的小小 ACPI 表中。

然后,这台机器不再是干活的地方了。 要么它的主人想把这个许可证用在一台现在从你这里租的虚拟机里,要么机器本身被抹掉,改成 Proxmox 主机,而出厂自带的那份操作系统想作为虚拟机放回上面。

从机制上说,这只是一个 QEMU 选项。 问题恰恰在这里。 QEMU 把任何表交给客户机,不做任何检查,客户机拿到什么密钥就用什么激活,整个技术栈里没有任何一处去问许可证是否允许这样做。 本文讲这张表是什么,怎样把它放进虚拟机而不传过去一张坏表,Microsoft 的条款对迁移它怎么说,以及为什么批量许可证从不靠近它。

这张表是什么

从 OEM Activation 3.0 开始,PC 厂商不再把密钥印在机箱底部的贴纸上、让任何拿手机相机的人都能抄走,而是把密钥写进机器的固件。 Microsoft 的工厂工具“injects the product keys into the firmware”,它的校验步骤检查“that the MSDM table exists”,以及表头和条目“comply with the correct formats”1。 这样配置的机器“activated by using the OA3 DPK in the firmware”2。 MSDM 是一张普通的 ACPI 表,在 Linux 上可以直接从固件读出来:

sudo cat /sys/firmware/acpi/tables/MSDM > msdm.bin

写这篇文章用的笔记本电脑上就有一张。 85 字节。

Microsoft 公开的规范定义了标准的 36 字节 ACPI 表头,签名为 MSDM,然后就没了。 表头之后的一切都是“Proprietary data structure that contains all the licensing data necessary to enable Windows activation”3。

字节内容依据
0 到 35标准 ACPI 表头:签名 MSDM、长度、校验和、OEM IDMicrosoft 的规范
36 到 5520 字节的字段:版本、数据类型、数据长度真实的表,而非公开规范
56 到 8429 个字符的产品密钥,五组,每组五个真实的表,而非公开规范

你给 QEMU 什么,它就传什么

QEMU 的 -acpitable file= 接受“whole ACPI table from the specified files, including all ACPI headers (possible overridden by other options)”4,客户机看到的 MSDM 表和笔记本固件呈现的一模一样。 这一点用一个故意伪造的密钥验证过。 字节从另一头出来时完全相同,从签名到最后一个字符。

QEMU 什么都不拒绝。 下面是 hw/acpi/core.c 对一份坏上传的处理5:

文件哪里有问题QEMU 怎么做客户机看到什么
表头长度与文件不符发出警告,然后用真实大小覆盖长度一个有效的表头
校验和加起来不为零重新计算,每张表、每一次都算一个有效的校验和
密钥被截断或损坏什么都不做,表头之后的数据不归它管一张看似有效的表,包着一个坏密钥

客户机无从分辨其中的区别,你也一样,直到有人提交工单。 第一个听说这事的,是一个激活失败的客户。

所以,如果客户要上传这些表,就在 QEMU 看到它们之前先检查:

#!/usr/bin/env python3
"""Refuse anything that is not a well-formed MSDM table before QEMU sees it."""
import re, struct, sys

t = open(sys.argv[1], 'rb').read()
fail = lambda why: sys.exit(f"{sys.argv[1]}: {why}")

if len(t) < 56:                       fail(f"{len(t)} bytes, too short for an MSDM table")
sig, length = t[:4], struct.unpack_from('<I', t, 4)[0]
if sig != b'MSDM':                    fail(f"signature is {sig!r}, not MSDM")
if length != len(t):                  fail(f"header says {length} bytes, file is {len(t)}")
if sum(t) & 0xff:                     fail("checksum does not sum to zero")
ver, _, dtype, _, dlen = struct.unpack_from('<5I', t, 36)
if (ver, dtype) != (1, 1):            fail(f"version {ver}, data type {dtype}: expected 1 and 1")
if dlen != 29 or 56 + dlen != length: fail(f"data length {dlen}: expected 29")
key = t[56:].decode('ascii', 'replace')
if not re.fullmatch(r'([0-9A-Z]{5}-){4}[0-9A-Z]{5}', key): fail("data is not a 5x5 product key")
print(f"OK  OEM {t[10:16].decode(errors='replace').strip()!r}  key *****-*****-*****-*****-{key[-5:]}")
检查项对照的标准失败意味着
签名、长度、校验和Microsoft 有文档的表头文件坏了
版本、数据类型、数据长度、密钥形状真实的表所具有的形状人工看一看这一份,而不是“这是伪造的”

它从不打印密钥,只打印最后一组。 日志文件里的产品密钥,就是别人也能用的产品密钥。

对一张好表和它的三份坏副本运行的结果:

OK  OEM 'EXMPLE'  key *****-*****-*****-*****-EEEEE
bad-sum.bin: checksum does not sum to zero
bad-trunc.bin: header says 85 bytes, file is 70
bad-sig.bin: signature is b'SLIC', not MSDM

它放在哪里,谁能把它放进去

从客户上传到客户机用来激活的密钥客户的表msdm.bin,85 字节来自他们自己的机器校验器签名、长度、校验和、密钥形状存放/etc/pve/priv/仅 root,每个节点虚拟机 args-acpitable file=仅 root 可设置QEMU改写长度,重算校验和,什么都不拒绝客户机ACPI 中的 MSDM,激活程序读取密钥
校验器放在 QEMU 前面,因为 QEMU 会修补坏表头而不是拒绝它。这张表存放在集群文件系统的私有部分,所以它跟着虚拟机去往任何节点,并且只有 root 能读。

产品密钥是一项机密。 它不该放在任何 www-data 能读到的地方,而 pmxcfs 在 /etc/pve 里恰好只给你一个它读不到的位置6:

这张表可以放在哪里谁能读在虚拟机可迁移到的每个节点上都有
/etc/pve/priv仅 root是
/etc/pve 中的其他任何地方组可读,包括 Web 界面的 www-data是
某一个节点上的目录你设成什么就是什么否

85 字节,离 pmxcfs 1 MiB 的文件上限还差得远7:

mkdir -p /etc/pve/priv/msdm
check-msdm.py upload.bin && cp upload.bin /etc/pve/priv/msdm/9000.bin
qm set 9000 --args "-acpitable file=/etc/pve/priv/msdm/9000.bin"

qm set --args 会替换整行。 如果虚拟机的 args 里已经有 SMBIOS 或固件选项,就把它们全部一起写出来。 而且因为 args 仅限 root,这是你的开通流程该做的事,不是客户能在 Web 界面里自己做的。 这样才是正确的方向。 客户提供文件,你的工具检查它并挂上去。

这张表迁移的是密钥,不是权利

这里需要头脑清醒。 把 MSDM 表迁进虚拟机,迁的是密钥。 不是许可证。

Microsoft 自己的条款就是这么说的,要紧的几句放得进一张表:

情形Microsoft 怎么说来源
OEM 许可证,迁移可转让给另一个用户,“only with the licensed device”OEM 许可条款8
OEM 许可证,可装几份“only one instance of the software for use on one device, whether that device is physical or virtual”OEM 许可条款8
OEM 许可证,说白了“locked”在原来那台 PC 上,“and cannot be transferred to any other PC”Microsoft 小企业博客9
例外在德国或其他所列国家购得软件的,转让条款“do not apply”OEM 许可条款8
为客户托管Services Provider License Agreement 用于“hosted applications to end customers”SPLA10
桌面版作为托管虚拟机“VMs must be hosted by a Qualified Multitenant Hoster (QMTH)”Microsoft Learn11

这张表总是来自客户自己那台获许可的机器,绝不来自你的主机。 完全落在条款字面之内的情形是最简单的那个:许可证随之出售的那台机器,现在跑着 Proxmox,同一份 Fisher-Price OS (Windows) 被迁进它上面的一台虚拟机。 这仍然是一台设备上的一个实例,OEM 条款允许这样做,“whether that device is physical or virtual”8。 第二台虚拟机,或者换一台机器,就不行了。

在这一种情形里,客户的机器和虚拟化主机是同一台,所以没有什么要上传,也没有什么要复制。 Proxmox 内核已经在 /sys/firmware/acpi/tables/ 下暴露了固件的 MSDM 表,仅 root 可读,而 Proxmox 上的 QEMU 以 root 运行,所以它可以直接从那里取表:

qm set 100 --args "-acpitable file=/sys/firmware/acpi/tables/MSDM"

指向实时的表而不是一份副本,有两个后果。 这个路径在虚拟机启动的那个节点上读取,所以这属于单机主机,不属于集群:迁移虚拟机后,它要么拿到那个节点的表,也就是另一台机器上的另一个许可证,要么根本启动不了,因为 QEMU 对不存在的文件会报 can't open file … No such file or directory 并拒绝。 而且它只有一行,也就是说粘贴到第二台虚拟机上也只要一行。 第二台虚拟机正是条款不覆盖的情形,所以只给一台虚拟机,别的都不给。

所以,去做这个功能。 机制是可靠的,也确实有客户有权使用它;在德国买许可证的客户很可能就是其中之一。 但要把授权放在它该在的地方:在你的服务条款里,由客户保证他们持有的许可证涵盖在你的虚拟机里运行它,而且在上传按钮起任何作用之前就做出保证。 校验器证明这张表格式正确。 没有任何东西能证明它归他们使用。

批量许可证从不靠近这张表

持有批量许可证的客户能走同一条路吗? 不能。 这张表根本没有东西可装。

MSDM 属于 OEM 渠道,别无其他。 Microsoft 自己的规划指南说,OEM 激活“is available only for computers that are purchased through OEM channels and have the Windows operating system preinstalled”12。 批量许可证通过另外三种模式之一激活:“Multiple Activation Keys (MAK)”、“KMS”和“Active Directory-based activation”12,每一种里密钥都装在操作系统中。 没有任何东西从固件读它。

方式密钥在哪里客户机和谁通信在 Proxmox 虚拟机里
OEM,OA 3.0固件中的 MSDM 表Microsoft 的激活服务器上面的 -acpitable 路线
MAK装在客户机里Microsoft,一次,计入该密钥的激活次数能联网或打电话就行
KMS客户机里的通用密钥(GVLK)客户在 TCP 1688 上的 KMS 主机需要一条通往它的路由,并且要有 25 台客户端或 5 台服务器才会激活任何东西
Active Directory客户机里的 GVLK客户的域控制器,至少每 180 天一次需要虚拟机加入他们的域
AVMA客户机里的通用密钥Hyper-V 主机自己的 Datacenter 许可证完全不可用

所以对批量许可客户来说,虚拟化主机上没有什么要做的。 他们的密钥放进他们的镜像,你的那部分是网络路径:通往他们 KMS 主机的 1688 端口,或者通往他们域控制器的 VPN。 MSDM 的位置保持空着,也本该空着。

有两件事常让人栽跟头。 批量介质上的通用密钥本身什么也激活不了,因为“the GVLK doesn’t work unless a valid KMS host key can be found”12,所以用客户的 Enterprise ISO 搭起来、却没有回家路由的虚拟机,就一直处于未激活状态。 另外,桌面批量许可证本身并不是一个完整的许可证。 批量计划“cover upgrades to Windows client operating systems only”,并且“an existing retail or OEM operating system license is needed for each computer”12。 批量许可证叠在一个基础许可证上面,往往正是上一节讲的那个 OEM 许可证,而它能否在你的虚拟机里运行,仍然是那张表里的托管问题,而不是激活问题。

AVMA 值得单独说一句,因为它看起来就像答案。 它是 Microsoft 让主机激活自己的服务器客户机的方法,把“the VM activation to the licensed virtualization host”绑定起来,并且要求“a Windows Server Datacenter edition with the Hyper-V server host role installed”13。 其余的部分 Microsoft 说得很直白:“AVMA doesn’t work with other server virtualization technologies”13。 在 Proxmox 上,服务器客户机通过你的 SPLA 密钥或客户自己的 KMS 激活。

技术栈里没有谁检查手续

这里的每一层都只做自己的事,一点不多。 固件存一个密钥。 QEMU 复制字节,顺手整理表头。 客户机读取密钥并用它激活。 它们没有一个能分辨底下的机器是不是许可证随之出售的那台,也没有一个本来就该管这事。

所以这项检查落到了运行虚拟化主机的人身上。 许可证是买它的人和 Microsoft 之间的协议,你的平台不是协议的一方,但移动密钥的正是它,这就让这个问题成了你的,不管你愿不愿意。

在上传按钮起任何作用之前,把答案写下来。 一台机器,一台虚拟机,客户自己的许可证,以及他们保证许可证涵盖这种用法的承诺。 这不花你一分钱,而且对你的保护和对他们的一样多。 软件会搬动别人交给它的任何密钥。 它该不该搬,是只有人才能回答的问题,所以要确保有人回答过。


  1. Microsoft Learn, OA 3.0 on the factory floor — “injects the product keys into the firmware”;/Validate 检查“that the MSDM table exists”。 ↩︎

  2. Microsoft Learn, Validate an OEM Activation key — “is activated by using the OA3 DPK in the firmware”。 ↩︎

  3. Microsoft, Microsoft Software Licensing Tables (SLIC and MSDM) — 表 2,偏移 36:“Proprietary data structure that contains all the licensing data necessary to enable Windows activation.” ↩︎

  4. QEMU, System Emulation, Invocation — 各类型的 -smbios 字段;-acpitable“For file=, take whole ACPI table from the specified files, including all ACPI headers”;-boot“Currently Seabios for X86 system support it.” ↩︎

  5. QEMU v11.0.3, hw/acpi/core.c — “ACPI table has wrong length”只是一个 warn_report,随后长度被覆盖,校验和被重新计算。 ↩︎

  6. pve-cluster, src/pmxcfs/pmxcfs.c — priv 下的路径被屏蔽为 0777700,其余一切为 0777750。 ↩︎

  7. pve-cluster, src/pmxcfs/memdb.h — #define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB。 ↩︎

  8. Microsoft, Windows 11 OEM licence terms — “you may transfer the license to use the software directly to another user, only with the licensed device”;转让条款“do not apply if you acquired the software in Germany”或所列国家。存档副本;现行页面拒绝自动化请求。 ↩︎ ↩︎ ↩︎ ↩︎

  9. Microsoft, small business blog archive — “the OEM Windows license is ’locked’ to the original PC it comes with and cannot be transferred to any other PC.” ↩︎

  10. Microsoft, Services Provider License Agreement — “for service providers and software development companies licensing eligible Microsoft products to provide software services and hosted applications to end customers.” ↩︎

  11. Microsoft Learn, Windows subscription activation for VDA — “VMs must be hosted by a Qualified Multitenant Hoster (QMTH).” ↩︎

  12. Microsoft Learn, Plan for volume activation — 三种批量激活模式;KMS 的门槛:服务器“at least five computers”,客户端“at least 25 computers”,使用 TCP 1688 端口;基于 Active Directory 的激活需要域“at least once every 180 days”;“the GVLK doesn’t work unless a valid KMS host key can be found”;批量许可证“cover upgrades to Windows client operating systems only”。 ↩︎ ↩︎ ↩︎ ↩︎

  13. Microsoft Learn, Automatic Virtual Machine Activation in Windows Server — “AVMA requires a Windows Server Datacenter edition with the Hyper-V server host role installed”;“AVMA doesn’t work with other server virtualization technologies.” ↩︎ ↩︎