nullmoth/nvidia-macos-driver · 上手攻略

仓库：nullmoth/nvidia-macos-driver
链接：https://github.com/nullmoth/nvidia-macos-driver
分类：Hackintosh · GPU 驱动
作者：Jay
更新：2026-10-11

§0 速览

是什么： 在 macOS 15 Sequoia 上运行 NVIDIA GeForce RTX 系列显卡的第三方 Metal 驱动，由独立开发者 NullMoth 从零构建，代码完全开源。

解决什么问题： 2018 年后苹果与 NVIDIA 合作终止，macOS 对新 NVIDIA 显卡失去官方支持；此驱动让 RTX 20/30/40/50 系列（以及部分 Quadro/RTX 工作站卡）在 Intel Mac 和 OpenCore 免越狱机上重新跑起 Metal 加速桌面渲染和图形应用。

当前状态： 实验性。实测验证仅覆盖 RTX 5060（macOS 15.7.x / 15.8.1）；设备表中列出更多型号但未经物理验证。

§1 是什么 / 解决什么问题

长期以来，macOS 对 NVIDIA 显卡的官方支持停留在 2018 年前的 Kepler 架构。苹果转向 AMD 和自研 Apple Silicon 后，社区普遍认为在 macOS 上运行现代 NVIDIA GPU「不可能」。NullMoth 以一人之力打破了这个共识。

该驱动的架构分两层：

Metal 驱动插件（NVMTLDriver.bundle）：应用通过 Metal API 与驱动交互，驱动内部将 Apple AIR 字节码翻译为 SPIR-V，再经 Mesa NVK（基于 mesa 17ca6174）编译后送至内核模块。
内核扩展（NVRM / NVAccel / NVRMFB / NVRMAGDC）：直接调用 NVIDIA 官方开源 GPU 内核模块（r610.57.04），NVRMFB 负责显示Framebuffer，NVAccel 提供 WindowServer 合成加速。

支持的显卡包括：GTX 16 系列、RTX 20/30/40/50 系列、TITAN RTX，以及部分 Quadro/RTX 工作站卡。⚠️ 设备表覆盖范围大于物理验证范围，未列型号不一定不支持，已列型号不一定全部验证过。

支持的 API/框架：Metal 3（argument buffers tier 2、ray tracing、mesh shaders、MPS、MetalFX）、OpenGL（通过 Apple GL-on-Metal）、OpenCL、Core Image、Core ML。

§2 快速安装

方式一：1401 辅助安装（推荐新手）

从 Releases 下载 1401-Mac-<version>.dmg
打开 dmg，运行 1401 应用（驱动包已内置，无需单独下载驱动）
按向导步骤操作：应用会自动找到本机 OpenCore 分区、显示改动预览、备份原配置
安装完成后选择「移除 NVIDIA 驱动」可完整还原（OpenCore 配置一并恢复）

⚠️ 安装前必须先有可正常启动 macOS 的 OpenCore 配置；macOS 安装本身参考 OpenCore Install Guide。

方式二：手动安装 tarball

# 1. 下载最新 release 的 nullmoth-nvidia-<version>.tar.gz
# 2. 解压并校验
tar -xzf nullmoth-nvidia-*.tar.gz && cd pkgroot
shasum -a 256 -c SHA256SUMS   # 每行必须输出 OK

# 3. 安装（需要 sudo）
sudo ./install.sh              # 复制文件并重建 Auxiliary Kernel Collection

# 4. 重启（必须重启，logout 不够）
sudo shutdown -r now

# 5. macOS 会弹出安全提示：System Settings → Privacy & Security → 允许扩展
#    再重启一次

NVRAM 必须添加的参数（OpenCore 配置）

在 NVRAM → Add → 7C436110-AB2A-4BBB-A880-FE41995C9F82 下添加：

Key	Value	说明
`csr-active-config`	`<430A0000>` (Data)	允许加载未签名内核扩展
`boot-args`	`nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_1 amfi=0x80 ipc_control_port_options=0`	Framebuffer + 加速器 + 4显示头；AMFI 参数允许 WindowServer 加载驱动

UEFI → Quirks → ResizeGpuBars：设为 13（8 GB BAR 全带宽）
Booter → Quirks → ResizeAppleGpuBars：设为 -1（macOS 识别完整 BAR）

⚠️ 注意：macOS 安装镜像阶段需要相反的 BAR 设置（ResizeAppleGpuBars 0、ResizeGpuBars -1、不禁用 IONDRVSupport），安装完成装驱动后再切回来。

BIOS 必须开启

Above 4G Decoding：ON
CSM：OFF

验证安装结果

kmutil showloaded --list-only | grep nullmoth
# 应输出 4 行（4 个内核扩展）

system_profiler SPDisplaysDataType | head -20
# 应显示 GeForce 型号，Metal: supported

§3 核心用法

日常使用

安装完成后，NVIDIA 显卡接管显示输出。应用通过 Metal API 调用 GPU 加速，无需额外操作。

卸载

cd /path/to/pkgroot   # 最初解压的目录
sudo ./uninstall.sh
sudo shutdown -r now

1401 应用辅助操作

1401 还提供：USB 端口映射、崩溃报告生成（发送到 NullMoth Discord，带 SHA-256 脱敏）。驱动崩溃时打开 1401 → Crash report → Send logs，附上 Report ID 即可在 Discord 反馈。

§4 典型适用场景

Hackintosh 党：在 OpenCore Intel 平台上使用高端 NVIDIA 显卡（如 RTX 5060）运行 macOS Sequoia，获得 Metal 3 加速桌面体验。
双系统党：macOS + Windows/Linux 共存，OpenCore 引导菜单保留 Windows 启动项。
图形/渲染开发者：需要 NVIDIA CUDA 生态但又想在 macOS 上跑特定 Metal 应用或游戏（通过 Metal→NVidia 驱动层）。

⚠️ 不是游戏驱动：MetalFX 等特效可以调用，但 macOS 游戏生态本身对 NVIDIA 支持很差，此驱动解决的是桌面渲染和计算加速，而非游戏兼容性问题。

§5 坑与注意

安装后第一次启动卡在「PCI configuration end」：正常，等待最多 1 分钟让 GPU 初始化。
macOS 安装镜像阶段 BAR 参数相反：装完 macOS 原版后立即装驱动时，必须先改回驱动所需的 BAR 设置。
SIP / AMFI 必须正确配置：csr-active-config 和 boot-args 中的 AMFI 参数缺一不可，否则 WindowServer 拒绝加载驱动。
GTX 16 系列用户注意：部分较老的 Pascal 架构卡在设备表中有争议（Turing 之后才被明确支持），建议先查 CARD-SUPPORT.md。
内核扩展不要双重注入：不要同时通过 OpenCore EFI/OC/Kexts 注入这些驱动，否则可能冲突。
RTX 5060 以外型号验证不足：设备表 ≠ 实机验证；提交 Issue 前请附上 1401 生成的硬件报告（包含脱敏的日志）。
未获 Apple 官方认可：系统安全机制会阻止加载未签名内核扩展；NVRAM 参数调整不可跳过。
不稳定风险：实验性软件，生产环境慎用。

§6 与同类对比

	nullmoth 驱动	Apple 官方 Metal（AMD/Apple Silicon）	WebGPU（浏览器）	NVIDIA macOS 旧闭源驱动（~2018）
目标硬件	NVIDIA RTX/GTX（Hackintosh）	AMD GPU / Apple Silicon	跨浏览器	仅旧 NVIDIA 卡（macOS High Sierra）
开源	✅ 完全开源	❌ Apple Silicon 驱动闭源	✅ WebGPU 标准	❌ 闭源，已停止支持
Metal 3 支持	✅	✅	❌	❌
OpenCore 兼容	✅	N/A	N/A	❌（需越狱）
状态	实验性	成熟	标准	停止维护

§7 一句话结论

NullMoth 的 nvidia-macos-driver 是 2018 年后首个让现代 NVIDIA RTX 显卡在 macOS Sequoia 上跑起 Metal 3 桌面的开源方案，适合 Hackintosh 玩家和技术开发者尝鲜，但属实验性软件，生产环境慎用。

数据来源：GitHub README (fetch 2026-10-11) · VideoCardz · YouTube (litemint09) · Trendshift · 1401 Release 页