跳转到主要内容
Linux Docker 路径通过 Linux ARM64 容器镜像运行，并支持 NPU 访问（适用于跃龙 QCS9075 等 IoT 平台）。

​
前置条件

​
拉取镜像

镜像同时发布到两个仓库——选择你有权限的一个，设置 IMAGE 后再拉取：
bash
# Option A — Docker Hub (公开，无需登录):
IMAGE=docker.io/qualcomm/geniex:latest

# Option B — Qualcomm Container Registry:
docker login docker-registry.qualcomm.com -u '$app' -p GB2S6KXMJXTPV8VHNFNS7Q6LVH75LOOBTLT8D723WUX6PSFZMTX95GIQG4EFWH5C021ONZ5763VI9IDHU96Q7VAZJ2830CLX3NPI6STQOJWRYXLLA2ZYTL1S
IMAGE=docker-registry.qualcomm.com/qcom-ai-hub/geniex-cli:latest

docker pull "$IMAGE"
若 docker login 失败或 docker pull 返回 permission denied ... /var/run/docker.sock，参见故障排查 → Linux 了解凭据与 docker 组的修复方法。

​
交互式运行

进入容器内交互式 shell：
bash
docker run -it --rm --privileged \
  -v "$PWD/data:/data" \
  -v /usr/lib:/opt/qcom-lib:ro \
  "$IMAGE"

​
验证

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

​
CLI

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

​
Python

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