共计 851 个字符，预计需要花费 3 分钟才能阅读完成。

Docker 跨架构运行指南：使用 QEMU 实现 ARM 容器在 x86 主机运行

背景介绍

在 x86_64 架构的主机上运行 ARM 架构（如 arm64/aarch64）的 Docker 容器时，会遇到架构不兼容问题。本指南介绍如何使用 QEMU 用户态模拟解决这一问题。

前置条件

• 基于 x86_64 架构的 Linux 主机
• 已安装 Docker 引擎
• root 或 sudo 权限

解决方案步骤

1. 验证主机架构

dpkg --print-architecture
# 或
uname -m

预期输出为 amd64 或 x86_64。

2. 安装 QEMU 用户态模拟

sudo apt-get update
sudo apt-get install -y qemu-user-static

3. 注册 QEMU 解释器

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

此命令会:

• 注册所有支持的架构解释器
• 设置持久化 (-p 参数)
• 重置之前的注册信息 (--reset)

4. 运行跨架构容器

基本方式

docker run -t --rm \
  --platform linux/arm64 \
  -v /usr/bin/qemu-aarch64-static:/usr/bin/qemu-aarch64-static \
  debian:11 \
  uname -m

推荐方式（使用已注册的解释器）

docker run -t --rm --platform linux/arm64 your-arm64-image your-command

5. 验证容器架构

在容器内运行：

uname -m

预期输出应为 aarch64。

常见问题排查

问题1：仍然出现 "exec format error"

解决方案：

1. 确保已正确安装 qemu-user-static
2. 重新注册解释器：

docker run --rm --privileged multiarch/qemu-user-static --reset

3. 检查镜像是否确实是 ARM 架构：

docker inspect --format='{{.Architecture}}' your-image