如何在ARM64架构上通过Docker Compose使用x86-64 Docker镜像

针对你的需求——无需跟踪上游Dockerfile、允许后台构建、依赖均支持ARM64——以下是两种可行方案：

方案1：Docker Buildx自动基于上游镜像构建ARM64版本（推荐） #

此方法直接复用上游amd64镜像的配置，由Docker自动为ARM64环境构建适配版本，完全不用你维护自定义镜像或跟踪上游变更。

操作步骤： #

1. 确认Docker Buildx已安装
   树莓派的Docker通常自带Buildx，执行以下命令验证：

   docker buildx version
   

   若未安装，执行apt install docker-buildx-plugin（Debian/Ubuntu系）完成安装。

2. 修改docker-compose.yml配置
   用build字段替代原有的image字段，指定上游镜像作为构建基础，同时指定ARM64平台。以Dovecot为例：

   version: "3.8"
   services:
     dovecot:
       build:
         context: .
         dockerfile: Dockerfile.dovecot
         platforms: ["linux/arm64"]
       # 保留你原有的Traefik标签、卷挂载、端口映射等配置
       labels:
         - "traefik.enable=true"
         # 你的Traefik路由规则...
       volumes:
         - ./dovecot-config:/etc/dovecot
         - ./mail-storage:/var/mail
   

   在当前目录创建极简的Dockerfile.dovecot，仅引用上游镜像（无需任何自定义修改）：

   FROM dovecot/dovecot:latest
   

3. 启动服务
   执行你原本的启动命令，Buildx会自动在后台完成ARM64镜像的构建与部署：

   docker compose up -d
   

   后续更新时，只需执行docker compose pull && docker compose up -d，Buildx会自动重新构建适配ARM64的最新版本。

方案2：QEMU跨架构模拟（快速临时方案） #

若不想等待构建，可直接用QEMU模拟amd64环境运行上游镜像，配置简单但性能略低（适合低负载场景）。

操作步骤： #

1. 启用Docker跨架构模拟支持
   执行以下命令注册QEMU模拟，无需重启Docker：

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

2. 直接使用上游镜像
   在docker-compose.yml中保留原有的image字段配置，Docker会自动用QEMU模拟运行amd64镜像：

   version: "3.8"
   services:
     dovecot:
       image: dovecot/dovecot:latest
       # 你的Traefik配置、卷挂载等保持不变
       labels:
         - "traefik.enable=true"
         # ...
   

   执行docker compose up -d即可启动服务。

关键说明 #

• 方案1的构建过程完全复用上游镜像的所有配置，你无需跟踪上游Dockerfile的任何变更，仅由Docker自动处理ARM64适配。
• 方案2的模拟模式对IO密集型服务（如邮件服务）可能有性能损耗，但轻量场景下可正常使用。
• 两种方案均无需你自行维护镜像，更新时只需拉取上游最新版本即可。

内容的提问来源于stack exchange，提问作者JepZ