Skip to main content
Linux Docker 路径通过 Linux ARM64 容器镜像运行，并支持 NPU 访问（适用于跃龙 QCS9075 等 IoT 平台）。
这是容器化路径。若你更希望在宿主机上直接安装 geniex 而不使用 Docker，请参见 CLI 安装 → Linux ARM64 (Native)。

​
前置条件

​
安装宿主机依赖

容器通过 -v /usr/lib:/opt/qcom-lib:ro 挂载的宿主机高通驱动库来访问 NPU。请在执行 docker run 之前，在宿主机上安装这些库——参见 CLI 安装 → 安装宿主机依赖。

​
拉取镜像

镜像同时发布到两个仓库——选择你有权限的一个，设置 IMAGE 后再拉取：
bash
若 docker login 失败或 docker pull 返回 permission denied ... /var/run/docker.sock，参见故障排查 → Linux 了解凭据与 docker 组的修复方法。
基线 ARMv8.0 板子 —— 部分无 NPU 的 Dragonwing IoT SoC 跑不了默认的 ARMv8.2 镜像，这类板子请在 tag 后加上 -cpu：docker.io/qualcomm/geniex:latest-cpu。该镜像仅支持 CPU 推理，既不需要 --privileged，也不需要下面的 /usr/lib 挂载。

​
交互式运行

进入容器内交互式 shell：
bash

​
验证

然后在容器 shell 中运行测试命令：
bash
NPU 访问需要 --privileged 标志。
服务器模式参见本地服务器。

​
CLI

完整 CLI Docker 安装指南，参见 CLI 安装 — Linux ARM64 (Docker)。

​
Python

完整 Python 安装指南（原生 Linux ARM64），参见 Python 安装 — Linux ARM64。 Python SDK 既可安装在 Docker 容器内，也可直接安装在 Linux ARM64 主机上。原生安装指南请参见 Linux ARM64 标签页。