本文记录在 Debian 13 trixie 上安装 Intel 核显计算与媒体驱动的过程,目标是启用以下能力:
- OpenCL:用于 GPU 通用计算
- Level Zero:Intel GPU 底层计算运行时
- VA-API:用于视频硬解、硬编
- oneVPL / Media SDK:用于媒体处理相关应用
测试环境:
Debian 13 trixie
amd64
Intel 核显
需要注意的是,Intel 官方 GPU 仓库目前提供的是 Ubuntu Noble,也就是 Ubuntu 24.04 的软件源。Debian 13 可以使用其中的相关组件,但这属于跨发行版使用软件源,建议在确认依赖关系可控后再用于生产环境。
1. 添加 Intel GPU 软件源
导入 Intel GPU 仓库 GPG key:
wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | sudo gpg --dearmor --output /usr/share/keyrings/intel-graphics.gpg
添加 Intel GPU 软件源:
echo "deb [arch=amd64,i386 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu noble client" | sudo tee /etc/apt/sources.list.d/intel-gpu-noble.list
更新软件包索引:
sudo apt update
2. 安装 Intel 核显驱动组件
直接安装 OpenCL、Level Zero、VA-API、Intel Media Driver、oneVPL 以及常用检测工具:
sudo apt install -y libze-intel-gpu1 libze1 intel-metrics-discovery intel-opencl-icd intel-gsc intel-media-va-driver-non-free libmfx-gen1 libvpl2 libvpl-tools libva-glx2 va-driver-all vainfo clinfo
这组包覆盖了 Intel 核显在 Debian 13 下常用的计算与媒体能力:
Textintel-opencl-icd Intel OpenCL 运行时
libze1 Level Zero loader
libze-intel-gpu1 Intel Level Zero GPU runtime
intel-metrics-discovery Intel GPU 性能指标组件
intel-gsc Intel Graphics Security Controller 组件
intel-media-va-driver-non-free Intel VA-API Media Driver
libmfx-gen1 Intel Media SDK / oneVPL 相关运行库
libvpl2 oneVPL 运行库
libvpl-tools oneVPL 工具
libva-glx2 VA-API GLX 支持
va-driver-all VA-API 驱动集合
vainfo VA-API 检测工具
clinfo OpenCL 检测工具
3. 可选:补充 Mesa / Vulkan / OpenGL 图形栈
如果系统不仅用于计算和视频硬解,还需要更完整的桌面图形、Vulkan、OpenGL 或 Mesa 相关能力,可以额外安装:
sudo apt install -y libegl-mesa0 libegl1 libegl-dev libgbm1 libgl1-mesa-dev libgl1-mesa-dri libglapi-mesa libgles-dev libglx-mesa0 libxatracker2 mesa-va-drivers mesa-vdpau-drivers mesa-vulkan-drivers hwinfo
对于仅运行 Jellyfin、FFmpeg、推理框架、OpenCL 程序或视频转码任务的服务器来说,这一步通常不是必须的。
4. 验证 OpenCL
使用 clinfo 检查 OpenCL 是否正确识别 Intel GPU:
clinfo
正常情况下,输出中应能看到 Intel OpenCL 平台和 GPU 设备,例如:
Platform Name Intel(R) OpenCL GraphicsDevice Name Intel(R) Graphics
如果 clinfo 能列出 Intel GPU,说明 OpenCL 运行时已经安装成功。
5. 验证 VA-API
使用 vainfo 检查 VA-API:
vainfo
正常情况下,输出中应能看到 Intel iHD 驱动:
Driver version: Intel iHD driver
同时还会列出当前硬件支持的视频编码和解码能力,例如 H.264、HEVC、VP9、AV1 等。不同代际的 Intel 核显支持的 profile 会有所不同,以实际输出为准。
6. 检查 GPU 设备节点
确认系统已经识别到 DRM 设备:
ls -l /dev/dri/
通常会看到类似结果:
card0renderD128
其中 renderD128 是无显示渲染节点,很多转码、计算和容器场景都会用到它。
如果普通用户需要访问 GPU,建议确认当前用户是否属于 render 和 video 用户组:
groups
如果不在,可以执行:
sudo usermod -aG render,video $USER
修改用户组后,需要重新登录,或者直接重启系统后生效。