容器与云原生 / 系统课时
使用多阶段构建优化镜像
使用多阶段构建优化镜像
多阶段构建让编译工具、源码和中间产物停留在构建阶段,只把运行真正需要的文件复制到最终阶段。这样既能保留完整的编译流程,又能避免把编译器、依赖缓存和源代码一起交付到生产镜像。
学习目标
- 理解多个
FROM阶段之间的职责边界 - 使用
COPY --from只传递最终运行产物 - 验证最终镜像中不再包含编译工具链
构建阶段与运行阶段如何分工
Dockerfile 可以包含多个 FROM。每个 FROM 开启一个新的构建阶段,前面的阶段可以安装编译器、下载依赖并生成产物,后面的阶段再选择性复制这些产物。
最终生成的镜像默认来自最后一个阶段,因此前面阶段中的 Go 编译器、源码和临时文件不会因为曾经参与构建就自动进入最终镜像。

构建一个最小 Go 示例
先创建 go.mod:
module example.com/multistage
go 1.22再创建 main.go:
package main
import "fmt"
func main() {
fmt.Println("hello from multi-stage")
}Dockerfile 使用命名阶段 build 编译静态二进制,然后只把结果复制到运行阶段:
FROM golang:1.24-alpine AS build
WORKDIR /src
COPY go.mod ./
COPY main.go ./
# 关闭 CGO,使生成的程序不依赖构建阶段的 C 运行库
RUN CGO_ENABLED=0 GOOS=linux go build -o /out/app .
FROM alpine:3.21
WORKDIR /app
COPY --from=build /out/app ./app
CMD ["./app"]COPY --from=build 中的 build 来自第一阶段的名称。Docker 只复制 /out/app,不会把 /usr/local/go、/src/main.go 或第一阶段安装的其他文件一起带入最终阶段。
构建并运行最终镜像
在三个文件所在目录执行构建:
docker build -t multistage-demo .
docker run --rm multistage-demo预期输出:
hello from multi-stage构建日志会同时出现两个阶段,但最终标签 multistage-demo 指向最后的运行阶段。具体步骤编号、下载进度和耗时属于动态输出。
验证编译器没有进入生产镜像
可以直接在最终容器中检查 go 命令。由于最终阶段基于 Alpine 且只复制了应用二进制,正常情况下找不到 Go 工具链。
docker run --rm multistage-demo sh -c 'command -v go || echo "go-not-found"'预期输出:
go-not-found这个验证比只观察镜像大小更直接:生产镜像确实没有继承构建阶段的编译器。源码和构建缓存同样不会自动存在于最后阶段,从而减少不必要的软件包和潜在攻击面。
控制阶段之间的传递边界
多阶段构建的关键不是简单写多个 FROM,而是严格控制跨阶段复制内容。不要为了省事把整个工作目录执行 COPY --from=build /src /app,否则源码、测试文件和临时产物仍可能进入最终镜像。
如果应用运行时需要 CA 证书、时区数据、动态链接库或其他系统文件,也必须在最终阶段明确安装或复制。构建阶段能够成功运行,并不意味着最后阶段天然具备相同环境。
把编译环境和运行环境分开后,Dockerfile 同时承担了两项职责:前半部分保证产物可重复构建,后半部分定义生产环境真正需要交付的最小文件集合。