在arm64主机上强制运行amd64镜像（Docker Compose场景）

下面是针对性的排查和解决步骤：

先确认Docker Compose版本 #

旧版的docker-compose（1.x系列）确实不支持platform参数，必须升级到2.x以上的官方整合版（现在官方推荐使用不带横杠的docker compose命令）。
升级命令：

sudo apt-get update && sudo apt-get install docker-compose-plugin

验证版本：执行docker compose version，确保输出为2.x及以上版本。

清理本地冲突镜像 #

如果之前已经拉取过arm64版本的目标镜像，Docker会优先复用本地镜像，无视你的平台配置。先删除本地的冲突镜像：

docker rmi [my image]

之后重新拉取或构建指定平台的镜像：

# 拉取远程镜像
docker compose pull
# 本地构建镜像的话用这条
docker compose build --platform linux/amd64

检查docker-compose.yaml的配置位置 #

确保platform字段配置在服务层级下，而非根层级，示例如下：

version: '3.8'
services:
  simulator-service:
    image: [my image]
    platform: linux/amd64
    # 其他noVNC相关配置项...

配置Ubuntu虚拟机的跨平台模拟 #

如果你的Ubuntu虚拟机运行在arm64硬件上，需要开启QEMU模拟才能运行amd64架构的镜像：

1. 安装qemu-user-static工具：

sudo apt-get install qemu-user-static

2. 启用binfmt_misc，让Docker识别并模拟amd64环境：

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

确保环境变量生效 #

设置DOCKER_DEFAULT_PLATFORM后，必须在同一个终端窗口执行docker compose up，否则环境变量不会生效。如果要永久生效，可将变量写入bash配置文件：

echo "export DOCKER_DEFAULT_PLATFORM=linux/amd64" >> ~/.bashrc
source ~/.bashrc

额外注意事项 #

• Dockerfile中的平台指定需放在FROM指令中：

FROM --platform=linux/amd64 ubuntu:22.04
# 后续构建步骤...

• 彻底弃用旧版docker-compose命令，统一使用新版docker compose，其对平台参数的支持更完善。

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