PVE Tools Pro

外观

为什么 vGPU 驱动不做一键安装 ​

PVE Tools Pro 曾经提供过 NVIDIA vGPU 驱动的一键安装，现在撤掉了，改成引导用户手工装。这篇说明原因。

一句话结论：vGPU 驱动对内核版本、驱动版本、补丁版本三者的匹配极其敏感，装错的代价是宿主机不可用或驱动链路损坏。 PVE 8.3 到 8.4/8.5、再到可选的 6.14 内核，这个区间里兼容性波动非常明显，脚本覆盖不住所有机型和版本组合。

所以脚本保留了环境准备和状态检查，但不再替你执行驱动安装器。

自动化会踩到的三个坑 ​

版本耦合太紧，没法固定一个 run 包。 不同显卡、不同 vGPU 代际、不同 PVE 内核，需要的驱动版本都不一样。把驱动 URL 写死在脚本里，四种翻车方式排队等着：DKMS 编译失败、模块加载失败、mdev 类型消失、nvidia-smi 看着正常但 vGPU 根本用不了。

新内核会撞上历史驱动代码。 6.12+（含 6.14）上最常见的报错是这个：

text
nvidia-vgpu-vfio.c: ... error: 'no_llseek' undeclared here

这类问题得对驱动源码或补丁做版本化处理，属于"驱动包 + patch + 内核"三者的组合兼容问题，不是脚本能盲目自动化的。

驱动来源需要你自己审计。 vGPU 驱动和补丁大多来自社区资源，不同来源的维护节奏和可信度差别很大。哈希校验和来源审计没做完之前，脚本不应该替你执行第三方安装器。

推荐的手工流程 ​

  1. 确认 BIOS 与 IOMMU/VFIO 基础环境已就绪。

  2. 用 uname -r 查当前内核，据此挑匹配的 vGPU 驱动版本。

  3. 需要打补丁的，先手工应用 patch，再生成 custom run 安装包。

  4. 装完验证三条：

    bash
    nvidia-smi
mdevctl types
systemctl status nvidia-vgpud nvidia-vgpu-mgr

  5. 每一步都留日志和回滚点，别做一次性不可逆的改动。

资源 ​

上述资源由第三方（佛西博客相关来源）提供，与 PVE Tools Pro 维护方不是同一主体。

第三方驱动与补丁存在供应链风险

务必自行校验来源、版本和文件完整性，先在测试环境跑通，再上生产节点。

20 系及以上显卡 ​

20 系之后的卡在 vGPU 场景下涉及更多版本耦合和补丁细节，复杂度比老卡高一个量级。本项目不提供自动化流程，建议直接照着上面的研究教程，按你的实际硬件和内核版本逐步验证。

脚本在 NVIDIA 方向做什么 ​

  • 宿主机预配置（IOMMU / VFIO / 驱动黑名单）
  • vGPU Unlock 外部库部署
  • 驱动状态与诊断

驱动安装这一步保持人工决策、人工执行——误匹配的代价太高，不值得为省几分钟去赌。