Docker 多阶段构建怎么避免将开发工具链打包进最终生产镜像

秋瑶吖_5085

秋瑶吖_5085

2026-10-16

695人浏览

原创

关键在于分离构建与运行阶段:第一阶段用golang:1.21等含工具链镜像编译,以as builder命名;第二阶段用alpine或distroless镜像,仅通过copy --from=builder精确复制二进制文件,不安装任何开发工具,最终镜像不含go、gcc、npm等。

关键在于分离构建阶段和运行阶段,只在构建阶段安装工具链,再通过 --from 显式复制产物,跳过所有中间依赖和源码。

明确划分构建与运行两个阶段

第一阶段用带完整工具链的镜像(如 golang:1.21、node:20),专注编译或打包;第二阶段换用极简镜像(如 alpine:latest 或 gcr.io/distroless/static),不装任何开发工具。

  • 构建阶段以 AS builder 命名,便于后续引用
  • 运行阶段不执行 RUN apt install 或 npm install 等操作
  • 避免在运行阶段 COPY . . 整个目录,只复制编译产出物

精准复制产物,不带多余文件

使用 COPY --from=builder 指令时,路径必须精确到目标文件或必要目录,不能模糊匹配或递归拷贝整个工作区。

Learn Docker
Learn Docker

通过 LabEx 容器基础课程和镜像/编排实验学习 Docker。Docker 课程和实验通过 LabEx MCP 获取,返回 labex.io 链接以继续。

下载
  • 正确写法:COPY --from=builder /app/myapp .
  • 错误写法:COPY --from=builder /app .(可能带入 go.mod、node_modules 等)
  • 可配合 RUN rm -rf /tmp/* 清理临时文件,但更推荐从源头控制复制范围

禁用运行阶段的包管理与构建命令

最终镜像里不应存在 go、gcc、npm、python3-dev 等工具。验证方式很简单:

  • 构建后运行 docker run --rm <image> which go</image>,应无输出
  • 检查镜像内容:docker run --rm <image> ls /usr/bin | grep -E "go|gcc|npm|yarn"</image>,结果应为空
  • 优先选用 distroless 或 scratch 镜像作为运行基础,它们默认不含 shell 和包管理器

利用 BuildKit 提升构建隔离性

启用 BuildKit 后,构建过程更严格区分阶段上下文,临时层不会意外泄露到最终镜像中。

  • 构建时加环境变量:DOCKER_BUILDKIT=1 docker build .
  • 或全局启用:export DOCKER_BUILDKIT=1
  • BuildKit 默认跳过未被 --from 引用的阶段,进一步保障安全性

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
开发工具有哪些
开发工具有哪些

开发工具有:1、集成开发环境IDE;2、版本控制系统VCS;3、自动化构建工具;4、测试工具;5、代码分析工具。本专题为大家提供开发工具有哪些的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2606

5

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

725

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5399

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6397

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2453

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

259

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

451

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

420

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

305

24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习