易百纳玄武S3_docker示例部署指南

硬件平台：易百纳玄武S3

本文主要介绍Ebaina玄武S3边缘AI终端通过Docker部署RK182X AI应用（rknn3_docker）的方法。在板端构建Docker镜像并运行容器后，可将RK182X相关运行环境（rknn3/rkllm3等）打包隔离，简化部署与版本管理。

本文操作基于板端Debian系统，宿主机需已具备访问并调用RK182X的能力（RK182X 固件安装与验证可参考Ebaina玄武S3_RK182X固件安装指南）。

环境准备

部署步骤

1. 在板端安装Docker

在板端执行以下命令安装并启动Docker：

apt update
apt install -y docker.io docker-cli
systemctl enable --now docker
docker info

2. 拷贝Docker资源与模型安装包到板端

adb push <RK182X SDK/examples/docker/> /userdata/
adb push <rknn3_rk182x_m2_installer_arm64.tgz?> /userdata/docker/

说明：模型安装包rknn3_rk182x_m2_installer_arm64.tgz请从资料网盘获取。

3. 配置Docker镜像源

为提升镜像拉取速度，配置Docker镜像加速器（以DaoCloud镜像源为例），在板端执行：

mkdir -p /etc/docker && cat > /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}
EOF

systemctl restart docker

4. 板端构建镜像

进入Docker资源目录，赋予脚本可执行权限后执行构建：

cd /userdata/docker
chmod +x *.sh
docker build -f dockerfile \
  --build-arg INSTALLER=rknn3_rk182x_m2_installer_arm64.tgz \
  -t rknn3_docker .

构建成功会出现类似以下日志：

5. 禁用宿主机rknn3然后重启

为避免宿主机rknn3服务与容器内的运行环境冲突，需先禁用并停止宿主机rknn3服务，再重启板端：

systemctl disable --now rknn3
reboot

6. 运行Docker容器

板端重启后进入系统，运行容器启动脚本：

cd /userdata/docker
./docker_run.sh

等待初始化完成后会进入Docker终端，使用以下命令查看RK182X识别状态：

rknn-smi info

说明：rknn-smi info能够识别到RK182X设备，即代表部署成功。

退出容器执行：

exit

注意事项

• 仅在第一次启动容器时需要运行docker_run.sh脚本。容器首次正常启动后，后续宿主机重启时Docker容器会自动运行。
• 若后续需要更新容器和镜像，需先将原有容器和镜像删除，再重新执行构建步骤。
• 如需在容器内启动OpenAI兼容服务（rkllm3_server），可在运行脚本时带上rkllm3参数：
• 若仅做基础测试，可不带参数执行./docker_run.sh，此时只进行固件下载操作并进入bash。