ARM架构M1 Mac构建CentOS7 Docker镜像报错如何解决

问题场景 #

宿主机为ARM架构M1系列Mac，需要编写Dockerfile构建运行CentOS 7容器，初始配置文件如下：

• Dockerfile

# Dockerfile
FROM centos:7

• docker-compose.yml

# docker-compose.yml
version: "3.9"

services:
  genesis:
    build: .

报错信息 #

执行构建/运行命令时返回如下错误：

Building genesis
[+] Building 0.9s (4/4) FINISHED
 => [internal] load build definition from Dockerfile                                                                                                                                                                                                                                 0.0s
 => => transferring dockerfile: 77B                                                                                                                                                                                                                                                  0.0s
 => [internal] load .dockerignore                                                                                                                                                                                                                                                    0.0s
 => => transferring context: 2B                                                                                                                                                                                                                                                      0.0s
 => ERROR [internal] load metadata for docker.io/library/centos:7                                                                                                                                                                                                                    0.8s
 => [auth] library/centos:pull token for registry-1.docker.io                                                                                                                                                                                                                        0.0s
------
 > [internal] load metadata for docker.io/library/centos:7:
------
failed to solve with frontend dockerfile.v0: failed to create LLB definition: failed to authorize: rpc error: code = Unknown desc = failed to fetch oauth token: Get "https://auth.docker.io/token?scope=repository%3Alibrary%2Fcentos%3Apull&service=registry.docker.io": read tcp 192.168.1.209:64469->3.228.155.36:443: read: software caused connection abort
ERROR: Service 'genesis' failed to build : Build failed

已尝试操作 #

初步判断为架构差异问题，先后尝试以下操作均未解决，仍返回相同报错：

• 修改Dockerfile指定ARM平台：

  FROM --platform=aarch/arm centos:7
  

• 修改Dockerfile指定x86平台：

  FROM --platform=linux/amd64 centos:7
  

• 在docker-compose.yml中添加platform参数指定平台

特殊现象：直接在Shell执行如下命令可正常启动CentOS 7镜像：

docker run --rm -it --platform=linux/amd64 centos:7 sh

需要通过Dockerfile构建方式正常运行镜像，以支持后续添加自定义配置逻辑。

报错和架构参数配置无直接关系，核心原因有三点：

1. 直接执行docker run成功，是因为命令优先复用本地已拉取的linux/amd64版本CentOS 7镜像缓存，不会强制请求Docker Hub的鉴权接口拉取最新元数据。
2. 执行构建命令时默认开启的BuildKit组件，会在构建第一步强制远程拉取基础镜像元数据，不会优先使用本地缓存，本地到Docker Hub鉴权接口的网络连接不稳定时，就会触发连接中止错误。
3. 之前配置的--platform=aarch/arm是无效参数，官方CentOS 7从未提供ARM64架构的官方镜像，该配置本身不可能生效。

选择以下任意一种方案即可解决问题：

方案一：关闭BuildKit（推荐，稳定性最高） #

1. 关闭Docker BuildKit功能，二选一即可：
   • 临时生效：执行构建前在当前Shell设置环境变量

     export DOCKER_BUILDKIT=0
     export COMPOSE_DOCKER_CLI_BUILD=0
     

   • 永久生效：打开Docker Desktop设置 -> Docker Engine，将配置中的"buildkit": true修改为"buildkit": false，点击Apply & Restart重启Docker服务。
2. 修正配置文件：
   • Dockerfile使用正确的平台参数（M1 Mac通过Rosetta 2转译运行amd64架构容器，性能损耗可忽略）：

     FROM --platform=linux/amd64 centos:7
     # 后续自定义配置逻辑写在此处
     

   • docker-compose.yml服务层同步指定平台，避免运行时架构不匹配：

     version: "3.9"
     
     services:
       genesis:
         platform: linux/amd64
         build: .
     

3. 清理无效缓存后重新构建：

   docker rmi centos:7
   docker-compose build --no-cache
   

方案二：保留BuildKit，强制使用本地缓存镜像 #

如果不想关闭BuildKit，可以手动预拉取对应架构的基础镜像，构建时跳过远程元数据拉取步骤：

1. 预拉取amd64版本的CentOS 7镜像到本地：

   docker pull --platform=linux/amd64 centos:7
   

2. 使用和方案一一致的Dockerfile、docker-compose.yml配置
3. 构建时指定不拉取远程最新镜像，直接使用本地缓存：

   docker-compose build --pull=false
   

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