Docker 如何构建多阶段镜像？

Question

Docker 如何构建多阶段镜像？

仓乃文 · Accepted Answer

多阶段构建（Multi-stage Build）将编译环境和运行环境分离，最终镜像只包含运行时需要的文件，大幅减小镜像体积。

Node.js 多阶段构建示例：
```dockerfile
# 阶段 1：构建阶段
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production  # ci 比 install 更快更稳定
COPY . .
RUN npm run build  # 编译产出 dist/

# 阶段 2：运行阶段（最终镜像）
FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./

EXPOSE 3000
CMD ["node", "dist/main.js"]
```

Go 多阶段构建（最终镜像极简）：
```dockerfile
# 阶段 1：编译
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o /app/server .

# 阶段 2：运行（使用 scratch 空镜像，最终只有几 MB）
FROM scratch
COPY --from=builder /app/server /server
EXPOSE 8080
ENTRYPOINT ["/server"]
```

补充说明：
- 多阶段构建只需一个 Dockerfile，无需多个文件
- 最终镜像不包含编译工具链，体积大幅减小
- COPY --from 可以从之前阶段复制文件
- scratch 是空镜像，适合 Go 等静态编译语言