intel/intel-qat-engine Docker Image
intel
Intel QAT OpenSSL Engine Docker镜像提供基于Intel QuickAssist Technology的加密加速功能,通过OpenSSL插件引擎实现硬件和优化软件的密码学加速,适用于启用Intel QAT的Intel平台。
下载次数: 0状态:社区镜像维护者:intel仓库类型:镜像最近更新:27 天前
Intel QAT OpenSSL Engine Docker镜像文档
镜像概述和主要用途
Intel QuickAssist Technology (QAT) OpenSSL Engine是一个OpenSSL插件引擎,通过启用Intel QuickAssist Technology的Intel平台,为硬件和优化软件提供加密加速功能。本Docker镜像封装了该引擎,便于在容器环境中快速部署和使用QAT加速能力。
核心功能和特性
- 基于Intel QuickAssist Technology实现加密加速
- 支持硬件加速和优化软件加速两种模式
- 作为OpenSSL插件引擎,无缝集成OpenSSL加密操作
- 适用于启用Intel VT-d和SR-IOV的Intel平台
使用场景和适用范围
- 需要高性能加密/解密操作的服务器环境
- 数据中心中的加密加速需求
- 基于OpenSSL的应用程序性能优化
- 启用Intel QAT技术的Intel Xeon等服务器平台
使用方法和配置说明
镜像信息
- 镜像名称:intel/intel-qat-engine:2.0.0-1
前置要求
BIOS设置
- 必须在平台BIOS中启用Intel VT-d和SR-IOV功能
- 详细设置步骤参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#updating-the-bios-settings
Grub设置
需启用Intel IOMMU并将QAT VF绑定到内核,具体步骤如下:
Ubuntu系统:
- 编辑grub文件:
sudo vim /etc/default/grub - 修改
GRUB_CMDLINE_LINUX参数,添加:intel_iommu=on vfio-pci.ids=8086:4941(SPR平台) - 更新grub:
sudo update-grub - 重启系统
CentOS/Fedora系统:
- 更新内核参数:
grubby --update-kernel=/boot/vmlinuz-$(uname -r) --remove-args="intel_iommu=on" --args="intel_iommu=off vfio-pci.ids=8086:4941" - 重启系统
确保主机已启用VT-d和SRIOV,详细步骤参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#configuring-the-host-operating-system-with-sr-iov-iommu
Docker环境设置
- 安装Docker,步骤参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#docker
- 配置代理设置,参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#proxy-settings
启用Intel® QAT虚拟功能(VF)设备
使用以下脚本启用VF设备:
shfor i in `(lspci -D -d :4940 || lspci -D -d :4942) | awk '{print $1}'`; do echo 16 | sudo tee /sys/bus/pci/devices/$i/sriov_numvfs; done
配置主机服务
-
停止主机上可能运行的Intree或OOT服务:
shsystemctl stop qatshsystemctl stop qat_serviceshsystemctl disable qat_service -
关闭QAT设备:
shfor i in `lspci -D -d :4940 | awk '{print $1}'`; do echo down > /sys/bus/pci/devices/$i/qat/state; done -
设置QAT设备的正确服务:
shfor i in `lspci -D -d :4940 | awk '{print $1}'`; do echo "sym;asym" > /sys/bus/pci/devices/$i/qat/cfg_services; done -
启动QAT设备:
shfor i in `lspci -D -d :4940 | awk '{print $1}'`; do echo up > /sys/bus/pci/devices/$i/qat/state; done -
检查QAT设备状态:
shfor i in `lspci -D -d :4940 | awk '{print $1}'`; do cat /sys/bus/pci/devices/$i/qat/state; done -
确保QAT组GID与Docker镜像一致(需为1001):
shgetent group qat | cut -d ':' -f 3 -
设置VF设备权限:
shchown root:qat /dev/vfio/*shchmod 660 /dev/vfio/*
运行镜像
使用以下命令运行Docker镜像:
shdocker run -it --cap-add=IPC_LOCK --security-opt seccomp=unconfined --security-opt apparmor=unconfined $(for i in `ls /dev/vfio/*`; do echo --device $i; done) --cpuset-cpus <n cores> --env QAT_POLICY=1 --ulimit memlock=50000000:50000000 intel/intel-qat-engine:1.8.1-1 openssl speed -engine qatengine -elapsed -async_jobs 72 -multi <n> <algo>
注:
<n>为进程数量,<algo>为要测试的加密算法
测试示例输出
shdocker run -it --cap-add=IPC_LOCK --security-opt seccomp=unconfined --security-opt apparmor=unconfined $(for i in `ls /dev/vfio/*`; do echo --device $i; done) --cpuset-cpus 0-63 --env QAT_POLICY=1 --ulimit memlock=524288000:524288000 amr-fm-registry.caas.intel.com/esh-user/qat_crypto_base:1.8.1 openssl speed -engine qatengine -elapsed -async_jobs 72 -multi 64 rsa2048
输出结果示例:
shversion: 3.0.15 built on: Thu Feb 13 08:57:33 2025 UTC options: bn(64,64) compiler: gcc -fPIC -pthread -m64 -Wa,--noexecstack -Wall -O3 -DOPENSSL_USE_NODELETE -DL_ENDIAN -DOPENSSL_PIC -DOPENSSL_BUILDING_OPENSSL -DNDEBUG CPUINFO: OPENSSL_ia32cap=0x7ffef3ffffebffff:0xfb417ffef3bfb7ef sign verify sign/s verify/s rsa 2048 bits 0.000012s 0.000001s 80615.1 1069738.5
***信息
Intel、Intel Atom和Xeon是Intel Corporation在美国和/或其他国家的商标。
*其他名称和品牌可能是其各自所有者的财产。
版权所有 © 2025,Intel Corporation。保留所有权利。
intel 命名空间的其他可用镜像:
intel/python
Python 运行时,Intel 优化版本,适合高性能计算
intel/oneapi-hpckit
Intel oneAPI HPCKit 高性能计算工具包,适合 HPC 与科学计算
intel/oneapi-basekit
Intel oneAPI BaseKit 基础工具包,适合异构计算开发
intel/intel-extension-for-pytorch
Intel Extension for PyTorch,适合 Intel CPU/GPU 深度学习加速
intel/intel-optimized-pytorch
Intel Optimized PyTorch,适合 Intel 硬件优化深度学习
intel/oact-webui
Intel OACT WebUI,适合 Intel AI 工具 Web 管理界面
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 intel-qat-engine 镜像标签
docker pull docker.xuanyuan.run/intel/intel-qat-engine:<标签>
DockerHub 原生拉取命令
docker pull intel/intel-qat-engine:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务