docker buildx ls # 切换回默认构建器
docker buildx use default
# 重新注册 QEMU 跨架构模拟器(这一步非常关键,防止 exec format error)
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
二、Linux 安装 / 启用 buildx(3 种情况)
情况 1:Docker 自带 buildx(推荐)
直接启用即可:
# 查看是否已有 buildx
docker buildx version
# 启用 buildx(设为默认构建器)
docker buildx create --use --name mybuilder
docker buildx inspect --bootstrap
能输出版本号就说明装好了,不用再手动装。
情况 2:没有 buildx,手动安装二进制(通用)
# 1. 建插件目录
mkdir -p ~/.docker/cli-plugins
# 2. 下载 buildx(x86_64)
curl -Lo ~/.docker/cli-plugins/docker-buildx \
https://github.com/docker/buildx/releases/latest/download/buildx-linux-amd64
# 3. 加执行权限
chmod +x ~/.docker/cli-plugins/docker-buildx
# 4. 验证
docker buildx version
情况 3:启用 BuildKit(避免 experimental 警告)
编辑 /etc/docker/daemon.json:
vim /etc/docker/daemon.json
{
"experimental": true
}
重启 Docker:
systemctl restart docker