首页/云/Docker 容器速查/COPY --from 引用外部镜像文件
镜像与构建107 条

COPY --from 引用外部镜像文件

--from 不仅可引用本文件内的构建阶段,也能直接引用任意镜像(含远程),用来提取工具、配置或运行时组件。

Docker 容器速查云更新于 2026-10-12
用途从其他镜像/阶段复制文件
语法COPY --from=镜像名或阶段名或序号 源 目标
示例用途取静态工具、内置配置、CA 证书

示例

示例
COPY --from=nginx:1.27-alpine /etc/nginx/nginx.conf /etc/nginx/nginx.conf
COPY --from=busybox:1.36 /bin/busybox /bin/busybox
COPY --from=0 /out/app /usr/local/bin/app
引用外部镜像时会先解析并拉取该镜像;固定版本 tag 或 digest,避免上游变化影响构建。

易错点

  • 离线环境拉不到外部镜像会导致构建失败,与阶段复用的取舍要提前评估
  • 从多架构镜像复制时注意解析到的平台,与目标镜像架构不一致会带错二进制

数据来源与参考

  • Docker 官方文档:Dockerfile COPY --from(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌