容器世界日新月异，而镜像构建也在不断进化。从 Classic Builder 到 BuildKit，再到 Buildx，Docker 的构建体系已经彻底迈入现代时代。 Buildx v0.30.1 是当前官方最新稳定版，它为镜像构建带来了跨平台、加速、缓存、并行等“现代构建能力”。

本文将从 安装、启用、验证 到多平台构建 全面梳理 Buildx 的最佳实践。

🌟 1. 什么是 Docker Buildx？

Docker Buildx 是 Docker 官方基于 BuildKit 的新一代构建工具。相比传统 docker build，它拥有：

• ✅ 多平台构建（AMD64 / ARM64 / ARMv7 / PPC64）
• ✅ 完整的 BuildKit 支持
• ✅ 构建缓存（local/registry/inline）
• ✅ 分布式构建驱动（container / kubernetes）
• ✅ 并行构建与更快速度
• ✅ 导出 OCI 镜像格式
• ✅ CI/CD 完整支持

一句话： buildx 是以后构建 Docker 镜像的唯一正确方式。

目前最新版本为 v0.30.1（2025）。

🌟 2. 检查你的 Docker 是否已内置 buildx

Docker Desktop（Windows/macOS）自带 Buildx，你可以先试：

docker buildx version

如果你看到了类似输出：

github.com/docker/buildx v0.30.1

那你已经内置，无需额外安装。

如果提示找不到，那你继续看下一节即可。

🌟 3. 如何安装 Docker Buildx v0.30.1（Linux/WSL2）

下面方法适用于：

• Linux（Ubuntu / Debian / CentOS / Arch）
• WSL2 Ubuntu / Debian

📌 3.1 创建 Buildx 插件目录

mkdir -p ~/.docker/cli-plugins

📌 3.2 下载 Buildx v0.30.1

前往官方 Release（自动构建）：

👉 https://github.com/docker/buildx/releases

直接下载 Linux AMD64：

curl -LO https://github.com/docker/buildx/releases/download/v0.30.1/buildx-v0.30.1.linux-amd64

ARM64 版本也可下载：

curl -LO https://github.com/docker/buildx/releases/download/v0.30.1/buildx-v0.30.1.linux-arm64

📌 3.3 放入 Docker CLI 插件目录

mv buildx-v0.30.1.linux-amd64 ~/.docker/cli-plugins/docker-buildx

或 ARM64：

mv buildx-v0.30.1.linux-arm64 ~/.docker/cli-plugins/docker-buildx

📌 3.4 添加执行权限

chmod +x ~/.docker/cli-plugins/docker-buildx

📌 3.5 验证安装

docker buildx version

输出类似：

github.com/docker/buildx v0.30.1  buildkit 0.16.0

即表示安装成功！

🌟 4. Docker Desktop（Windows/macOS）无需安装

Docker Desktop 默认集成 Buildx，并且版本一般比 Linux 最新。

你只需要执行：

docker buildx version

即可验证。

🌟 5. 启用 Buildx（安装后必须执行）

默认 Docker 不启用高级构建器，你需要创建一个 builder：

docker buildx create --name mybuilder --use

初始化 BuildKit：

docker buildx inspect --bootstrap

看到类似输出：

Driver: docker-container
Platforms: linux/amd64, linux/arm64, linux/arm/v7

说明 Buildx 已经完全启用。

🌟 6. 多平台镜像构建示例（最常用）

下面示例构建并推送 AMD64 + ARM64 镜像：

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t registry.io/myapp:v1 \
  --push .

构建本地 Docker 可用镜像：

docker buildx build \
  --platform linux/amd64 \
  -t myapp:v1 \
  --output=type=docker .

构建 OCI 镜像文件：

docker buildx build \
  --platform linux/amd64 \
  --output=type=oci,dest=myapp.oci .

🌟 7. 构建缓存（CI/CD 必备）

推送缓存（Registry）：

docker buildx build \
  --cache-to=type=registry,ref=registry.io/cache:myapp,mode=max \
  --cache-from=type=registry,ref=registry.io/cache:myapp \
  -t registry.io/myapp:v1 \
  --push .

本地缓存：

docker buildx build \
  --cache-to=type=local,dest=./build-cache \
  --cache-from=type=local,src=./build-cache \
  -t myapp:v1 .

🌟 8. 写在最后：为什么必须使用 Buildx？

Buildx 已经是 Docker 官方的“唯一未来方向”。

它的出现，是为了让 Docker 构建体系彻底现代化：

• 更快
• 更可扩展
• 更专业
• 更适合作为 CI/CD 标准

构建不再是 blocking，而是成为一种高效的流水线能力。