Docker-compose up报错moby/buildkit:buildx-stable-1未找到求助

• 手动拉取目标镜像
  大概率是自动拉取镜像时网络或源的问题，直接手动拉取：

  docker pull moby/buildkit:buildx-stable-1
  

  若官方镜像拉取缓慢，可改用国内镜像源拉取后重打标签：

  docker pull registry.cn-hangzhou.aliyuncs.com/mirror_official/moby/buildkit:buildx-stable-1
  docker tag registry.cn-hangzhou.aliyuncs.com/mirror_official/moby/buildkit:buildx-stable-1 moby/buildkit:buildx-stable-1
  

• 确保Buildx工具正常激活
  执行以下命令将buildx设为默认构建工具，避免compose调用时依赖缺失：

  docker buildx install
  

• 验证实验性功能是否生效
  修改config.json和daemon.json后需重启Docker服务才会生效：

  • Linux：systemctl restart docker
  • Windows/macOS：通过Docker Desktop界面重启服务
    重启后执行docker version，检查Client和Daemon部分的Experimental字段是否为true。

• 强制使用传统Docker构建驱动
  若不需要Buildx的特性，可在docker-compose.yml中显式指定构建驱动，绕过Buildkit镜像依赖：

  # 全局配置示例
  x-build-config: &build-default
    driver: docker
  
  services:
    your-service:
      build:
        <<: *build-default
        context: ./your-service-dir
        dockerfile: Dockerfile
  

  也可以在单个服务的build块中单独配置driver: docker。

• 检查镜像加速源配置
  确保daemon.json中配置了有效的镜像加速地址，示例：

  {
    "experimental": true,
    "registry-mirrors": [
      "https://registry.cn-hangzhou.aliyuncs.com",
      "https://docker.mirrors.ustc.edu.cn"
    ]
  }
  

  修改后重启Docker服务。

内容的提问来源于stack exchange，提问作者Krishna Kishore Musle