Docker 多阶段构建：减小镜像体积的最佳实践

什么是多阶段构建？

多阶段构建允许在单个 Dockerfile 中使用多个 FROM 指令，每个 FROM 开始一个新的构建阶段。你可以从之前的阶段复制需要的文件，最终只保留必要的产物。

传统构建 vs 多阶段构建

传统方式（镜像体积大）

FROM node:18
WORKDIR /app
COPY . .
RUN npm install
RUN npm run build
EXPOSE 3000
CMD ["node", "dist/index.js"]

问题：镜像包含完整的 Node.js 环境和所有依赖，体积可能超过 1GB。

多阶段构建（镜像体积小）

# 构建阶段
FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

# 运行阶段
FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
EXPOSE 3000
CMD ["node", "dist/index.js"]

优势：最终镜像只有 200MB 左右，减小 80%+！

Go 语言示例

FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o main .

FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/main .
CMD ["./main"]

最佳实践

1. 使用 alpine 基础镜像：体积更小，更安全
2. 只复制必要文件：不要复制整个构建环境
3. 合理命名阶段：使用 AS 给阶段命名，便于引用
4. 利用构建缓存：先复制依赖文件，再复制源码

实际效果

项目	传统构建	多阶段构建	减少
Node.js API	1.2GB	180MB	85%
Go 服务	800MB	15MB	98%
Python ML	2.5GB	400MB	84%

多阶段构建是生产环境 Docker 镜像的标配技能！