[Ubuntu] Ubuntu24.04安装Intel显卡驱动OneVPL

前提条件

• 确保系统有 Intel GPU（运行 lspci | grep VGA 检查）。
• 确保已连接网络。
• 使用 sudo 或 root 权限。

方法 1：通过 Ubuntu 软件仓库安装（推荐，简单）

1. 更新系统包索引：

   sudo apt update && sudo apt upgrade -y
   

2. 安装 oneVPL 运行时和开发包：

   sudo apt install -y libvpl2 libvpl-dev
   

   • libvpl2：oneVPL 运行时库，支持硬件加速视频处理。
   • libvpl-dev：开发头文件和工具，用于编译依赖 oneVPL 的程序。

3. 安装 VA-API 驱动（oneVPL 依赖硬件加速）：

   sudo apt install -y intel-media-va-driver-non-free vainfo
   

   • intel-media-va-driver-non-free：推荐的非自由驱动，性能更优。
   • vainfo：用于验证 VA-API 支持。

4. （可选）安装 FFmpeg 测试硬件加速：

   sudo apt install -y ffmpeg
   

5. 重启系统：

   sudo reboot
   

6. 验证安装：

   • 检查 oneVPL 库：

     ldconfig -p | grep vpl
     

     输出应包含 libvpl.so.2 等。
   • 验证 VA-API：

     vainfo
     

     输出应显示支持的编解码格式（如 H.264, HEVC, AV1）。示例：

     libva info: VA-API version 1.21.0
     libva info: Trying to open /usr/lib/x86_64-linux-gnu/dri/iHD_drv_video.so
     ...
     VAProfileH264Main            : VAEntrypointVLD
     VAProfileHEVCMain            : VAEntrypointVLD
     VAProfileAV1Profile0         : VAEntrypointVLD
     

   • 测试 FFmpeg 硬件加速：

     ffmpeg -hwaccels
     

     应列出 vaapi 或 qsv。

方法 2：从源码编译 oneVPL（适用于需要最新版本）

如果 Ubuntu 仓库的版本（2.10.1，截至 2025 年 10 月）不满足需求，可从源码安装：

1. 安装依赖：

   sudo apt install -y build-essential cmake git pkg-config libva-dev
   

2. 克隆 oneVPL 仓库：

   git clone https://github.com/oneapi-src/oneVPL.git
   cd oneVPL
   

3. 编译和安装：

   mkdir build && cd build
   cmake ..
   make -j$(nproc)
   sudo make install
   

   • 默认安装路径：/usr/local/lib 和 /usr/local/include/vpl。

4. 更新动态链接库：

   sudo ldconfig
   

5. 验证源码安装：

   pkg-config --modversion vpl
   

   输出应显示 oneVPL 版本号。

常见问题排查

• vainfo 无输出：
  • 确保内核模块加载：lsmod | grep i915，若缺失运行 sudo modprobe i915。
  • 检查 BIOS 是否启用 iGPU。
• 权限问题：
  • 添加用户到 video 组：sudo usermod -aG video $USER，然后重启。
• 旧 GPU 不支持：
  • Gen7 或更早 GPU 可能需要 intel-vaapi-driver：

    sudo apt install -y intel-vaapi-driver
    

• 运行时错误：
  • 确保安装了 intel-media-va-driver-non-free 而非仅开源驱动。
  • 检查环境变量：export LIBVA_DRIVER_NAME=iHD。
• FFmpeg 无 QSV 支持：
  • 安装带 QSV 的 FFmpeg：

    sudo apt install -y ffmpeg libmfx-tools
    ffmpeg -c:v h264_qsv -i input.mp4 output.mp4
    

参考资源

• oneVPL 官方 GitHub
• Intel 媒体文档
• Ubuntu 包搜索
• xAI API 文档（如需 API 相关信息）