Ubuntu 23.04虚拟机中Docker Compose启动Buildkit报错求助

排查与修复步骤 #

• 临时禁用Buildkit绕过问题
  执行启动命令时添加环境变量关闭Buildkit：

  DOCKER_BUILDKIT=0 docker-compose up --build -d
  

  如果临时生效，可通过修改Docker全局配置永久禁用：

  1. 编辑（或创建）/etc/docker/daemon.json文件，写入：

     {
       "features": {
         "buildkit": false
       }
     }
     

  2. 重启Docker服务：

     sudo systemctl restart docker
     

• 修复虚拟机主机名解析
  该错误常因Host头解析异常导致，检查并修正主机名映射：

  1. 查看当前主机名：hostname
  2. 编辑/etc/hosts文件，确保本地回环地址映射了主机名，示例：

     127.0.0.1 localhost your-hostname
     ::1       localhost your-hostname
     

  3. 重启网络服务：sudo systemctl restart systemd-networkd

• 清理Docker构建缓存
  清除旧缓存后重新构建：

  docker builder prune -a
  docker-compose down -v
  docker-compose up --build -d
  

• 检查Docker Compose配置
  确认docker-compose.yml中无Buildkit相关的自定义配置冲突，比如buildx设置、自定义网络规则等，可尝试简化构建段配置后重试。

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