开始之前——60 秒预检

• 知道你显卡的 PCI 地址——运行 lspci -D 并记下来（如 0000:21:00.0）。指定特定显卡时你需要它，事后验证也靠它。
• 知道如何在启动时一次性编辑引导加载器条目——那是你的逃生口：在引导加载器的编辑界面里删掉参数，就能得到一次原厂启动，不需要动手术。
• 保存你当前的内核命令行（cat /proc/cmdline）到一个离线也能拿到的地方，这样你能原样恢复它。
• 多卡？优先用显式的 PCI 目标，不要用 all——点名你想处理的那几张卡，其余的不碰。
• 第一次重启时要有控制台或物理访问——已记录的失败模式（见下文）靠关机处理，不靠远程乱戳。

你需要准备什么

• 一张受支持的显卡（GA102 / GA103 / GA104 / GA106）——见兼容性列表。
• 一个 Arch、Debian/Ubuntu 或 Fedora/RHEL 家族的 Linux 发行版——make install 会从 /etc/os-release 自动检测。在其他发行版上，使用下面的显式构建目标。
• 原厂的、未经修改的 NVIDIA 驱动。本模块的全部意义就在于驱动保持原样不动。
• sudo 权限。构建过程会通过 HTTPS 下载固定的 NVIDIA/CachyOS 输入并校验它们的 SHA-256 哈希；固件在构建目录中本地生成。

第 1 步——克隆并安装

注意：克隆拉取的是当前的默认分支，可能比本指南审校时依据的 commit（af28cbb）更新。

git clone https://github.com/Zagitta/gpu-unlock
cd gpu-unlock
make install

make install 会检测你的发行版并选对安装方式。显式变体如下：

make install-arch   # makepkg -sif
make install-deb    # apt-get build-dep, dpkg-buildpackage, apt-get install
make install-rpm    # dnf builddep, rpmbuild, dnf install

make arch、make deb 和 make rpm 只构建软件包而不安装（Debian 和 RPM 软件包分别落在 build/deb 和 build/rpm）。安装会把模块及其固件放进你的 initramfs——在 mkinitcpio 下，一个 drop-in 会把 gpu_unlock 放在 MODULES 中 nvidia 的紧前面，让显示输出显卡黑屏的时间尽可能短；initramfs-tools 和 dracut 也有等价的 drop-in。镜像会在安装时重建。

第 2 步——在内核命令行上启用

模块在你告诉它要解锁哪些卡之前什么都不会做。把 gpu_unlock.targets=all 追加到你的内核命令行，保留你现有的选项：

• GRUB（Debian/Ubuntu/Mint）：把它加进 /etc/default/grub 的 GRUB_CMDLINE_LINUX_DEFAULT 里，然后运行 sudo update-grub。
• GRUB（Arch/CachyOS）：同样的修改，然后运行 sudo grub-mkconfig -o /boot/grub/grub.cfg。
• Fedora/RHEL：运行 sudo grubby --update-kernel=ALL --args="gpu_unlock.targets=all"。
• systemd-boot：把它追加到你的启动条目中的 options 行（bootctl status 会显示它在哪）。
• UKI / 生成的条目：把它加进 /etc/kernel/cmdline 并重新生成你的启动镜像（如 mkinitcpio UKI 用 sudo mkinitcpio -P）。

除了 all，你也可以用完整的 PCI 地址指定具体的卡，就像 lspci -D 打印的那样：

gpu_unlock.targets=all                            # every unbound GA102/103/104/106 card
gpu_unlock.targets=0000:21:00.0                   # only this card
gpu_unlock.targets=0000:21:00.0,0000:22:00.0      # comma-separated list

地址与 GPU 编号和显示角色无关。任何不是 GA102/GA103/GA104/GA106 的卡——包括把 all 和地址混用——都会被记录并忽略。不管你有几张卡，解锁总共大约需要一秒；每张卡单独处理，已经被绑定或已断电的卡会被跳过。

第 3 步——重启并验证

重启，然后查看内核日志：

journalctl -k -b | grep gpu_unlock
lspci -nnk -s 0000:21:00.0   # your card's address

然后运行你常用的 FP16/BF16 工作负载或 GEMM 基准测试做对比。有几个行为值得知道：

• 显示输出显卡也能用。它的控制台帧缓冲在解锁期间保持运行，在复位前才被移除；从复位到 nvidia-drm 接管之间屏幕会黑屏——这和驱动稍后自己会做的事一样。
• 开机后手动加载模块没有任何作用，对一张已经被 NVIDIA 驱动绑定的卡而言。时机就是全部诀窍所在。
• 挂起到内存（睡眠）会重置选择器（显卡会断电），所以模块会在唤醒时、在驱动恢复它们之前，重新解锁它在启动时处理过的卡——预计唤醒会多花大约一秒。可以用 gpu_unlock.resume=0 关掉这一行为。休眠不在覆盖范围内。
• 多卡、显示与虚拟机配置都有可用的报告——用户报告覆盖一台机器里最多四张卡，以及用 vfio-pci 直通给虚拟机的显卡。

回滚——如何撤销一切

有一种失败模式要认真对待：如果某张卡上运行的固件始终没有停下来，模块会记录下来，并刻意保留那固件可能仍在使用的 DMA 缓冲区，直到下一次关机。重试前先关机——不要一直去戳它。

许可证与来源

内核模块和本地打包是 GPL-2.0-only。生成的载荷派生自固定的 CMP 参考实现；NVIDIA 固件仍受其自身条款约束——归属说明见项目的 firmware/NOTICE.md 和 licenses/ 目录。如果它对你有用，项目页里有支持其作者的方式。