Ctrlk
VitePress 镜像站QQ 群 787969044视频教程Ⅰ视频教程Ⅱ
discord
For the complete documentation index, see llms.txt. This page is also available as Markdown.

10.4 NVIDIA 显卡驱动

NVIDIA 显卡驱动概述

台式机如果 CPU 为英特尔处理器且型号以 F（如 i5-9400F）或 KF（如 i5-12600KF）结尾，则该型号无核芯显卡，无需处理核芯显卡相关配置。

如果已有独立显卡，且视频输出接口（DP 或 HDMI）直接连接至独立显卡，通常无需配置核芯显卡，仅处理独立显卡驱动即可。

不具备显卡直通能力的笔记本设备，必须先按照其他章节安装并配置英特尔核芯显卡驱动（相关 DRM 模块），随后再参照下文完成 NVIDIA 独立显卡驱动的配置。

是否笔记本？
├── 是（笔记本）→ Intel/AMD 核显 → NVIDIA（混合显卡，如有）
└── 否（台式机）
    ├── 是否有核显？
    │   ├── 否（Intel F/KF）→ NVIDIA（直连）
    │   └── 是（核显）
    │       ├── 是否使用独显输出？
    │       │   ├── 是 → NVIDIA（直连为主）
    │       │   └── 否 → Intel + NVIDIA（可选）

加入 video 组

将指定用户添加到 video 组，以便访问显卡设备：

# pw groupmod video -m 实际用户名

安装显卡驱动

使用 pkg 安装：

或使用 Ports 安装：

列出已安装的 NVIDIA 相关软件：

配置 NVIDIA 显卡驱动

启动 NVIDIA 相关内核模块

执行以下命令配置 NVIDIA 内核模块：

警告

X11 用户请勿尝试加载 nvidia-drm.ko 内核模块，该操作可能导致系统崩溃。Wayland 用户按需加载。

生成 X11 配置文件

需注意，如果系统可正常显示，则无需执行本节内容。执行 Xorg -configure 前必须确保当前无 X 服务器正在运行，否则该命令将失败。

警告

请勿尝试安装和使用 Port x11/nvidia-xconfig。该工具当前不适用，可能导致系统无响应。

硬件加速和解码器

安装 VDPAU 驱动及相关库以支持视频硬件加速。

  • 使用 pkg 安装：

  • 或使用 Ports 安装：

重新启动后即可正常启用 NVIDIA 驱动。

查看 NVIDIA 驱动状态

列出所有 NVIDIA GPU 及其详细信息：

nvidia-smi 命令示例输出：

  • 查看 KDE 系统信息：

KDE 系统信息

  • 使用 mpv 打开电影，可观察到显存使用量明显上升（从 3 MB 上升至数百兆），也可使用 SMPlayer 观看。

mpv 显存使用

故障排除

nvidia-smi 命令报错“mismatch”

nvidia-smi 报错

执行 nvidia-smi 命令时出现错误提示“API mismatch”：该错误表示 API 不匹配，通常源于版本兼容性问题。可能原因包括：NVIDIA 驱动组件本身版本不匹配、NVIDIA 驱动与其他 NVIDIA 软件包版本不匹配、NVIDIA 驱动与当前 FreeBSD 基本系统版本不匹配。

建议先卸载所有 NVIDIA 软件包，随后将 FreeBSD 基本系统更新到最新版本，再重新安装驱动。

如何卸载现有的 NVIDIA 相关软件包

如果提示版本不符，需先卸载所有已安装的 NVIDIA 相关软件包，随后按本节配置：

先列出已安装的 NVIDIA 相关软件包，再逐个删除：

如何阻止驱动更新

对 pkg info -q | grep -i nvidia 输出的相关软件包逐个使用 pkg lock 命令锁定即可。

例如：

但如果运行 freebsd-update 命令，或通过 PkgBase 对系统打补丁或更新，也可能影响驱动兼容性，因此需根据实际情况权衡安全需求与可用性。

参考文献

课后习题

  1. 在显卡直连的笔记本上实际测试，提交 PR。

  2. 在 Linux 兼容层下调用 NVIDIA CUDA 测试。

  3. NVIDIA 官方驱动以二进制闭源形式分发，而 FreeBSD 内核采用 BSD 许可证。分析闭源内核模块与 BSD 许可证的兼容性争议，并讨论 nouveau 开源驱动能否在 FreeBSD 上替代闭源方案。

上一页10.3 AMD 显卡驱动下一页11.1 X Window 系统概论

最后更新于