intel-qat-engine

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系统:

  1. 编辑grub文件:sudo vim /etc/default/grub
  2. 修改GRUB_CMDLINE_LINUX参数,添加:intel_iommu=on vfio-pci.ids=8086:4941(SPR平台)
  3. 更新grub:sudo update-grub
  4. 重启系统

CentOS/Fedora系统:

  1. 更新内核参数:grubby --update-kernel=/boot/vmlinuz-$(uname -r) --remove-args="intel_iommu=on" --args="intel_iommu=off vfio-pci.ids=8086:4941"
  2. 重启系统

确保主机已启用VT-d和SRIOV,详细步骤参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#configuring-the-host-operating-system-with-sr-iov-iommu

Docker环境设置

  1. 安装Docker,步骤参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#docker
  2. 配置代理设置,参考:https://intel.github.io/quickassist/AppNotes/Containers/setup.html#proxy-settings

启用Intel® QAT虚拟功能(VF)设备

使用以下脚本启用VF设备:

sh
for 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

配置主机服务

  1. 停止主机上可能运行的Intree或OOT服务:

    sh
    systemctl stop qat
    
    sh
    systemctl stop qat_service
    
    sh
    systemctl disable qat_service
    
  2. 关闭QAT设备:

    sh
    for i in `lspci -D -d :4940 | awk '{print $1}'`; do echo down > /sys/bus/pci/devices/$i/qat/state; done
    
  3. 设置QAT设备的正确服务:

    sh
    for i in `lspci -D -d :4940 | awk '{print $1}'`; do echo "sym;asym" > /sys/bus/pci/devices/$i/qat/cfg_services; done
    
  4. 启动QAT设备:

    sh
    for i in `lspci -D -d :4940 | awk '{print $1}'`; do echo up > /sys/bus/pci/devices/$i/qat/state; done
    
  5. 检查QAT设备状态:

    sh
    for i in `lspci -D -d :4940 | awk '{print $1}'`; do cat /sys/bus/pci/devices/$i/qat/state; done
    
  6. 确保QAT组GID与Docker镜像一致(需为1001):

    sh
    getent group qat | cut -d ':' -f 3
    
  7. 设置VF设备权限:

    sh
    chown root:qat /dev/vfio/*
    
    sh
    chmod 660 /dev/vfio/*
    

运行镜像

使用以下命令运行Docker镜像:

sh
docker 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>为要测试的加密算法

测试示例输出

sh
docker 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

输出结果示例:

sh
version: 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-qat-engine 镜像标签

docker pull docker.xuanyuan.run/intel/intel-qat-engine:<标签>

DockerHub 原生拉取命令

docker pull intel/intel-qat-engine:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告