Docker 多阶段构建:把镜像从 1GB 瘦身到 20MB
#问题:单阶段构建的镜像太大
dockerfile
FROM golang:1.23
WORKDIR /app
COPY . .
RUN go build -o server .
CMD ["./server"]这个镜像包含了整个 Go 工具链,体积超过 800MB,而运行时只需要一个二进制文件。
#多阶段构建
dockerfile
# ---------- 构建阶段 ----------
FROM golang:1.23-alpine AS builder
WORKDIR /src
# 先复制依赖描述文件,利用层缓存
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o /out/server .
# ---------- 运行阶段 ----------
FROM gcr.io/distroless/static-debian12
COPY --from=builder /out/server /server
USER nonroot
ENTRYPOINT ["/server"]最终镜像约 15~20MB,并且以非 root 用户运行、不含 shell,攻击面极小。
#Node.js 项目的写法
dockerfile
FROM node:22-alpine AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
FROM deps AS build
COPY . .
RUN npm run build && npm prune --omit=dev
FROM node:22-alpine
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/node_modules ./node_modules
COPY --from=build /app/dist ./dist
USER node
CMD ["node", "dist/server.js"]#加速构建的三个技巧
- 先复制依赖文件,再复制源码:源码变动不会使依赖层缓存失效。
- 使用
.dockerignore:排除node_modules、.git、日志等。 - BuildKit 缓存挂载:
dockerfile
RUN --mount=type=cache,target=/root/.cache/go-build \
--mount=type=cache,target=/go/pkg/mod \
go build -o /out/server .#基础镜像怎么选
| 镜像 | 体积 | 适用 |
|---|---|---|
scratch |
0 | 纯静态二进制 |
distroless/static |
~2MB | 静态二进制,带 CA 证书和时区 |
alpine |
~7MB | 需要 shell 调试,注意 musl 兼容性 |
debian-slim |
~75MB | 依赖 glibc 的程序 |