如何无需运行容器从Docker多架构镜像中提取文件？

以下两种方案均无需运行目标架构容器，完全适配x86-64主机提取ARM等异构架构镜像内文件的场景，不需要额外配置QEMU等跨架构运行组件。

方案1：构建阶段直接导出产物（最高效，编译场景推荐） #

利用Docker Buildx自带的输出能力，构建完成后直接把指定编译产物导出到本地目录，全程不需要生成最终镜像、更不需要启动容器，天然支持跨架构操作。
操作步骤：

• 调整现有多阶段构建Dockerfile，新增纯导出阶段，仅保留需要提取的模块文件：

# 原有编译阶段，可命名为builder
FROM --platform=$BUILDPLATFORM debian:bookworm as builder
# 保留你原有的Nginx模块编译逻辑，假设最终编译生成的模块路径为/usr/lib/nginx/modules/your_custom_module.so

# 新增空的导出阶段，基于scratch无多余系统文件
FROM scratch as artifact
COPY --from=builder /usr/lib/nginx/modules/your_custom_module.so /your_custom_module.so

• 构建目标架构时指定本地输出即可，比如编译ARM64版本产物：

docker buildx build \
  --platform linux/arm64 \
  --target artifact \
  --output type=local,dest=./output/arm64 \
  -f Dockerfile .

命令执行完成后，对应架构的编译模块会直接出现在./output/arm64目录下，全程无容器运行步骤，不受本地主机架构限制。

方案2：从已构建完成的多架构镜像提取（无需重新编译） #

如果多架构镜像已经构建完成（存在本地缓存或镜像仓库），可利用docker create的特性提取文件：docker create仅会创建容器元数据和可写层，不会执行镜像内的任何二进制程序，因此完全不存在跨架构运行兼容问题。
操作步骤：

• 针对目标架构创建不会启动的临时容器，以提取ARM64架构镜像内文件为例：

docker create \
  --name temp_ngx_mod_extract \
  --platform linux/arm64 \
  your-built-nginx-module-image:latest

• 直接从未运行的临时容器中拷贝目标文件到本地：

docker cp temp_ngx_mod_extract:/path/to/your_custom_module.so ./local_arm64_module.so

• 提取完成后删除临时容器即可：

docker rm temp_ngx_mod_extract

注意事项 #

• 不要使用docker run创建临时容器，该命令会触发镜像内入口程序执行，跨架构场景下会直接报运行时错误。
• 上述两种方案均基于Docker原生能力实现，不需要安装第三方工具，操作成本极低。

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