一、场景说明
业务需求：基于 Ultralytics YOLO 模型，用 FastAPI 封装推理接口，通过 Docker Buildx 打包ARM64 / 欧拉系统镜像，适配华为昇腾 910B4 NPU 离线推理环境。 
环境：x86_64 开发机跨架构构建，目标设备 ARM64+CANN 驱动，离线无外网依赖。 
二、核心踩坑点与完整解决方案
1. 跨架构构建基础配置（Buildx）
问题
直接 build 默认 x86 镜像，放到 ARM 昇腾设备报exec format error；拉取基础镜像架构不匹配。 
解决脚本
bash 
运行 
# 创建多架构构建器
docker buildx create --name arm-builder --use
docker buildx inspect --bootstrap
# 构建并推送（离线可导出镜像包）
docker buildx ...