容器与云原生 / 系统课时
使用多阶段构建
使用多阶段构建
本课解决生产镜像体积过大、包含无用构建工具的问题,通过 Docker 多阶段构建拆分编译环境和运行环境,只复制最终产物,生成更轻量、更安全的镜像。
学习目标
- 理解多阶段构建中不同阶段的职责划分
- 掌握从构建阶段复制运行产物的方法
- 能够验证最终镜像是否只包含生产依赖
多阶段构建的核心思想
传统 Dockerfile 往往把依赖下载、源码编译和应用运行写在同一个镜像中,导致最终镜像包含编译器、缓存文件和开发依赖。
多阶段构建允许一个 Dockerfile 定义多个 FROM 阶段。前面的阶段负责构建,后面的阶段只复制需要运行的文件,因此最终镜像不需要携带完整开发环境。

编写多阶段 Dockerfile
下面以 Go 应用为例,第一阶段负责编译二进制文件,第二阶段只保留运行程序。
dockerfile
# 构建阶段
FROM golang:1.24-alpine AS builder
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o app ./cmd/server
# 运行阶段
FROM alpine:3.22
WORKDIR /app
COPY --from=builder /src/app ./app
EXPOSE <PORT>
CMD ["./app"]预期结果
text
构建阶段生成 /src/app
运行阶段镜像中只包含 /app/app 和运行所需基础环境COPY --from=builder 是多阶段构建的关键,它让不同阶段之间只传递明确需要的文件。
选择阶段边界
阶段划分应该围绕产物边界设计,而不是简单拆分命令。常见划分方式包括:
- 依赖准备阶段:下载并缓存第三方依赖
- 构建阶段:编译源码或生成静态资源
- 测试阶段:执行自动化测试和质量检查
- 运行阶段:提供最小生产环境
如果测试步骤不影响最终镜像,可以单独作为中间阶段存在,避免测试工具进入生产环境。
验证镜像优化效果
构建完成后,可以通过镜像查看命令比较优化前后的大小。
bash
docker build -t optimized-app:<ID> .
docker image inspect optimized-app:<ID> --format '{{.Size}}'预期输出
text
镜像大小以字节数形式输出,例如:52346880实际大小会受到基础镜像、依赖数量和应用类型影响,但多阶段构建通常可以明显减少无关文件。
常见失败处理
多阶段构建失败通常来自复制路径错误或遗漏运行依赖。排查时优先检查:
COPY --from指向的文件是否真实存在- 运行阶段是否缺少动态库或配置文件
- 构建阶段生成的文件权限是否满足运行要求
对于需要动态链接库的程序,不能只复制单个二进制文件,需要同步复制必要运行依赖。
按自己的节奏,确认真正理解。