简介
黑苹果都已经几乎走完生命周期(目前最新版本 Golden Gate 不再支持 Intel 处理器),就在此时,天空一声巨响,NVIDIA 的 macOS 驱动居然闪亮登场了?
开个玩笑,此驱动并非 NVIDIA 官方提供,是第三方爱好者逆向开发的,目前处于早期阶段,实现了一键安装和基本可用,稳定性和兼容性方面可能还存在一些问题,不过问题不大,至少解决了从无到有不是,感谢开发者 @nullmoth,请访问官方 Github:https://github.com/nullmoth/nvidia-macos-driver 并支持作者,以下是官方简介:
NullMoth NVIDIA Driver for macOS:适用于运行 macOS 15 Sequoia 的 Intel Mac 和 OpenCore 系统上的 NVIDIA GeForce RTX 显卡的 Metal 驱动程序。您的 NVIDIA 显卡可以驱动桌面、Metal 应用程序、游戏、Core ML/MPS 和 OpenCL,就像苹果支持的 GPU 一样。
此驱动程序是新开发的,可能无法兼容每台电脑。它在 macOS 15.7.x 下的 RTX 5060 上进行了测试。如果您的电脑尚未使用 OpenCore 启动 macOS,请先使用OpenCore 进行 macOS 引导,然后再安装本驱动程序。驱动程序如何工作的完整说明在 docs/how-IT-works.md 中。
目前驱动支持情况:
- 前期疯狂更新迭代版本中,每天都有几个新版本,所以如果遇到 bug 不用急,等等版本迭代
- 作者已实测 RTX5060 8GB,macOS Sequoia,作者称 Tahoe 在测试支持阶段
- 其他三方评测和用户实测有证据表明该驱动支持 RTX20/30/40/50 全系
工作原理
Metal app → NVMTLDriver.bundle → translator (Apple AIR → SPIR-V) → NVK (Mesa Vulkan + NAK compiler) → kexts → GPU
内核端在 macOS 下运行 NVIDIA 自己的开放 GPU 内核模块(r610)。NVRMFB 是显示帧缓冲区,NVAccel 是 WindowServer 复合的加速器,NVRMAGDC 是显示策略填隙器。
使用方法
有两种方法,一是命令行(需要一点命令行基础),二是 app(最简单)。
命令行
下载 nullmoth-nvidia-<版本号>.tar.gz,然后命令行操作:
tar -xzf nullmoth-nvidia-*.tar.gz && cd pkgroot
shasum -a 256 -c SHA256SUMS # 所有文件必须反馈 OK
sudo ./install.sh # 复制文件,重建辅助内核集合
sudo shutdown -r now # 需要重新启动:注销不会加载驱动程序
1401 app
下载 1401-Mac-1.0.2.dmg,打开它并运行 1401(驱动程序包在磁盘映像中,因此没有其他可下载的内容)。它会自动找到启动 Mac 的 OpenCore(在 EFI/OC 或 EFI/BOOT 中,在 EFI 或 FAT32 分区上),在进行更改之前显示每一个更改,备份配置,然后安装驱动程序,并将「1401:删除 NVIDIA 驱动程序」添加到 OpenCore 引导选择器中。选择该条目会在下次 macOS 启动时删除驱动程序,并将 Mac 恢复到安装前的状态,包括 OpenCore 配置,然后自行重新启动。
- 双击运行 1401。该工具会定位你的 OpenCore 配置环境,执行修改前展示全部变更项; 自动备份你的 OpenCore 配置文件,从此磁盘镜像安装驱动;同时会在 OpenCore 启动选择菜单增加**“1401: Remove NVIDIA driver(1401:移除 NVIDIA 驱动)”**回退启动项,用于恢复。
- 从 macOS 15 升级至 26:在 1401 工具内点击「Prepare this Mac for Tahoe(为本 Mac 准备 Tahoe 系统)」(该操作同时完成驱动的安装或升级),之后前往系统设置执行系统升级。macOS 26 首次启动时会自动完成驱动部署,并自行重启一次。
macOS 26 Tahoe(测试版):该软件包包含 NVAccel 的 Tahoe 版本。在“系统设置”中更新之前,单击“Prepare this Mac for Tahoe”;Tahoe 的第一次启动会让驱动程序安装并重新启动一次。驱动作者尚未在硬件上测试 Tahoe 兼容性。
在应用程序运行时,将启动 Mac 的 U 盘或磁盘 OpenCore 保持挂载状态:这是它更改的配置。它会寻找并编辑 SMBIOS 型号与 Mac 匹配的 OpenCore config 配置文件,如果没有保持挂在,程序会停止。安装 NVIDIA 驱动后,重新启动系统即可,第一次启动 NVIDIA 驱动时会在“PCI configuration end”时卡住一分钟左右(如果打开了跑码模式)。
config 写入内容和其他注意事项
驱动程序需要的 kexts 会安装到/Library/Extensions中,并从辅助内核集合加载——不需要从 EFI/OC/kexts 再注入它们。OpenCore 只需要设置 SIP 和引导参数。
config.plist → NVRAM → Add → 7C436110-AB2A-4BBB-A880-FE41995C9F82 增加以下内容:
- csr-active-config | 430A0000(Data类型)
- boot-args | nvfb=1 nvaccel=1 nvfbheads=4 -nvkmsnosmooth amfi_get_out_of_my_way=0x1 amfi=0x80(帧缓冲器+加速器,4个显示头;AMFI参数允许WindowServer加载驱动程序包)
同时,以上参数也需要添加到 config.plist → NVRAM → Delete 中,这样每次启动都会重新写入。
其他 OpenCore 的 congfig.plist 设置:
- UEFI → Quirks → ResizeGpuBars → 13(作者用 RTX5060 8GB 做了测试)
- Booter → Quirks → ResizeAppleGpuBars → -1
- Kernel → Block → Identifier 设置为 com.apple.iokit.IONDRVSupport(Strategy 设置为 Exclude)
- Misc → Security → SecureBootModel → Disabled
macOS 安装程序需要相反的 BAR 设置(ResizeAppleGpuBars 0、ResizeGpuBars -1、不 Exclude IONDRVSupport):因为 macOS 默认没有 NVIDIA 的驱动程序,1401 Mac 应用程序在安装 NVIDIA 驱动程序时会切换到上述值。
其他需要的设置
- BIOS:开启 Above 4G Decoding,关闭 CSM
- SMBIOS:选择一款官方能运行 macOS 15 或 26 的 Mac 型号(Macbook Pro 或 MacPro),配备独立 GPU(测试:1401使用的iMacPro1,1)。
- 删除以下启动参数(如果有):nv_disable=1、agdpmod=pikera 或 WhateverGreen NVIDIA 补丁
- NVIDIA 卡不需要设置任何 DeviceProperties
更新日志 · 历史版本
- 仅搭载 NVIDIA 显卡的台式机,在显卡输出无法点亮时不再黑屏循环:此前 WindowServer 会每隔 10 秒因 “无法创建 MetalDevice” 启动失败,直至启动保护机制关闭驱动;现在会依托固件帧缓冲区启动,桌面可加载(无硬件加速),首次登录上报日志,记录显示点亮失败原因。
- Discord 现已和 Chrome 一样通过 ANGLE 启用 Metal(PR:[https://github.com/nullmoth/nvidia-macos-driver/pull/348](https://github.com/nullmoth/nvidia-macos-driver/pull/348),感谢 lukeitsback)。
- Safari、QuickTime、预览及其他沙盒应用,改为调用 macOS 视频解码服务处理 H.264/HEVC,不再在沙盒内解码报错(PR:[https://github.com/nullmoth/nvidia-macos-driver/pull/349](https://github.com/nullmoth/nvidia-macos-driver/pull/349),感谢 lukeitsback)。
- 安装程序可识别仅设置了访问限制 ACL 的 / Library 目录,并标出允许其他账号写入的权限项。
- 若你手动放到 / Library/Extensions 下的内核扩展导致内核集合构建失败,安装器会指明该 kext 并给出迁移方案,不再只笼统提示 “测试内核集合构建失败”。
- 安装包内置全部组件许可文本(NVIDIA 固件协议、开源内核模块协议、Mesa 协议),安装至 /Library/NullMoth/licenses;卸载程序会同步删除这些文件。
- 驱动更新不再自动重新启用可选 EFI 启动图标。新版 Windows 安装包已不含该图标;Mac 端驱动安装会禁用已存在的图标条目,该图标仍可手动启用用于专项测试。
- Mac 安装流程会保留原有 OpenCore 显卡 BAR 与内核放置配置。此前,来自其他主板的固定尺寸参数,会导致原本正常的配置无法引导。
- Mac 更新器现在在下载完成后上报安装、取消或失败状态,不会一直停留在下载提示界面。主设备列表可区分显示应用版本与已安装驱动包版本。加载组件校验会单独统计四项 NVIDIA 组件,避免无关的 Wi‑Fi、DRM 或可选显卡内核扩展,将不完整安装误判为安装成功。新安装内核组件仍需重启才能生效。
- 本次仅修复安装程序与工具本体。内核与图形运行时负载延续 1.14.6 版本不变。高刷显示器切换、小 BAR 显存异常、Chromium 硬件合成、睡眠唤醒故障、特定机型引导 / 内核崩溃问题仍待解决。本版本并未完成全部 macOS 15 机型适配,也未正式支持 Tahoe。
- # 1.12 版本存在的问题及变更内容
- GTX 16 / RTX 20(图灵架构)显卡更新后开机卡死。
- 原因:驱动启动时会固定等待一段时间,待显卡固件(GSP)稳定后再点亮显示器。默认值(0.5 秒)对新显卡足够,但不适用于图灵卡;部分 GTX 1660 SUPER、RTX 2070 SUPER 设备会卡在开机阶段。用户可手动添加启动参数`nvrmsettle=10000`临时解决。
- 修复:程序现在会自动为图灵架构显卡(设备 ID 范围 1E00-1FFF、2180-21FF)添加`nvrmsettle=10000`。若你已手动配置该参数,则保留用户原有设置。
- 启动菜单中的「移除 NVIDIA 驱动」选项仅禁用驱动,不会真正卸载。
- 原因:卸载流程在下一次 macOS 启动时执行,此时 EFI 分区尚未挂载。如果安装记录仅保存了 OpenCore 配置文件路径(/Volumes/EFI/…),或是记录的分区无法挂载,会提示 “找不到记录的配置” 或 “无法挂载记录的 OpenCore 分区”。最终驱动只是被禁用,但文件仍然保留,每次开机均维持该状态。
- 修复:当无法找到记录的配置文件时,卸载程序将使用本机本次启动所用的 OpenCore 分区(也就是弹出卸载选项的引导分区)自动完成卸载并重启。
- 启动菜单「移除 NVIDIA 驱动」执行时卡死,或是瞬间直接退出。
- 原因:工具执行前需要用户按 Y 确认操作。OpenCore 在图形模式下运行该工具,确认提示无法显示在屏幕上,程序一直等待按键输入,60 秒后超时退出。部分设备中,从引导菜单启动时按下的回车键仍留在输入队列,被判定为非 Y 按键,工具直接关闭。
- 修复:该引导项改为文本模式运行,确认提示正常显示;工具会忽略提示弹出前输入的按键。通过 Mac 客户端升级时,会自动更新已有引导项并替换旧工具。
- 崩溃报告会显示更新前产生的崩溃记录。
- 原因:报告会附带近期所有崩溃日志,其中包含旧驱动产生的记录。一个已于 1.12 修复的实况文本(Live Text)崩溃仍会出现在 1.12 的报告里,让人误以为问题未修复。
- 修复:报告内每条崩溃日志附带时间戳,标注该崩溃发生于本次驱动安装之前。
- # 待解决问题
- 部分显示器高于 60Hz 时黑屏 / 闪烁:请使用 1.12 或更新版 Mac 客户端上传日志(会记录每次开机的显示信息)。旧版客户端日志不含相关数据。
- NVIDIA 显卡 HDMI/DP 音频输出:苹果音频控制器仅支持老款 NVIDIA 显卡;运行时修复方案正在开发中。
- **1401 Mac 1.1.1**
- 【日志收集】“Send logs” 现已捕获每次 WindowServer 崩溃前夕的运行记录。
- 针对最近三次 WindowServer 崩溃,日志可保存崩溃前两分钟内驱动以及 WindowServer 自身输出的消息。旧版本仅保留最新日志行,因此启动阶段发生崩溃时,提交日志往往已经丢失了崩溃诱因。
- 驱动、插件消息与内核消息分别设置日志配额,避免某一类日志挤占、冲掉另一类日志内容。
- NVIDIA 驱动版本延续 1.1.0(附件附带 nullmoth‑nvidia‑1.1.0.tar.gz,方便使用)。
- **已知问题(计划后续修复)**
- 双显示器环境下,修改其中一台显示器的刷新率或者分辨率,会导致另一台显示器闪烁或者黑屏,直至重启系统。
- # 1401‑Mac 1.0.13 / 驱动包 1.0.9
- 本次维护版本修复了安装、升级、卸载以及 USB 映射的相关处理逻辑。NVIDIA 内核扩展、Metal 插件、着色器翻译器、Vulkan 后端以及固件与驱动 1.0.8 保持一致。新增的 GPU 兼容性认证与图形功能开发仍延后至 1.1 版本。
- ## 修改内容
- 安装前校验软件包清单,同时校验各系统专属加速组件变体以及内核扩展的精确标识符。
- 正式部署前先构建并检查暂存阶段的内核集合。如果后续安装步骤发生失败,则回滚恢复至上一次安装状态。
- 使用该应用自带经过审计的安装器;下载的驱动包及其校验和保持原样不作修改。
- 执行卸载操作前,校验已记录的 OpenCore 分区、配置以及备份文件。保留无关的配置修改项以及共用 AMFI 标志;仅当安装记录确认归属权时才进行修改;该归属权在经过校验的版本升级过程中持续继承。卸载流程完成前始终保证恢复环境可用。
- 基于当前扩展存储库重建恢复环境,保留其它第三方驱动。拒绝不兼容的备份内核集合;即便重建失败,依旧保留恢复触发入口。
- 卸载成功时清理过期的已安装版本记录,以及由该驱动占用的更新挂起条目。
- 版本解析支持类似 1.1、1.11 这类两段式版本号,按数字版本序处理。重置下载失败状态,允许重试升级。
- 通过注册表路径识别 USB 控制器;保留离散端口编号;强制 15 个端口的选择上限;拒绝过期或者无效的端口选择项。
- USB 扫描结果放置于主任务队列;丢弃已被后续扫描覆盖的旧扫描结果。
- Tahoe(macOS26)预准备功能仅允许在 macOS15 下执行;可修复残留的旧准备状态,不再无谓等待不可能发生的第二次大版本升级。
- 在主动导出的日志内加入已安装组件指纹以及处理器信息;日志附带近期 Firefox、plugin‑container 以及 Blender 崩溃报告;相关文件路径与身份识别信息已做脱敏处理。
- ## 验证测试
- 6 项安装回滚与完整性测试、20 项卸载 / 预校验测试、15 项恢复环境测试、4 项系统升级防护测试全部通过。
- 正式版 Swift 编写的 USB 映射模块与版本解析校验通过;更新器界面测试通过。
- 发布版应用针对 x86_64 架构的 macOS15 编译构建;签名与公开内容校验合格。在 macOS15.8.1 上完成实时启动、更新器自动发现、USB 控制器扫描测试。
- 对应的驱动安装包在 macOS15.8.1 完成内核集合预校验,测试过程没有改动本机已安装驱动。
- 打包内的 NVIDIA 二进制程序以及固件文件,与已经过验证的 1.0.8 发布资产完全一致,没有改动。
- ## 剩余待完成工作
- 本版本并未新增显卡适配认证,也尚未完成 Blender、Firefox、DRM、刷新率自定义、双显卡切换、macOS26 完整支持。以上功能继续在 1.1 版本开展开发调研。现有的启动策略约束依然生效。
- DMG 镜像同时包含客户端应用以及离线驱动包;ZIP 仅包含应用程序;驱动 tar 压缩包可单独获取。下载文件请使用 SHA256SUMS.txt 完成校验。
- Driver 1.0.3 与 1401‑Mac 1.0.5:修复连续重绘场景下 GPU 启动延迟、桌面闪烁问题。
- 回退启动逻辑原有 100 秒等待;现其启动阻塞时限已纳入该延时,原先 40 秒定时器已无法优先阻止显示初始化。
- WindowServer 在提交显示交换前等待 GPU 任务执行完毕,避免副显示器扫描尚未绘制完成的渲染表面。
- 可选厂商编译器拒绝未知芯片名称;采用 NVK/NAK,不再猜测 Blackwell 着色器目标。
- 日志发送功能保留 PCI / 子系统 ID、BAR 数据、设备 Bring‑Up 状态、内核环消息、查询状态以及 Release‑Plugin 故障信息;关键报告优先上传,早于旧版启动日志。
- 设备列表共覆盖 235 款 Turing 及更新架构独立显卡 ID:GTX16、RTX20/30/40/50、TITAN RTX、以及受支持的 Quadro/RTX 专业工作站卡。RTX5060 已在 macOS 15.8.1 完成验证;RTX5070、5080 反馈可正常工作。该设备支持表范围大于实际硬件测试矩阵。更早世代架构、笔记本显示多路复用器 (mux) 需另行适配;其余显卡的 Small‑BAR 物理运行尚未经过验证。参考文档:https://github.com/nullmoth/nvidia-macos-driver/blob/main/docs/CARD‑SUPPORT.md
- 验证结果:强制 100 秒启动与正式版启动均通过保护引导;8 组纹理用例、12 组渲染目标用例全部通过,零像素错误;MPS、Core Image 负载测试通过;已部署 Release 插件重启后,开启页翻转后 WindowServer 稳定运行 60 秒,无锁存超时,未新增桌面 / 内核崩溃;CPU 侧回归测试已复现并排除原有显示排序缺陷。NVIDIA PCI / 名称接口共校验全部 1931 条正式芯片记录,5 条负向测试用例全部拦截成功。
- 打开 DMG 运行 1401 即可完成安装或升级,内含驱动安装包;ZIP 包为 Mac 应用程序;tar.gz 为可供手动部署的驱动包;SHA256SUMS.txt 包含以上三份下载文件校验值。本次发布不再附带用于慢速启动测试的临时内核。
0. 本站所有资源解压密码均为
heipg.cn
1. 本站资源收集于网络,仅做学习和交流使用,请于下载后24小时内删除。如果你喜欢我们推荐的软件,请购买正版支持作者。
2.
如有无法下载的链接,联系:admin#heipg.cn,或到QQ群进行反馈,我们将及时进行处理。
3. 本站发布的内容若侵犯到您的权益,请联系站长删除,联系方式:admin#heipg.cn,我们将第一时间配合处理!
黑苹果星球 »
千呼万唤始出来:macOS NVIDIA RTX系列显卡驱动 v2.5.4
很好很好!再次续命。