如何将容器导入Azure容器注册表（ACR）并配置为Linux平台容器

az acr import的导入逻辑是完整继承源镜像的manifests元数据，不会主动修正源镜像的平台标记偏差。出现平台被错判为Windows的问题，基本来自两个环节：

• 本地构建镜像时没显式指定Linux平台参数，导致镜像元数据里残留Windows标记、或是OS平台字段缺失，被ACR默认归类为Windows架构
• 执行导入操作时没从命令层面显式指定目标平台，ACR碰到元数据不完整的镜像时，触发错误的默认匹配逻辑

可稳定保障Linux平台识别的操作步骤 #

• 构建阶段强制写入Linux平台元数据
  不要依赖Docker默认的运行时匹配规则构建镜像，必须显式通过参数指定目标Linux架构，从源头避免镜像带Windows平台标记。对应构建命令为：
  docker build --platform linux/<目标架构，如amd64、arm64> -t <ACR地址>/<镜像名>:<标签> .
  这个参数会强制把镜像manifests里的OS字段固定为linux，哪怕你是在Windows设备上构建跨平台Linux镜像，也不会出现元数据偏差。如果用buildx做跨平台构建，这个参数是必填项，不然很容易出现元数据写入丢失的问题。
• 导入前先校验本地镜像的平台属性
  别在没校验元数据的情况下盲目执行导入，可用一行命令快速确认镜像的真实平台：
  docker inspect --format='{{.Os}}/{{.Architecture}}' <镜像名:标签>
  只有输出明确是linux/<对应架构>的时候，再进入后续导入流程；如果输出是windows/amd64或是空值，直接回到上一步重新构建镜像，别浪费导入时间。
• 导入环节显式指定目标Linux平台
  执行az acr import操作时，一定要带上平台参数，强制覆盖ACR侧的自动识别逻辑——哪怕源镜像的元数据有偏差，ACR在导入时都会优先采信这个命令传入的参数，把镜像平台字段修正为指定的Linux架构。对应标准导入命令为：
  az acr import --name <ACR名称> --source <源镜像地址> --image <ACR内目标镜像名:标签> --platform linux/<目标架构> --force

容易踩的坑 #

• 在Windows上用Docker Desktop的时候，多留意容器运行时的切换状态：如果当前切到了Windows容器模式，后续构建的镜像会默认带Windows平台标记，切回Linux容器模式后再构建才不会出问题
• 导入多架构镜像的时候，别直接拉全量manifest一次性导入，要逐架构单独用--platform参数导入对应架构的manifest条目，最后在ACR侧组装完整的多架构清单，不然很容易出现平台字段混乱
• 别省略导入命令里的--force参数，不然旧的、带错误Windows标记的缓存镜像会残留，导致新导入的镜像还是被识别成Windows平台

内容的提问来源于stack exchange，提问作者Matthew Jacome