Docker 镜像从 1.2GB 降到 187MB:多阶段构建的 7 个实操点

举报
yd_229180646 发表于 2026/11/12 10:43:08 2026/11/12
【摘要】 从 1.2GB 压到 187MB:用 docker history 定位体积来源,多阶段构建拆分构建与运行环境,选择 slim/alpine/distroless 基础镜像,配合 .dockerignore、npm ci 与 prune 裁剪依赖,合并 RUN 减少层残留,最后用集成测试与 scout 验证收益。附四个阶段的体积对照表。

一个 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 里固化下来。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。