7.4 NVIDIA 显卡驱动
7.4.1 NVIDIA 显卡驱动概述
台式机如果 CPU 为英特尔处理器且型号以 F（如 i5-9400F）或 KF（如 i5-12600KF）结尾，则该型号无核芯显卡，无需处理核芯显卡相关配置。
如果已有独立显卡，且视频输出接口（DP 或 HDMI）直接连接至独立显卡，通常无需配置核芯显卡，仅处理独立显卡驱动即可。
不具备显卡直通能力的笔记本设备，须先按照其他章节安装并配置英特尔核芯显卡驱动（相关 DRM 模块），然后再参照下文完成 NVIDIA 独立显卡驱动的配置。
7.4.2 加入 video 组
将指定用户添加到 video 组，以便访问显卡设备：
# pw groupmod video -m 实际用户名7.4.3 安装显卡驱动
使用 pkg 安装：
# pkg install nvidia-drm-kmod nvidia-settings或使用 Ports 安装：
# cd /usr/ports/graphics/nvidia-drm-kmod/ && make install clean
# cd /usr/ports/x11/nvidia-settings/ && make install clean列出已安装的 NVIDIA 相关软件：
# pkg info -q | grep -i nvidia7.4.4 配置 NVIDIA 显卡驱动
7.4.4.1 启动 NVIDIA 相关内核模块
执行以下命令加载 NVIDIA 相关内核模块：
# echo 'hw.nvidiadrm.modeset="1"' >> /boot/loader.conf # 启用 NVIDIA DRM 模式设置
# sysrc -f /etc/rc.conf kld_list+=nvidia-modeset # 添加 nvidia-modeset 内核模块以便启动时加载警告
请勿尝试加载
nvidia-drm.ko内核模块，该操作可能导致系统崩溃。
7.4.4.2 生成 X11 配置文件
需注意，如果系统可正常显示，则无需执行本节内容。执行 Xorg -configure 前须确保当前无 X 服务器正在运行，否则该命令将失败。
# Xorg -configure # 自动生成 Xorg 配置文件
# cp /root/xorg.conf.new /usr/local/etc/X11/xorg.conf.d/xorg.conf # 将生成的配置文件复制到配置目录警告
请勿尝试安装和使用 Port x11/nvidia-xconfig。该工具当前不适用，可能导致系统无响应。
7.4.5 硬件加速和解码器
安装 VDPAU 驱动及相关库以支持视频硬件加速。
- 使用 pkg 安装：
# pkg install libva-vdpau-driver libvdpau libvdpau-va-gl- 或使用 Ports 安装：
# cd /usr/ports/multimedia/libva-vdpau-driver/ && make install clean
# cd /usr/ports/multimedia/libvdpau/ && make install clean
# cd /usr/ports/multimedia/libvdpau-va-gl/ && make install clean重新启动后即可正常使用 NVIDIA 驱动。
7.4.6 查看 NVIDIA 驱动状态
列出所有 NVIDIA GPU 及其详细信息：
$ nvidia-sminvidia-smi 命令示例输出：
# nvidia-smi
Mon Jan 19 19:06:59 2026
+-----------------------------------------------------------------------------------------+
| NVIDIA-SMI 580.126.09 Driver Version: 580.126.09 CUDA Version: N/A |
+-----------------------------------------+------------------------+----------------------+
| GPU Name Persistence-M | Bus-Id Disp.A | Volatile Uncorr. ECC |
| Fan Temp Perf Pwr:Usage/Cap | Memory-Usage | GPU-Util Compute M. |
| | | MIG M. |
|=========================================+========================+======================|
| 0 NVIDIA GeForce RTX 3060 Ti Off | 00000000:01:00.0 On | N/A |
| 0% 39C P8 12W / 225W | 409MiB / 8192MiB | 0% Default |
| | | N/A |
+-----------------------------------------+------------------------+----------------------+
+-----------------------------------------------------------------------------------------+
| Processes: |
| GPU GI CI PID Type Process name GPU Memory |
| ID ID Usage |
|=========================================================================================|
| No running processes found |
+-----------------------------------------------------------------------------------------+- 查看 KDE 系统信息：
- 使用 mpv 打开电影，可见显存使用量明显上升（从 3 MB 上升至数百兆），也可使用 SMPlayer 观看。
7.4.7 故障排除
7.4.7.1 nvidia-smi 命令报错“mismatch”
执行 nvidia-smi 命令时出现错误提示“API mismatch”：该错误表示 API 不匹配，通常源于版本兼容性问题。可能原因包括：NVIDIA 驱动组件本身版本不匹配、NVIDIA 驱动与其他 NVIDIA 软件包版本不匹配、NVIDIA 驱动与当前 FreeBSD 基本系统版本不匹配。
建议先卸载所有 NVIDIA 软件包，随后将 FreeBSD 基本系统更新到最新版本，再重新安装驱动。
7.4.7.2 如何卸载现有的 NVIDIA 相关软件包
如果提示版本不符，需先卸载所有已安装的 NVIDIA 相关软件包，然后按本节配置：
# pkg delete *nvidia*7.4.7.3 如何阻止驱动更新
对 pkg info -q | grep -i nvidia 输出的相关软件包逐个使用 pkg lock 命令锁定即可。
例如：
# pkg lock nvidia-drm-kmod
# pkg lock nvidia-settings但如果运行 freebsd-update 命令，或通过 pkgbase 对系统打补丁或更新，也可能影响驱动兼容性，因此需根据实际情况权衡安全需求与可用性。
7.4.8 参考文献
- Intel Corporation. 关于我们的最新处理器和命名更新的简要指南[EB/OL]. [2026-03-25]. https://www.intel.cn/content/www/cn/zh/processors/processor-numbers.html. 英特尔官方 CPU 命名规则与型号标识说明。
- NVIDIA Corporation. NVIDIA Driver Documentation[EB/OL]. [2026-03-25]. https://www.nvidia.com/Download/index.aspx. NVIDIA 官方驱动程序下载与技术文档。
7.4.9 课后习题
- 在显卡直连的笔记本上实际测试，提交 PR。
- 在 Linux 兼容层下调用 NVIDIA CUDA 测试。
- NVIDIA 官方驱动以二进制闭源形式分发，而 FreeBSD 内核采用 BSD 许可证。分析闭源内核模块与 BSD 许可证的兼容性争议，并讨论 nouveau 开源驱动能否在 FreeBSD 上替代闭源方案。