Docker 镜像从 1.2GB 降到 187MB:多阶段构建的 7 个实操点
一个 Node.js 服务的镜像做到 1.2GB 是很常见的事:基础镜像用了 node:20(不是 slim)、把 node_modules 里的编译工具链一起打进去、顺手把 .git 和测试数据也 COPY 了。本文给出把同一个服务压到 187MB 的一套做法,每一步都能单独验证收益,不依赖私有 registry 或额外构建平台。
所有数字来自一次真实重构的前后对比:docker images 读到的镜像大小,docker history 确认各层占比。
一、先量清楚:谁占了空间
压缩之前先看层,不然容易在无关的地方优化半天。
docker history --no-trunc --human <image> | sort -k2 -h -r | head -20
docker history 给出每一层的大小,--no-trunc 是为了看清创建该层的命令。三个典型发现:
- 基础镜像本身 1.1GB 里的 900MB 是构建工具(gcc、python、make),运行时完全不需要
npm install那一层会带上 devDependencies,通常占总量的 30%–40%- 单独一层 COPY 了
.git,几十到几百 MB,且会随提交历史持续增长
dive <image> 能把每一层的有效文件展开成树状,适合定位“删了文件为什么镜像没变小”这类问题——RUN rm -rf 在下一层删除,上一层的大小依然存在。
二、多阶段构建:把构建环境和运行环境切开
核心思路是只把产物复制到最终镜像里,编译器、源码、缓存全部留在构建阶段。
# ---------- 构建阶段 ----------
FROM node:20-bookworm AS builder
WORKDIR /app
# 先只复制依赖清单,利用层缓存
COPY package.json package-lock.json ./
RUN npm ci --include=dev
COPY . .
RUN npm run build && npm prune --omit=dev
# ---------- 运行阶段 ----------
FROM node:20-bookworm-slim AS runner
ENV NODE_ENV=production
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/package.json ./package.json
USER node
EXPOSE 3000
CMD ["node", "dist/server.js"]
这一步通常能从 1.2GB 降到 300MB 上下,因为 builder 阶段的 900MB 完全不计入最终镜像。
三、选对基础镜像变体
同一个 Node 版本,官方提供四类变体,体积差异很大:
| 变体 | 体积(约) | 适用 |
|---|---|---|
node:20 |
1.1 GB | 需要编译原生模块,且不想自己装工具链 |
node:20-slim |
200 MB | 大多数 Web 服务,推荐默认 |
node:20-alpine |
130 MB | 追求极小体积,注意 musl 与 glibc 差异 |
node:20-distroless |
110 MB | 安全性优先,没有 shell,调试不便 |
alpine 的坑在于:原生模块(bcrypt、sharp、sqlite3)在官方镜像里通常没有 musl 预编译包,会退化成现场编译,反而需要装 python3、make、g++。真要压体积,用 alpine 之前先确认依赖有没有 musl 产物。
四、.dockerignore 比 RUN rm 有用
.dockerignore 是从构建上下文层面排除,文件根本不会进入镜像层:
.git
.github
node_modules
coverage
tests
*.log
.env*
dist
注意 dist 在构建阶段是要生成的,所以它应该由 builder 产出、通过 COPY --from 传入,而不是从上下文带进来。判断标准很简单:能在容器内生成的,就不要 COPY。
五、依赖安装:npm ci + 分阶段裁剪
npm ci --include=dev # 构建阶段,需要 typescript、eslint 等
npm prune --omit=dev # 构建完成后裁掉 devDependencies
npm ci 严格按 lockfile 安装,比 npm install 快且结果可复现。npm prune --omit=dev 依赖 npm 7+ 的 lockfile 语义,如果项目里有人手工改过 package-lock.json,prune 可能留下悬空依赖,构建后建议跑一次 npm ls --omit=dev 确认。
六、合并 RUN,减少层数与残留
每一层都保留自己的中间文件,所以安装完就清理。
RUN apt-get update \
&& apt-get install -y --no-install-recommends ca-certificates curl \
&& rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
要点是 --no-install-recommends(避免拖入一堆建议包)和在同一条 RUN 里删除缓存。写在两条 RUN 里,删除只能作用在下一层。
七、验证收益,别只看体积
压缩完成后,至少确认三件事:
docker build -t app:slim .
docker images app:slim # 体积
docker run --rm app:slim node -e "require('express')" # 依赖完整性
docker scout quickview app:slim # 基础镜像漏洞数量
更换基础镜像(尤其 debian → alpine)属于运行时变更,必须跑一遍集成测试。体积小 60% 但启动报 Error: cannot open shared object file 是最常见的翻车方式。
一张对照表
| 阶段 | 做法 | 镜像体积 |
|---|---|---|
| 原始 | node:20 单阶段 + COPY 。 |
1.2 GB |
| + 多阶段构建 | builder / runner 分离 | 310 MB |
| + slim 基础镜像 | node:20-slim |
214 MB |
| + .dockerignore 与 prune | 排除源码、裁 dev 依赖 | 187 MB |
再往下压就要动运行时了:用 distroless 或 scratch + 静态链接的二进制,能到 100MB 以内,代价是没有 shell,出问题只能靠日志和外部调试容器。
小结
优先级从高到低:多阶段构建 > 基础镜像变体 > .dockerignore > 依赖裁剪 > 层合并。前两项几乎总是最大收益,且改动集中在 Dockerfile 里,风险可控;后三项是细活儿,适合在 CI 里固化下来。
- 点赞
- 收藏
- 关注作者
评论(0)