Docker 多阶段构建完全指南

问题背景

很多开发者的 Docker 镜像动辄几个 GB，部署慢、存储贵、安全风险高。

什么是多阶段构建？

多阶段构建允许在一个 Dockerfile 中使用多个 FROM 语句，每个 FROM 开始一个新的构建阶段。

实战案例：Go 应用

传统方式（镜像~800MB）

FROM golang:1.21
WORKDIR /app
COPY . .
RUN go build -o main .
CMD ["./main"]

多阶段构建（镜像~20MB）

# 构建阶段
FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN CGO_ENABLED=0 go build -o main .

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

更多语言示例

Node.js

FROM node:20 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
CMD ["node", "dist/index.js"]

Python

FROM python:3.12 AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --user --no-cache-dir -r requirements.txt

FROM python:3.12-slim
WORKDIR /app
COPY --from=builder /root/.local /root/.local
COPY . .
ENV PATH=/root/.local/bin:$PATH
CMD ["python", "app.py"]

最佳实践

1. 命名构建阶段：方便引用
2. 只复制必要文件：减少上下文
3. 使用.alpine 基础镜像：体积更小
4. 清理缓存：在同一个 RUN 指令中

效果对比

项目	传统构建	多阶段构建	减少
Go 应用	800MB	20MB	97%
Node 应用	1.2GB	150MB	87%
Python 应用	900MB	120MB	86%

结语

多阶段构建是 Docker 最佳实践之一，强烈推荐每个项目都采用！