[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  libmfx-dev libva-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. 安装Intel GPT监控程序

   sudo apt install intel-gpu-tools
   

   • intel-gpu-tools: Intel GPU 官方监控工具，使用 intel_gpu_top 可以直接查看GPU使用率

5. 重启系统：

   sudo reboot
   
   

---

6. **验证安装**：
- 检查 oneVPL 库：
  ```bash
  ldconfig -p | grep vpl
  ```
  输出应包含 `libvpl.so.2` 等。
- 验证 VA-API：
  ```bash
  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 硬件加速：
  ```bash
  ffmpeg -hwaccels
  ```
  应列出 `vaapi` 或 `qsv`。

### 方法 2：从源码编译 oneVPL（适用于需要最新版本）
如果 Ubuntu 仓库的版本（2.10.1，截至 2025 年 10 月）不满足需求，可从源码安装：

1. **安装依赖**：
```bash
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 相关信息）