NullMoth 驱动：macOS Metal 驱动

项目简介

NullMoth NVIDIA Driver 是一个开源 Metal 驱动，让 NVIDIA GeForce 显卡在 macOS 15 Sequoia（也支持 26 Tahoe，x86_64）上工作，适用于 Intel Mac 与 OpenCore PC。内核扩展、Metal 插件和着色器翻译器都在本仓库中；负责安装的 1401 应用是独立项目。

支持的显卡为 Turing 及更新架构：GTX 16、RTX 20 / 30 / 40 / 50、TITAN RTX、Quadro RTX 和 T 系列。大部分测试在 RTX 5060 上完成，其他显卡可能存在尚未发现的问题。

工作链路：

Metal app -> NVMTLDriver.bundle -> 翻译器（Apple AIR -> SPIR-V）-> NVK（Mesa Vulkan + NAK）-> kexts -> GPU

主要功能

• Metal 3：argument buffers tier 2、光线追踪、mesh shader、MPS、MetalFX 路径
• 同时支持 OpenGL（经 Apple 的 GL-on-Metal）、OpenCL、Core Image、Core ML
• 内核侧运行 NVIDIA 开源 GPU 内核模块（r610），包含 NVRM、NVAccel、NVRMFB、NVRMAGDC 等组件
• 双系统友好：不触碰其他磁盘，OpenCore 选择器可同时启动 Windows 与 Linux

安装与使用

推荐使用 1401 Mac 应用：从 Releases 下载 1401-Mac-<version>.dmg，打开运行后按提示操作。它会找到启动本机的 OpenCore 分区、在改动前展示每一项变更并备份配置、安装驱动，并在启动菜单加入「1401: Remove NVIDIA driver」用于回滚。安装期间及之后每次重启，都要插着 OpenCore 所在的 U 盘或磁盘。

手动安装（自行管理 OpenCore 配置时）：

tar -xzf nullmoth-nvidia-*.tar.gz && cd pkgroot
shasum -a 256 -c SHA256SUMS
sudo ./install.sh
sudo shutdown -r now

OpenCore 需要满足：

• boot-args 包含 nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_way=0x1 amfi=0x80 ipc_control_port_options=0
• csr-active-config 包含 0x0A43
• Misc > Security > SecureBootModel 设为 Disabled
• Lilu.kext 与 AMFIPass.kext 已加入 Kernel > Add 并启用

重启后验证：

kmutil showloaded --list-only | grep nullmoth
system_profiler SPDisplaysDataType | head -20

前者应显示 4 行，后者应显示你的 GeForce 与 Metal: supported。

卸载：

sudo ./uninstall.sh && sudo shutdown -r now

注意事项

• 系统要求：macOS 15.5 Sequoia 或更新（或 26 Tahoe），x86_64
• BIOS 需开启 Above 4G Decoding、关闭 CSM；SMBIOS 需选支持 macOS 15 独显的机型（测试用 iMacPro1,1）
• 首次安装后要在「系统设置 → 隐私与安全性」中允许扩展，然后再重启一次
• kext 装在 /Library/Extensions 并通过 Auxiliary Kernel Collection 加载，不要再从 EFI/OC/Kexts 注入
• 若同时装有 WhateverGreen（用于 Intel / AMD 显卡），需在 boot-args 加 gfxrst=4，否则可能 panic
• 需要移除 nv_disable=1、WhateverGreen 的 NVIDIA 补丁和 agdpmod=pikera
• 排障用 boot-arg：-nvrmnoflip（桌面闪烁/撕裂）、-nvrmnogo、-nvrmnobootscreen、-nvrmnopm（关闭睡眠支持）
• 授权：plugin/、kexts/、build/、package/ 采用 PolyForm Noncommercial 1.0.0，免费且含源码，但禁止任何商业用途；translator/ 为 LGPL-3.0-or-later；nvk/ 为 MIT；GSP 固件遵循 NVIDIA 的可再分发固件许可

本作品整理自 GitHub 开源项目 nullmoth/nvidia-macos-driver，原作者 @nullmoth。中文介绍由 AI 根据项目 README 整理，以原仓库为准。