docker 镜像在不同 cpu 架构上运行容器报错的问题解决

Docker镜像跨架构问题与解决方案

最新推荐文章于 2025-11-20 12:30:02 发布

原创最新推荐文章于 2025-11-20 12:30:02 发布 · 4.1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#docker

在x86架构上构建的Docker镜像默认无法在ARM架构上运行。要解决这个问题，需在Dockerfile中使用`--platform`参数指定CPU架构，如`FROM--platform=linux/arm64node:14.18.3-alpine3.15`，确保镜像与目标硬件兼容。

如果是在 x86 架构机器上制作的镜像, 如果没有指定操作系统, docker 会根据宿主机的 cpu 架构自动选择对应架构的版本.
这会导致一个问题, x86 做的镜像无法在 arm cpu 上运行.

如何查看你在本地镜像的 cpu 架构类型?

docker inspect [镜像 ID]

信息中有: "Architecture", "Os" 这两个可以确定当前镜像的 cpu 架构.

"Architecture": "arm64",
"Variant": "v8",
"Os": "linux",

要解决这个问题, 需要在构建镜像时指定 cpu 架构.

原来我们在 Dockerfile 引入基础包是下面这样:

FROM node:14.18.3-alpine3.15

需要添加参数 "--platform" 用来指定 cpu 架构类型

FROM --platform=linux/arm64 node:14.18.3-alpine3.15

该参数的值需要去 hub.docker.com 查找对应包的 "OS/ARCH" 信息
在这里插入图片描述
这样，就可以制作指定 cpu 架构的镜像了

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

雷德拉姆被占用

关注关注

1
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

解决Docker镜像打包报错“exec format error”

✨ 欢迎来到【Seal ^_^ 的优快云博客】！✨

09-16

1万+

当在Docker中遇到“exec format error”时，这通常意味着容器试图执行一个与其架构不兼容的程序。以下是一些简洁的步骤来诊断和解决这个问题：

Docker镜像多架构构建

xiayping的博客

07-17

1057

基于多架构(ARM、X86)模式下通过manifest实现镜像的构建

参与评论您还未登录，请先登录后发表或查看评论

为什么你的镜像无法在ARM运行？Docker Buildx平台列表告诉你真相

最新发布

FastDebug的博客

11-20

762

解决跨平台镜像兼容难题，掌握Docker Buildx 平台列表精准构建多架构镜像。适用于ARM、AMD等场景，通过buildx指定目标平台实现一键编译，提升部署效率。开发运维必看，值得收藏

docker部署Minio报错:Fatal glibc error: CPU does not support x86-64-v2

州仔

03-12

4044

经过研究,最终确定是版本太新,需要的系统配置不满足~目前解决方法要么升级到centos8,要么降低版本;因项目经费有限,最终决定降低版本;在使用centos7使用docker部署Minion的时候,发现部署失败。发现报错:CPU does not support x86-64-v2。docker logs <容器id>1.拉取minio镜像。

VirtualBox6.1安装类似Rhel9的x86版本的cpu不支持问题

redhat77的博客

09-04

4341

今年5月10日发布了RHEL9(Red hat Enterprise Linux9)，RHEL9发行版安装要求x86硬件CPU本身要支持x86-64-v2的微架构。vbox如何才能正确识别cpu保障安装。

超详细的ARM架构适配介绍

Cloudpods的博客

01-22

4711

本文主要介绍云联壹云平台如何适配ARM，并运行在ARM CPU架构的机器上。背景介绍 1、平台服务运行架构云联壹云平台采用容器化，分布式的架构运行在 Kubernetes（K8s）之上。下面是平台服务运行的架构图：在多个节点之上，我们会构建Kubernetes的集群，它是一个容器管理的平台。在Kubernetes的平台之上，后端服务都是容器化的，是以容器的方式去分布式运行。通过K8s去做调度的管理，然后将服务自动地打散到多个节点上运行，总结两点是服务容

注意避坑：centos7官方版镜像不支持arm架构（docker请求的映像的平台（linux/aamd64）与检测到的主机平台（linux/alm64/v8）不匹配）fauria/vsftpd

Dontla的博客

06-28

4829

社区支持：虽然官方版CentOS不支持ARM架构，但是有一些非官方的CentOS衍生版本可以在ARM架构上运行，由第三方社区维护。这些社区版本提供了对ARM架构的支持，并且在一些ARM开发板上得到了广泛的应用和支持。由于ARM架构的设备相对较少，社区资源有限，因此官方版CentOS选择集中精力在x86架构上进行开发和支持。然而，有一些非官方的CentOS 7衍生版本可以在ARM架构上运行，例如CentOS 7 for ARM64（aarch64）和CentOS 7 for ARM32（armhfp）。

linux内核区分cpu架构,docker镜像区分cpu架构么

weixin_36343299的博客

05-11

554

一、Docker镜像要理解Docker镜像和Docker容器之间的区别，确实不容易。假设Linux内核是第0层，那么无论怎么运行Docker，它都是运行于内核层之上的。这个Docker镜像，是一个只读的镜像，位于第1层，它不能被修改或不能保存状态。一个Docker镜像可以构建于另一个Docker镜像之上，这种层叠关系可以是多层的。第1层的镜像层我们称之为基础镜像(BaseImage)，其他层的镜像...

制作ARM架构 docker镜像

l00102795的博客

05-27

1381

Docker 客户端有两种替代选项：名为docker的命令行应用程序或名为 Docker Desktop 的基于图形用户界面 (GUI) 的应用程序。CLI 和 Docker Desktop 均与 Docker 服务器交互。来自 CLI 或 Docker Desktop 的docker命令使用 Docker REST API 将指令发送到本地或远程服务器，并作为用于管理容器的主要接口。

arm架构linux运行docker失败,完美解决ARM32架构下的Docker环境，OpenJDK官方没有8版本镜像，树莓派4b逐步操作示例...

weixin_42299018的博客

04-30

1012

本文参考：https://blog.youkuaiyun.com/boling_cavalry/article/details/101855126，感谢提供思路多的不说，情况大家都知道常规开发都是基于64位cpu，在树莓派直接docker pull java:8，实际上在运行的时候报错不能正常运行，因为咱们的cpu是arm架构的，要想成功运行，必须要准备能在本arm电脑上正常运行的jdk版本，同时再编译成do...

docker同一镜像启动多个容器报错

01-27

### 解决同一 Docker 镜像启动多个容器时的问题当使用同一个 Docker 镜像尝试启动多个容器时，可能会遇到一些特定的错误。以下是常见问题及其对应的解决方案： #### 1. 端口冲突如果多个容器试图绑定相同的主机...

Docker镜像运行架构兼容问题

thexx的博客

04-27

732

docker 启动镜像时提示，发现原因是当 Docker 镜像的架构与宿主机的 CPU 架构不匹配时，，并抛出类似 exec format error或 exec user process caused "exec format error"的错误。这是因为不同 CPU 架构（如 x86_64和ARM64）的二进制文件（如可执行程序、Python 解释器等）的指令集不兼容。操作系统内核无法在不同架构之间直接运行二进制文件，除非通过虚拟化或模拟器（如 QEMU）实现跨架构运行。

Docker跨CPU架构使用

小郑的专栏

03-09

4432

CPU架构 amd64、x86、arm64、mips64el等等，amd64CPU架构的电脑默认是不能使用其他架构的镜像，但可以通过qemu的技术来实现，Docker跨CPU使用。举例说明 x86_64 CPU架构的电脑运行 ARM64 的docker镜像。 1、下载所需平台的解释器 https://github.com/multiarch/qemu-user-stati...

不同cpu平台互传docker镜像

weixin_40548182的博客

08-02

478

说明:不同的平台之间docker镜像不能共用，假如使用mac pull的镜像，load 到amd平台上不能使用。但是可以在pull镜像使用 --platform linux/amd64 pull amd64 架构的镜像。

多CPU平台的docker 镜像

niekunhit的博客

09-10

446

https://medium.com/@mauridb/docker-multi-architecture-images-365a44c26be6

x86平台运行arm64平台docker 镜像

SpringLei

09-15

4123

本文介绍在x86服务器上安装qemu-aarch64-statick仿真器，以实现x86服务器可以运行docker或docker-compose镜像。

arm架构linux运行docker镜像,ARM架构下的Docker环境，OpenJDK官方没有8版本镜像，如何完美解决？...

weixin_42456278的博客

05-11

988

为什么需要ARM架构下的OpenJDK8的Docker镜像？对现有的Java应用，之前一直运行在x86处理器环境下，编译和运行都是JDK8，如今在树莓派的Docker环境运行(或者其他ARM架构电脑，例如华为泰山服务器)，需要JDK8镜像作为基础镜像。现在有什么问题？在《ARM64架构下，OpenJDK的官方Docker镜像为何没有8版本？》一文中，已经确定了OpenJDK官方并未提供8版本的Do...

Docker大学生看了都会系列（九、Docker使用Buildx构建不同CPU架构镜像）

Sahara_Savage

06-12

2263

Docker使用Buildx构建不同CPU架构镜像。

使用 docker buildx 构建多 CPU 架构镜像

Aug_Spark的博客

11-25

707

简介：MariaDB 是一个开源的关系型数据库管理系统，向后兼容，可替代 MySQL。本文主要为大家介绍如何在 Ubuntu 20.04 上安装 MariaDB。镜像下载、域名解析、时间同步请点击阿里巴巴开源镜像站 MariaDB 是一个开源的关系型数据库管理系统，向后兼容，可替代 MySQL。本文将会讲解如何在 Ubuntu 20.04 上安装和维护 MariaDB。一、前提条件你需要拥有 Ubuntu 服务器的管理权限，或者以 root 身份或者以拥有 sudo 权限的用户身份登录..