Mac M1芯片Docker执行命令报错unexpected EOF求助

以下是针对M1 Mac上Docker因架构差异导致命令报错的具体解决步骤：

• 检查Docker Desktop架构模拟设置
  打开Docker Desktop偏好设置，进入「Features in Development」页面：

  • 勾选「Use the new Virtualization framework」
  • 启用「Rosetta for x86/amd64 emulation on Apple Silicon」，该选项是Docker兼容x86架构镜像的核心配置，启用后重启Docker。

• 重置Docker网络与系统资源
  若网络配置异常导致连接仓库失败，可执行以下操作：

  1. 通过Docker Desktop偏好设置进入「Resources > Network」，点击「Reset to factory defaults」后重启Docker
  2. 或使用命令行强制清理无效资源：

     docker system prune -a
     docker network prune
     

     注意：此命令会删除所有未运行的容器、未使用的镜像和网络，执行前确认无需保留相关资源

• 指定默认镜像架构
  避免Docker默认拉取不兼容的x86镜像：

  1. 拉取镜像时手动指定arm64架构：

     docker pull --platform linux/arm64/v8 [镜像名]
     

  2. 配置全局默认架构，编辑~/.docker/config.json文件，添加以下内容后重启Docker：

     {
       "experimental": "enabled",
       "platforms": {
         "default": "linux/arm64/v8"
       }
     }
     

• 排查代理与网络连接
  若系统使用代理，可能导致Docker无法正常访问镜像仓库：

  • 进入Docker Desktop偏好设置的「Resources > Proxies」页面，选择「Use system proxy settings」或手动配置可访问registry-1.docker.io的代理地址
  • 关闭代理后直接测试docker login命令，确认是否为代理导致的连接问题

• 查看Docker Daemon日志定位细节
  若以上方法无效，查看Docker后台日志获取更详细的错误信息：

  log show --predicate 'process == "dockerd"' --info
  

  根据日志中的具体报错（如证书验证失败、DNS解析错误等）进行针对性修复

内容的提问来源于stack exchange，提问作者Jean Carlo Machado