type
status
date
slug
summary
tags
category
icon
password
安装 Intel® OneAPI-2025.1
OneAPI 是一种开放且基于标准的规范,支持多种架构类型,包括但不限于 GPU、CPU 和 FPGA。该规范具有直接编程和基于 API 的编程范式,Intel® OneAPI 则是一个软件套件,包含了多种工具和库,用于支持 OneAPI 规范。本文记录了在 Debian 12 上安装 Intel® OneAPI-2025.1 的过程。
1. Intel graphics 驱动安装
The Debian 12 软件仓库不包含适用于各种英特尔显卡产品的计算软件包。要安装这些软件包,你可以使用英特尔专用的软件包仓库。
- 安装英特尔显卡GPG公钥。
- 配置软件包仓库,注意这里直接用 22.04 对应 intel-gpu 源,没有针对 debian 12 的源
- 更新软件包仓库元数据。
- 安装与计算相关的软件包。
上述列出的命令会安装大多数用户所需的所有必要软件包,旨在尽量减少安装不必要的软件包。不过,如果你打算使用PyTorch,则还需额外安装 和 :
如果您希望启用硬件光线追踪支持,还需安装:
- 验证安装
要验证内核和计算驱动程序已安装且能正常工作,请运行:
你应该会看到列出的英特尔显卡产品设备名称。如果它们没有出现,请确保你有访问权限。这通常要求你的用户属于渲染组:
1. 项目介绍
OneVPL-intel-gpu 是一个开源项目,它是 Intel Video Processing Library (Intel VPL) GPU Runtime 的实现。该项目提供了一个运行时环境,使得开发者可以利用 Intel Gen GPUs 进行硬件加速的视频解码、编码和过滤。它支持多种视频编码器和解码器,以及多种视频预处理过滤器。
2. VPL-GPU-Runtime安装
环境准备
在开始之前,确保您的系统中安装了以下依赖项:
- 操作系统:Linux x86-64
- 软件:LibVA
- VAAPI 后端驱动:Intel Media Driver for VAAPI
克隆项目
使用以下 Git 命令克隆项目:
编译项目
在项目目录中创建一个构建目录并编译项目:
配置选项
以下是可用的 CMake 配置选项,本文使用默认配置:
ENABLE_ITT: 启用 ITT (VTune) 仪表支持
ENABLE_TEXTLOG: 启用文本日志跟踪支持
ENABLE_STAT: 启用统计跟踪支持
BUILD_ALL: 构建所有目标
BUILD_RUNTIME: 构建 Intel VPL 运行时
BUILD_TESTS: 构建单元测试
USE_SYSTEM_GTEST: 使用系统 gtest 版本
BUILD_TOOLS: 构建 tools
MFX_ENABLE_KERNELS: 构建 Intel VPL 时启用媒体着色器支持
3. OneAPI 安装
Intel one API 由两个部分组成,前者为基础 Base Toolkit ,后者必须依赖前者,Intel one API HPC Toolkit,也就是要前后依次安装。
Base Toolkit 是 Intel 的一个 API 基础工具包包括以下库和其他库
3.1 Base Toolkit 安装
- 下载安装包
- 安装
- 如果自定义安装在用户目录,就不需要 root 权限
然后将启动一个图形安装界面,继续操作:(注意以下图片时我引用网上的2024的安装截图,我安装过程中没有截图,过程是一致的)
(1)选择 Accept & customize

(2)选择安装的组件

(3)选择安装的路径

(4)选择 Next

(5)选择 2 然后开始安装

接下来等待安装完成即可。
3.2 HPC Toolkit安装
运行基于 Base Toolkit ,这个必须作为后者安装
- 下载安装包
- 安装
- 如果自定义安装在用户目录,就不需要 root 权限
必须安装的库文件: Intel® MPI Library Intel® Fortran Compiler (Beta) & Intel® Fortran Compiler Classic Intel® oneAPI DPC++/C++ Compiler & Intel® C++ Compiler Classic
安装过程与 Base Toolkit 类似,不再赘述。
4. 环境配置
安装完成后,需要配置环境变量,以便在终端中使用 Intel® oneAPI 工具。
在 HPC 环境中,使用
modulefile 来管理环境变量,可以使用 module 命令来加载环境变量。- 安装module环境变量管理工具
使用的是
sudo apt-get install environment-modules,所以安装路径是/usr/share/modules。安装 module 工具后,你会发现它并不是一个可执行的二进制文件,你需要对 module 工具进行一次初始化。在/usr/share/modules/init (注意此处,可能是 module 也可能是 modules) 内部你可以找到针对各个脚本的二进制初始化文件,找到你当前的脚本,source 这个二进制文件,例如你是 bash 脚本,source /usr/share/modules/init/bash之后,你就可以使用 module 工具了。为了避免每次打开终端的时候都需要
source /usr/share/modules/init/bash,你需要把该命令添加到/etc/profile文件当中,如下所示:打开/etc/profile文件:sudo vim /etc/profile,在文件末尾加入以下语句:- 配置modulefiles
命令会在你的home目录下产生一个modulefiles目录。
在
/usr/share/modules/创建一个软链接文件oneapi指向产生的modulefiles目录- 测试oneapi modules是否用

image-20250619183948001
验证安装
通过
module load 命令加载环境变量测试是否安装成功, 如果输出版本信息,则安装成功。
继续测试 MPI
如果输出版本信息,则安装成功。
icx 说明
Intel® oneAPI DPC++/C++ Compiler (icx) is Intel nextgen compiler based on Clang /LLVM technology plus Intel proprietary optimizations and code generation.
icx 是基于 Clang /LLVM 技术的 Intel 下一代编译器,加上 Intel 专有的优化和代码生成。
LLVM 帮助实现了为英特尔架构提供更加优秀的 C/C++编译器这一目标。最新的英特尔 C/C++编译器使用 LLVM 架构,可提供更快的编译时间、更好的优化、增强的标准支持以及对 GPU 和 FPGA 负载转移(offloading)的支持。
6. 图片缩放demo
图片缩放代码依赖于opencv的相关数据结构,所以需要安装opencv的开发库,用以下命令安装opencv
缩放代码:image_resize_dpcpp.cpp
编译命令:
运行结果