Docker Buildx命令介绍（官方提供的新一代镜像构建工具，基于BuildKit构建引擎）Builder实例、Buildx驱动类型

Docker Buildx 详解：下一代 Docker 镜像构建工具

什么是 Buildx

Buildx 是 Docker 官方提供的新一代镜像构建工具。

它基于 Docker 的BuildKit构建引擎，实现了比传统docker build更强大的能力，包括：

• 多平台镜像构建
• 高性能并行构建
• 高级缓存机制
• 分布式构建
• 输出到 OCI 格式
• 导出镜像文件
• 多节点 Builder 集群

简单来说：

docker build ↓ BuildKit（构建引擎） ↓ docker buildx（高级客户端）

Buildx 可以看作：

docker build 的增强版。

如今 Docker Desktop 默认已经集成 Buildx。

许多现代 CI/CD 系统（GitHub Actions、GitLab CI、Jenkins）也普遍采用 Buildx。

为什么需要 Buildx

传统docker build存在一些局限：

例如：

开发机：

Mac M1 arm64

生产服务器：

Linux amd64

传统方式：

dockerbuild.

生成的是：

linux/arm64

部署到 x86 服务器：

exec format error

Buildx 可以直接构建：

dockerbuildx build\--platformlinux/amd64,linux/arm64.

一次生成：

amd64 arm64

多架构镜像。

Buildx 架构原理

Buildx 的核心架构：

Docker CLI ↓ Buildx ↓ BuildKit ↓ Builder Instance ↓ Container Driver Docker Driver Kubernetes Driver Remote Driver ↓ Image Registry

工作流程：

Dockerfile ↓ 解析依赖 ↓ BuildKit DAG ↓ 并行执行 ↓ 缓存复用 ↓ 镜像生成 ↓ push/load/export

BuildKit 会把 Dockerfile 转换成：

DAG Directed Acyclic Graph 有向无环图

例如：

COPY package.json COPY src/ RUN npm install RUN npm build

BuildKit 可以发现：

COPY src COPY package 互不依赖

于是可以：

并行执行

提高构建效率。

安装 Buildx

查看 Buildx 版本（docker buildx version）

查看当前版本。

dockerbuildx version

输出：

github.com/docker/buildx v0.25.0

查看 Buildx 信息（docker buildx inspect）

dockerbuildx inspect

示例：

Name: default Driver: docker-container Platforms: linux/amd64 linux/arm64

查看当前 Builder（docker buildx ls）

列出所有 Builder。

dockerbuildxls

示例：

NAME/NODE default multiarch builder0

Builder 管理命令

Buildx 最大特点之一就是 Builder 实例。

一个 Builder 可以理解成：

一个独立的 BuildKit 环境。

创建 Builder（docker buildx create）

创建新的 Builder。

dockerbuildx create--namemybuilder

使用：

dockerbuildx create\--namemultiarch

指定驱动：

dockerbuildx create\--driverdocker-container

启动 Builder（docker buildx create --use）

创建并切换。

dockerbuildx create\--namemultiarch\--use

使用 Builder（docker buildx use）

切换 Builder。

dockerbuildx use multiarch

删除 Builder（docker buildx rm）

dockerbuildxrmmultiarch

停止 Builder（docker buildx stop）

dockerbuildx stop

启动 Builder（docker buildx inspect --bootstrap）

初始化 Builder。

dockerbuildx inspect--bootstrap

会自动启动 BuildKit。

镜像构建命令

构建镜像（docker buildx build）

这是 Buildx 最核心命令。

dockerbuildx build.

指定镜像名称：

dockerbuildx build\-tdemo:v1.

构建并加载到本地（--load）

Buildx 默认不会导入本地 Docker。

需要：

dockerbuildx build\--load.

或者：

dockerbuildx build\-tapp:latest\--load.

等价于：

docker image load

构建并推送（--push）

dockerbuildx build\--push\-tregistry/app:v1.

Buildx 多平台构建通常需要直接推送。

dockerbuildx build\--platformlinux/amd64,linux/arm64\--push\-tdemo/app:v1.

输出 OCI 镜像（--output）

输出到文件。

dockerbuildx build\--outputtype=oci.

输出 tar。

dockerbuildx build\--outputtype=docker,dest=image.tar

导出本地目录（--output type=local）

dockerbuildx build\--outputtype=local,dest=./dist

适合：

前端构建 静态网站 编译产物输出

多平台构建

指定平台（--platform）

Buildx 最重要功能。

dockerbuildx build\--platformlinux/amd64.

多个平台：

dockerbuildx build\--platformlinux/amd64,linux/arm64

支持：

linux/amd64 linux/arm64 linux/arm/v7 linux/arm/v6 linux/ppc64le linux/s390x

查看支持平台：

dockerbuildx inspect

多平台构建并推送（--platform + --push）

dockerbuildx build\--platformlinux/amd64,linux/arm64\-tmyapp:v1\--push.

最终 Registry 中会生成：

Manifest List ├── amd64 ├── arm64

客户端下载时自动匹配。

例如：

Mac M2 ↓ arm64

Ubuntu Server ↓ amd64

缓存机制

Buildx 的缓存能力远强于传统 Docker。

导出缓存（--cache-to）

dockerbuildx build\--cache-totype=local,dest=.cache

导入缓存（--cache-from）

dockerbuildx build\--cache-fromtype=local,src=.cache

Registry 缓存：

dockerbuildx build\--cache-to=type=registry,ref=myrepo/cache

dockerbuildx build\--cache-from=type=registry,ref=myrepo/cache

GitHub Actions：

type=gha

--cache-totype=gha

--cache-fromtype=gha

非常适合 CI/CD。

Buildx 参数大全

--platform：指定目标平台

--platformlinux/amd64

--push：推送镜像

--push

--load：加载到本地

--load

--tag或 -t：指定标签

-tapp:v1

--file或-f：指定 Dockerfile

-fDockerfile.prod

--build-arg：传递构建参数

--build-argENV=prod

Dockerfile：

ARG ENV

--cache-from：导入缓存

--cache-fromtype=local

--cache-to：导出缓存

--cache-totype=local

--secret：传递 Secret

--secretid=token,src=token.txt

Dockerfile：

RUN --mount=type=secret,id=token

--ssh：SSH 转发

dockerbuildx build\--sshdefault

Dockerfile：

RUN --mount=type=ssh

适用于：

私有 Git 仓库 私有依赖下载 企业内部仓库

--output：输出格式

--outputtype=docker

--outputtype=oci

--outputtype=local

--outputtype=tar

--progress：日志显示模式

--progressauto

--progressplain

--progresstty

CI 中推荐：

--progressplain

Buildx 驱动类型

docker 驱动

Driver=docker

直接复用 Docker Engine。

优点：

简单 无需额外容器

缺点：

功能有限 不支持完整多平台

docker-container 驱动

推荐方案。

dockerbuildx create\--driverdocker-container

优点：

功能完整 支持缓存 支持多架构 支持 BuildKit

补充：Docker Buildx 中 docker 驱动和 docker-container 驱动的区别

核心区别概述

1.docker 驱动

Driver=docker

工作原理：

• 直接复用现有的 Docker Engine
• 作为 Docker 守护进程的一部分运行
• 不创建额外的容器

优点：

• 简单易用：无需额外配置，开箱即用
• 资源占用少：不需要启动额外的容器
• 启动快速：没有容器初始化开销

缺点：

• 功能有限：仅支持基础构建功能
• 不支持多平台构建：无法同时为不同架构（如 amd64, arm64）构建镜像
• 不支持并发构建：无法并行执行多个构建任务
• 缓存机制简单：缺乏高级缓存优化
• 不支持 BuildKit 高级特性：无法使用 BuildKit 的所有功能

2.docker-container 驱动（推荐）

dockerbuildx create--driverdocker-container

工作原理：

• 在独立的 Docker 容器中运行 BuildKit
• 通过容器隔离构建环境
• 完全独立于主机 Docker Engine

优点：

• 功能完整：支持所有 BuildKit 特性
• 多平台构建：可以同时为多种 CPU 架构构建镜像
• 并发构建：支持并行执行多个构建任务，大幅提升效率
• 高级缓存：支持更复杂的缓存策略和优化
• 隔离性好：构建环境与主机环境完全隔离
• 可扩展性：可以配置多个构建节点

缺点：

• 需要额外容器：会启动一个专门的构建容器
• 资源开销稍大：需要额外的内存和 CPU 资源
• 配置稍复杂：需要手动创建 builder 实例

详细对比

使用建议

选择docker驱动的场景：

• 仅需要构建单一平台的镜像
• 资源受限的环境（如低配服务器）
• 快速原型验证
• 简单的 CI/CD 流程

选择docker-container驱动的场景（推荐）：

• 生产环境：需要完整功能和稳定性
• 多平台支持：需要为不同架构（x86_64, ARM64, ARMv7 等）构建镜像
• 高性能需求：需要并发构建来加速构建流程
• 复杂项目：需要高级缓存和优化特性
• CI/CD 流水线：需要可重复、隔离的构建环境

实际应用示例

# 创建 docker-container 驱动的 builderdockerbuildx create--namemybuilder--driverdocker-container--use# 验证支持的平台dockerbuildx inspect--bootstrap# 多平台构建示例dockerbuildx build--platformlinux/amd64,linux/arm64,linux/arm/v7\-tmyapp:latest--push.

总结：虽然docker驱动在简单场景下更轻量，但docker-container驱动提供了完整的功能集和更好的扩展性，是现代容器化开发和生产的推荐选择。除非有特殊的资源限制，否则建议优先使用docker-container驱动。

kubernetes 驱动

BuildKit 运行在 Kubernetes。

buildkitd Pod ↓ 集群构建

适合：

大型 CI 云原生平台 企业构建集群

remote 驱动

连接远程 BuildKit。

tcp://builder:1234

适合：

共享构建节点 集中式构建

Buildx 实战案例

构建 AMD64 与 ARM64 镜像

dockerbuildx build\--platformlinux/amd64,linux/arm64\-tmyapp:v1\--push.

GitHub Actions 多平台发布

-uses:docker/setup-buildx-action@v3-uses:docker/build-push-action@v6with:platforms:linux/amd64,linux/arm64push:truetags:myapp:latest

使用缓存提升 CI 速度

dockerbuildx build\--cache-from=type=gha\--cache-to=type=gha,mode=max

构建时间通常可以减少：

50%~90%

Buildx 与 docker build 对比

总结

Buildx 已经成为 Docker 官方推荐的镜像构建方案。

它不仅仅是docker build的升级版，更是 BuildKit 能力的统一入口。

对于现代云原生开发来说，Buildx 几乎已经成为必备工具：

• 多架构镜像发布
• GitHub Actions 自动化构建
• 高性能缓存
• 分布式 Builder
• Kubernetes 集群构建
• OCI 镜像输出

如果只记住一句话：

docker build 用于传统构建，而 docker buildx build 是面向云原生时代的镜像构建标准工具。