DevOps约 3 分钟阅读

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"]

#加速构建的三个技巧

  1. 先复制依赖文件,再复制源码:源码变动不会使依赖层缓存失效。
  2. 使用 .dockerignore:排除 node_modules、.git、日志等。
  3. 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 的程序