解决docker: ‘buildx‘ is not a docker command.

胡八一2025-01-24 10:52

简介

buildx 是 Docker 官方提供的一个构建工具，它可以帮助用户快速、高效地构建 Docker 镜像，并支持多种平台的构建。使用 buildx，用户可以在单个命令中构建多种架构的镜像，例如 x86 和 ARM 架构，而无需手动操作多个构建命令。此外，buildx 还支持 Dockerfile 的多阶段构建和缓存，这可以大大提高镜像构建的效率和速度。

问题

在使用 buildx 构建跨平台镜像时，运行docker buildx version命令报错了

bash 复制代码

C:\Users\zhubayi>docker buildx version
docker: 'buildx' is not a docker command.
See 'docker --help'

原因：因为没有安装buildx构建工具

解决办法

安装buildx 构建工具
buildx 是一个管理 Docker 构建的 CLI 插件，底层使用 BuildKit 扩展了 Docker 构建功能。

BuildKit 是 Docker 官方提供的一个高性能构建引擎，可以用来替代 Docker 原有的构建引擎。相比于原有引擎，BuildKit 具有更快的构建速度、更高的并行性、更少的资源占用和更好的安全性。

要安装并使用 buildx，需要 Docker Engine 版本号大于等于 19.03。

如果你使用的是 Docker Desktop，则默认安装了 buildx。可以使用 docker buildx version 命令查看安装版本，得到以下类似输出，证明已经安装过了。

bash 复制代码

$ docker buildx version
github.com/docker/buildx v0.20.0 8e30c4669ca5aace9dd682650053c307f75fe5cc

如果需要手动安装，可以从 GitHub 发布页面下载对应平台的最新二进制文件，重命名为 docker-buildx，然后将其放到 Docker 插件目录下（Linux/Mac 系统为 $HOME/.docker/cli-plugins，Windows 系统为 %USERPROFILE%\.docker\cli-plugins）。

windows用户可以使用echo %USERPROFILE%命令查看

Linux/Mac 系统还需要给插件增加可执行权限 chmod +x ~/.docker/cli-plugins/docker-buildx，之后就可以使用 buildx 了。

更详细的安装过程可以参考官方文档。