这是一个面向 FNOS / 飞牛 NAS vGPU 场景的 NVIDIA GRID 驱动应用包项目。
项目提供两个应用包：
appstore.driver.gpu.nvidia.ko：内核空间驱动包，负责安装 NVIDIA kernel module 和 firmware。appstore.driver.gpu.nvidia.user：用户空间驱动包，负责安装 NVIDIA 用户空间库、nvidia-smi、nvidia-gridd和 NVLTS。
| vGPU 分支 | 宿主机 vGPU KVM 驱动 | 客户机 GRID 驱动 | 应用包版本 |
|---|---|---|---|
| GRID 19.5 | 580.159.01 |
580.159.03 |
580.159.03-3 |
| GRID 16.14 | 535.309.01 |
535.309.01 |
535.309.01-1 |
- 已构建内核包：
6.18.18-trim、6.18.18.c788-trim - 支持架构：
x86
- 新手安装和使用教程：docs/usage.md
- 项目维护和构建说明：docs/maintenance.md
每次安装至少需要下载两个包：
- 一个内核空间驱动包，根据 FNOS 内核版本选择；旧
6.18.18-trim还需要结合 build number 选择。 - 一个同版本用户空间驱动包，例如
appstore.driver.gpu.nvidia.user-580.159.03-3-x86.tgz.fpk。
内核驱动包选择规则：先确认 uname -r。旧 6.18.18-trim 因为同一内核名下存在多组 build，需要再按 build number 选择 427、570、587 或 717 包。其他带构建号的完整内核名直接按 uname -r 选择，例如 6.18.18.c788-trim 选择 6.18.18.c788-trim-amd64 包；如果没有对应包，安装时会提示模块目录不存在。
当前已构建内核包选择规则：
| 当前内核版本 | 当前内核 build number | 应选择的内核驱动包 |
|---|---|---|
6.18.18-trim |
#427 到 #569 |
appstore.driver.gpu.nvidia.ko-580.159.03-3-6.18.18-trim-427-amd64.tgz.fpk |
6.18.18-trim |
#570 到 #586 |
appstore.driver.gpu.nvidia.ko-580.159.03-3-6.18.18-trim-570-amd64.tgz.fpk |
6.18.18-trim |
#587 到 #716 |
appstore.driver.gpu.nvidia.ko-580.159.03-3-6.18.18-trim-587-amd64.tgz.fpk |
6.18.18-trim |
#717 到 #787 |
appstore.driver.gpu.nvidia.ko-580.159.03-3-6.18.18-trim-717-amd64.tgz.fpk |
6.18.18.c788-trim |
#788 |
appstore.driver.gpu.nvidia.ko-580.159.03-3-6.18.18.c788-trim-amd64.tgz.fpk |
如果使用 GRID 16.14 / 535.309.01 版本，包名中的应用包版本需要同步换成 535.309.01-1，例如：
appstore.driver.gpu.nvidia.ko-535.309.01-1-6.18.18-trim-427-amd64.tgz.fpk
appstore.driver.gpu.nvidia.ko-535.309.01-1-6.18.18.c788-trim-amd64.tgz.fpk
appstore.driver.gpu.nvidia.user-535.309.01-1-x86.tgz.fpk
安装前在 FNOS 控制台或 SSH 中执行：
uname -a根据输出中的内核版本选择对应内核包；只有 uname -r 为 6.18.18-trim 时，才需要再根据 #473、#570、#587、#717 等 build number 选择分组包。
正确顺序是：
- 给 FNOS 虚拟机打快照。
- 安装内核空间驱动包
appstore.driver.gpu.nvidia.ko。 - 重启 FNOS。
- 确认
/proc/driver/nvidia/version显示已安装的驱动版本，例如580.159.03或535.309.01。 - 安装用户空间驱动包
appstore.driver.gpu.nvidia.user。 - 用
nvidia-smi和系统资源管理器确认 GPU 正常工作。
详细截图教程见：docs/usage.md
- 宿主机 vGPU KVM 驱动和 FNOS 客户机 GRID 驱动必须来自匹配的 NVIDIA vGPU 驱动版本组合。
- 本项目驱动与飞牛官方应用中心的 NVIDIA 驱动冲突，不要同时安装或启用。
- 内核空间驱动和用户空间驱动版本必须一致，不能混装
580.159.03和535.309.01。 - 安装会修改内核模块 alternatives、firmware、nouveau blacklist、initramfs 和 NVIDIA 用户空间库，安装前请务必创建虚拟机快照。
发布包在 GitHub Releases 中下载：
https://github.com/fnnas/appstore.driver.gpu.nvidia.grid/releases
GitHub Release 中的安装包会以 .tgz.fpk 扩展名发布，可直接用于 FNOS 本地安装。只有下载 GitHub Actions artifact 或历史 .tgz 产物时，才需要手动改名为 .tgz.fpk。