Buildx构建异构docker平台镜像(x86-ARM)

已于 2025-03-12 21:33:05 修改
阅读量1.4k 收藏 18
点赞数 7
文章标签： linux 容器 arm开发 docker 运维 服务器 windows
于 2025-03-12 21:32:08 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_51924657/article/details/146215548
版权

一、Docker的安装与操作

Docker的安装、创建、等操作可以查看Docker 教程 | 菜鸟教程 (runoob.com)，这里不再赘述。

常见问题1：**普通用户使用docker命令报错: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get “http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json”: dial unix /var/run/docker.sock: connect: permission denied？

原因：

docker进程使用Unix Socket而不是TCP端口，而默认情况下，Unix socket属于root用户，需要root权限才能访问。

解决方法：

docker守护进程启动的时候，会默认赋予名字为docker的用户组读写Unix socket的权限，因此只要创建docker用户组，并将当前用户加入到docker用户组中，那么当前用户就有权限访问Unix socket了，进而也就可以执行docker相关命令。

#添加docker用户组(如果docker用户组已存在会提示)
sudo groupadd docker 
#将登陆用户加入到docker用户组中
sudo gpasswd -a $USER docker  
#更新用户组
newgrp docker 
#测试docker命令是否可以直接使用
docker ps

二、Buildx构建多平台镜像

1、Buildx 简介

Docker Buildx 是 Docker的CLI插件，来自于Moby BuildKit 。自从Docker 18.06 开始这个插件直接集成到了Docker build 中，直至成文之日，它仍处于Experimental状态，所以想使用它需要显式地开启它。

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

大致流程为： docker --> buildx -->builder(moby/buildkit:buildx-stable-1)–>image(arm64)

2、Buildx的安装

提示：如果已经安装了buildx，无需额外安装，可通过命令docker buildx version 确认其是否安装成功。

#在线安装docker-buildx
sudo apt-get install docker-buildx
#查看是否安装成功
docker buildx version

3、查看当前构建器支持的平台

#查看当前构建器的情况
 docker buildx ls
# NAME/NODE DRIVER/ENDPOINT STATUS  BUILDKIT             PLATFORMS
#default * docker                                       
#  default default         running v0.11.7+d3e6c1360f6e linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386

#回显内容Platforms列中的linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/386默认构建器支持的架构平台。
#如果默认构建器包含了所需的平台则跳过这一节，可以直接拉取对应架构平台的docker镜像。
#这里我们要创建arm64的docker，显然不支持，所以要重新创建一个构建器。

4、创建Buildx构建容器

#创建构建器，名为mybuilder，可以任意起名
docker buildx create --name mybuilder
#buildx使用新建的构建器
docker buildx use mybuilder
#初始化构建器(这个过程比较久)
docker buildx inspect --bootstrap

当初始化成功，会拉下来moby/buildkit:buildx-stable-1的镜像，并启动构建容器。通过 docker ps 查看如下：

root@hz:~# docker ps
root@hz:~# docker ps
CONTAINER ID   IMAGE                           COMMAND       CREATED       STATUS          PORTS     NAMES
ba6651e07ab0   moby/buildkit:buildx-stable-1   "buildkitd"   5 weeks ago   Up 50 minutes             buildx_buildkit_mybuilder0

5、构建ARM64镜像

docker镜像命令参考Docker 教程 | 菜鸟教程 (runoob.com)

方法一

如果已经有arm64的docker image，可以直接导入image，启动docker。

导入容器

如果要导出其他设备的某个容器，可以使用 docker export 命令。

$ docker export 1e560fca3906 > ubuntu.tar

导入容器

可以使用 docker import 从容器快照文件中再导入为镜像，以下实例将快照文件 ubuntu.tar 导入到镜像 test/ubuntu:v1:

$ cat docker/ubuntu.tar | docker import - test/ubuntu:v1

(2) 获取镜像

Docker镜像的查询地址https://hub.docker.com/

#拉取arm架构镜像
docker pull  --platform=arm64  ubantu:latest

6、启动docker验证架构

启动容器

$ docker run -it ubuntu /bin/bash

验证

#进入docker查看docker架构
uname -m
#aarch64
#退出docker，查看外部内核架构信息
exit
uname -m
#x86_64

到这里就完成了。

常见问题1：

**初始化构建器失败：**ERROR: Error response from daemon: No such image: moby/buildkit:buildx-stable-1

请添加图片描述

原因： Docker默认去https://registry-1.docker.io拉镜像，因为不能联网，所有连接错误。

解决方法： 外网下载镜像，再导入内网。

# 外网节点拉取镜像
$ docker pull moby/buildkit:buildx-stable-1@sha256:273b61ca4f538c120c8555b4e7c59e903bd5bdfc72d93439e75f46fcf1f4e135

# 外网节点导出镜像
$ docker save -o moby_buildkit_buildx-stable-x-arm64.tar 9b3c7392ac9e

# 内网节点导入镜像
$ docker load -i moby_buildkit_buildx-stable-x-arm64.tar 9b3c7392ac9e
$ docker tag 9b3c7392ac9e moby/buildkit:buildx-stable-1

三、另一种方法：buildx和binfmt

Binfmt 使用了流行的容器技术——Docker，构建和分发模拟器。它可以构建并安装QEMU-user模拟器的本地版本，让你能够执行非本机架构的程序。该项目提供了便捷的命令行工具，用于安装、卸载和管理这些模拟器。此外，它还与 BuildKit 集成，为自动化构建过程中的多平台仿真提供支持。

Binfmt 对应的仓库名称是：tonistiigi/binfmt:latest。

buildx的安装参考上面第二章。

1、在线安装binfmt

$ docker run --privileged --rm tonistiigi/binfmt --install all

# 验证模拟器是否安装成功
$ docker buildx ls 
default       docker
  default     default    running   linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6

# 查看某个，检查aarch64是否安装成功
$ cat /proc/sys/fs/binfmt_misc/qemu-aarch64
enabled
interpreter /usr/bin/qemu-aarch64
flags: OCF
offset 0
magic 7f454c460201010000000000000000000200b7

2、离线安装

# 外网下载镜像，注意（如果你的内网环境机器是arm架构，就下载arm版本，如果你的内网环境机器是amd架构，就下载amd版本；这里我下载的是arm版本）
$ docker pull tonistiigi/binfmt:latest@sha256:01882a96113f38b1928a5797c52f7eaa7e39acf6cc15ec541c6e8428f3c2347d
# 导出镜像
$ docker save -o tonistiigi_binfmt_arm64.tar f1d8c13be37e
# 将导出的镜像上传至内网服务器
$ scp tonistiigi_binfmt_arm64.tar xxxx:/xxx
# 在内网机器执行如下命令，导入镜像
$ docker load -i tonistiigi_binfmt_arm64.tar
# 安装模拟器
$ docker run --privileged --rm tonistiigi/binfmt --install all

# 验证是否安装成功
$ docker buildx ls 
default       docker
  default     default    running   linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6

# 验证arm机器上的amd模拟器是否安装成功，则执行如下命令，输出结果包含enable即可
$ cat /proc/sys/fs/binfmt_misc/qemu-x86_64
enabled

# 如果你是amd机器，需要验证arm模拟器是否安装成功，则执行如下命令，输出结果包含enable即可
$ cat /proc/sys/fs/binfmt_misc/qemu-aarch64
enabled
docker：记录如何在x86架构上构造和使用arm架构的镜像
qq_32202885的博客
07-19 6311
为了国产化适配，要求讲原先在x86上的docker镜像重新打包为能够在arm上使用的docker镜像。docker提供了构建多平台镜像的插件buildx，
Docker Buildx最佳实践：多架构镜像构建指南
zzjlhlcd的博客
03-27 747
Docker Buildx作为官方提供的增强工具，使得开发者能够更简单、更高效地为不同架构创建一致的容器镜像，极大地提升了开发效率和应用的可移植性。它使得用户可以创建多平台（包括不同的CPU架构如AMD64、ARM等）的 Docker 镜像，并且支持更复杂的构建场景。随着技术的不断演进，我们期待Docker Buildx能带来更多创新功能，继续推动容器化技术和云原生应用的发展，帮助开发者更好地满足多样化的业务需求。：允许用户管理和使用多个 builder 实例，每个实例都可以配置为特定的构建选项集。
Docker 组件：Docker Buildx
最新发布
x²
04-15 588
Docker Buildx 是 Docker 官方提供的一个用于扩展构建功能的 CLI 插件，基于 BuildKit 构建引擎，可以实现多平台镜像构建、更高效的缓存利用、并发构建等高级构建能力。它是对传统命令的增强和扩展，特别适用于现代多架构容器部署场景（如 x86_64 和 ARM64）。Docker Buildx 是现代化容器构建流程的关键工具，特别适合构建跨平台镜像和高效自动化构建场景。通过 Buildx，你可以最大化发挥 Docker 构建的性能，支持 DevOps 流程中的复杂需求。
【Docker】 Manifest与Buildx：多架构镜像管理的解析与实践
师兄怎么办
02-06 708
manifest包含了镜像的层、标签、作者等关键信息，并支持多架构镜像的管理。通过Manifest List，开发者能够为同一应用提供适用于不同架构的镜像，从而确保其在各类平台上的兼容性。实际上是把不同操作系统和架构打包成独立的一个镜像，用户拉去镜像时根据用户的实际使用场景自动选择合适的架构镜像。manifest本身不能直接用于打包镜像，只是用于创建和管理包含多个不同镜像的清单列表（manifestlist），构建多架构镜像使用buildx技术进行。
2024年Linux CentOS 环境下安装JDK的三种方法(2)，2024年最新农民工看完都学会了
2401_83947434的博客
05-03 1328
为了做好运维面试路上的助攻手，特整理了上百道，让你面试不慌心不跳，高薪offer怀里抱！这次整理的面试题，本份面试集锦涵盖了1、什么是运维?2、在工作中，运维人员经常需要跟运营人员打交道，请问运营人员是做什么工作的?3、现在给你三百台服务器，你怎么对他们进行管理?4、简述raid0 raid1raid5二种工作模式的工作原理及特点5、LVS、Nginx、HAproxy有什么区别?工作中你怎么选择?6、Squid、Varinsh和Nginx有什么区别，工作中你怎么选择?
Docker - Docker Buildx
yueerba126的博客
10-11 4391
Docker Buildx 是 Docker CLI 的一个插件，它为 Docker 构建提供了全新的功能。它不仅保留了标准。
docker使用buildx构建多平台(x86,arm64)构架镜像
atzqtzq的博客
01-06 1万+
buildx 可用于在单个平台上实现,跨 CPU 架构编译。 buildx 实现 依赖 QEMU (开源的模拟器),支持多种cpu 架构
使用 docker buildx 构建跨平台镜像 (QEMU/buildx/build)
云满笔记
09-14 7661
使用 docker buildx 构建跨平台镜像 (QEMU/buildx/build)
docker buildx 构建arm64架构镜像
oneslide
05-11 1万+
前提条件 组件 版本 docker v20.10.15 rocky linux (centos 8) v8.5 安装 参考：Build multi-platform images 安装 docker run --privileged --rm tonistiigi/binfmt --install all 创建builder docker buildx create --use --name mybuild default 构建镜像 使用go语言为例子，参考这位大佬博客： cat
Docker构建跨平台镜像，信创必备，建议收藏备用
新质程序猿
08-14 2221
本文的分享不是针对完全小白的，有一定的技术门槛，需要你熟悉 docker 及容器化必要的知识，另外对于 服务器 的一些操作也是有一些要求的，不过我相信你应该能看得懂。一些机器或环境如果自己电脑不具备，比如 arm 机器，可以在云平台上开一个按量付费的主机，操作几个小时再释放就可以了，几毛钱的事情，很便宜，下一篇文章可以给大家介绍介绍怎么快速的在云上开一台测试机，妥妥的比自己搭建虚拟机要便捷的多，并且地域，网络环境，操作系统，CPU架构，应有尽有，如下图。
如何使用 docker pull 拉取指定架构的容器镜像
战术后仰
07-25 7419
如何通过 dockerd 实验属性，拉取异构的 docker 镜像。比如，在 x86_64 架构的服务器上拉取 arm64 镜像。
Docker实现异构容器的创建
weixin_38107316的博客
04-24 782
需求背景 需要在X86的环境中，生成非X86架构的Docker容器，譬如arm以及ppc等。 基本思路 需要借助一款类似于转译cpu指令的程序：qumu-user-static。每一个异构容器的内部指令都会通过此程序转译给底层的X86架构cpu，从而实现上述功能。 简要过程步骤 1. 首先打开Linux内核的binfmt功能。该功能就是告诉linux什么样的文件等该用什么样的程序打开。这里主要是为了让Linux知道，系统在运行arm等架构的程序指令时，自动调用qemu-user-static来执行。开启方式
x86 平台运行 arm 的方法
u010346142的博客
11-30 2339
最简单的x86平台(只支持x86_64)运行异构平台 docker 的办法
Docker（九）Docker Buildx
.正函数.的博客
01-21 1876
如果你有私有的镜像加速器，可以基于 https://github.com/docker-practice/buildx 构建自己的 buildkit 镜像并使用它。在之前的版本中构建多种系统架构支持的 Docker 镜像，要想使用统一的名字必须使用 $ docker manifest。这个文件夹，这样我们就省去了每次获取依赖的时间，大大增加了镜像构建效率，同时也避免了生成了大量的中间层镜像。等等，当我们构建一个镜像时，往往会重复的从互联网中获取依赖包，难以缓存，大大降低了镜像的构建效率。
Docker buildx 安装
热门推荐
sun%moon
04-25 2万+
文章目录简介开启实验室特性安装docker buildx安装模拟器Build多平台image问题及解决方法问题一问题二参考链接 简介 Docker buildx是docker的一个插件，它包含如下作用： 支持[Moby BuildKit](https://github.com/moby/buildkit) 的所有特性； 可以跨CPU架构编译镜像； 可以在跨多节点同时编译镜像。 本文主要介绍其在Linux上的安装过程。 备注：在Windows和macOs上，Docker Desktop已经包含了Docke
Docker Buildx 简介与安装指南(最新推荐)例子解析
IT老农民的博客
10-09 2197
确保您的系统中已安装 Docker，并且 Docker 服务正在运行。这会从 Docker Hub 上下载最新版本的 Nacos 镜像文件到您的本地机器上。启动完 Nacos 容器后，您可以通过访问 Nacos Web 控制台。如果您需要部署 Nacos 集群，您需要为每个节点指定不同的 IP 或主机名，并在中设置集群相关信息，或者通过环境变量传递。访问 Nacos 控制台，使用默认账号密码登录，确认 Nacos 服务正常运行。
Docker 利用buildx插件构建多平台镜像——筑梦之路
筑梦之路
03-16 4901
环境需求： docker版本：19.03+ linux内核版本：4.8+ 支持构建的目标平台： linux/amd64, linux/arm64, or darwin/amd64 linux/amd64, linux/arm64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6 ... 开启插件支持 #将参数添加到配置文件 vim ~/.docker/config.json "experimental".
docker buildx 在x86 架构平台打包arm 平台镜像
qq_45330223的博客
05-09 2756
最简单的docker buildx 打包步骤
linux 安装docker buildx
03-26
<think>好的，我现在需要帮用户解决在Linux上安装Docker Buildx的问题。首先，我得回顾用户之前的问题，看看有没有相关的背景信息。用户之前询问过如何排查Linux网络问题，现在转向Docker Buildx的安装，可能是在搭建开发或部署环境时遇到了问题。 用户可能已经安装了Docker，但需要Buildx来扩展构建功能，比如多平台构建。Buildx是Docker的一个插件，所以首先要确认Docker版本是否支持。通常Docker 19.03及以上版本自带Buildx，但可能需要手动启用或安装。 接下来，我需要考虑用户的操作系统环境。不同的Linux发行版安装方式可能略有不同，比如Debian/Ubuntu和CentOS/RHEL的包管理工具不同。但Docker官方通常推荐使用下载二进制文件的方式安装插件，这可能更通用。 用户可能遇到的问题包括：如何确认Buildx是否已经安装，如何启用实验性功能，或者如何配置Buildx使用不同的驱动程序，比如docker-container来支持多平台构建。此外，权限问题也可能出现，比如用户是否在docker组中，是否需要sudo等。 需要分步骤说明安装过程，包括检查Docker版本，安装Buildx，启用实验性功能，验证安装，以及可能的进阶配置。还要提醒用户注意常见问题，比如权限错误或无法使用多平台构建的情况。 另外，用户可能不知道Buildx需要Docker的实验性功能，所以需要指导如何编辑配置文件，如/etc/docker/daemon.json，并重启服务。还要提到创建builder实例，因为默认的builder可能不支持多平台。 最后，要确保命令的正确性，使用代码块标注，并给出示例输出，帮助用户确认每一步是否成功。同时，提供验证命令，如docker buildx version和docker buildx inspect，确保用户安装正确。</think>在 Linux 系统中安装并使用 `docker buildx`（Docker 的多平台构建工具）的完整流程如下： --- ### 一、前置条件 1. **已安装 Docker 引擎** 要求 Docker 版本 ≥ 19.03（推荐使用最新稳定版）。 验证 Docker 版本： ```bash docker --version ``` 2. **启用 Docker 实验性功能**（部分旧版本需要） - 编辑 Docker 配置文件： ```bash sudo nano /etc/docker/daemon.json ``` - 添加以下内容（若文件不存在则新建）： ```json { "experimental": true } ``` - 重启 Docker 服务： ```bash sudo systemctl restart docker ``` --- ### 二、安装 Buildx #### 方法 1：自动安装（Docker ≥ 20.10） - Docker 20.10+ 已内置 `buildx`，但需手动创建符号链接： ```bash mkdir -p ~/.docker/cli-plugins ln -s /usr/lib/docker/cli-plugins/docker-buildx ~/.docker/cli-plugins/ ``` #### 方法 2：手动安装（通用） 1. **下载二进制文件** ```bash # 获取最新版本号 BUILDX_VERSION=$(curl -s https://api.github.com/repos/docker/buildx/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/') # 下载并安装 wget https://github.com/docker/buildx/releases/download/v${BUILDX_VERSION}/buildx-v${BUILDX_VERSION}.linux-amd64 mkdir -p ~/.docker/cli-plugins mv buildx-v${BUILDX_VERSION}.linux-amd64 ~/.docker/cli-plugins/docker-buildx chmod +x ~/.docker/cli-plugins/docker-buildx ``` 2. **验证安装** ```bash docker buildx version ``` ✔️ 成功输出示例： ``` github.com/docker/buildx v0.11.2 4484c8c6 ``` --- ### 三、配置 Buildx 多平台构建 1. **创建并激活 Buildx 构建器** ```bash docker buildx create --name multiarch-builder --driver docker-container --use docker buildx inspect --bootstrap # 初始化构建器 ``` 2. **验证多平台支持** ```bash docker buildx ls ``` ✔️ 输出中应包含 `multiarch-builder` 且 `PLATFORMS` 列显示支持的系统架构（如 `linux/amd64, linux/arm64`）。 --- ### 四、使用 Buildx 构建多平台镜像 ```bash # 示例：同时构建 AMD64 和 ARM64 架构镜像 docker buildx build \ --platform linux/amd64,linux/arm64 \ -t your-image:tag \ --push . # 若需推送至镜像仓库，保留 --push 参数 ``` --- ### 五、常见问题解决 #### 1. 权限不足错误 ```bash # 将用户加入 docker 组 sudo usermod -aG docker $USER newgrp docker # 刷新组权限 ``` #### 2. 未启用实验性功能 - 确保 `/etc/docker/daemon.json` 已配置 `"experimental": true` - 重启 Docker：`sudo systemctl restart docker` #### 3. 多平台构建失败 - 安装 QEMU 模拟器： ```bash docker run --privileged --rm tonistiigi/binfmt --install all ``` - 确认内核支持： ```bash cat /proc/sys/fs/binfmt_misc/qemu-* ``` --- ### 六、进阶配置 | 场景 | 操作 | |--------------------------|----------------------------------------------------------------------| | 切换默认构建器 | `docker buildx use multiarch-builder` | | 删除构建器 | `docker buildx rm multiarch-builder` | | 查看构建器详情 | `docker buildx inspect --bootstrap` | | 本地构建缓存优化 | 添加 `--cache-from type=local,src=/path/to/cache` 参数 | --- 通过以上步骤，您可以在 Linux 系统中完整配置 `docker buildx`，并实现跨平台镜像构建。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

青铜发条

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值