Docker 多阶段构建实战:把 Node 镜像从 1.2GB 压到 90MB

举报
yd_226289576 发表于 2026/11/13 21:11:18 2026/11/13
【摘要】 把构建环境和运行环境拆开,用多阶段构建 + 只装生产依赖 + .dockerignore,把 Node 镜像从 1.2GB 压到 90MB,顺带讲四个常见坑。

很多团队第一次把 Node 服务打成 Docker 镜像,docker images 一看 1.2GB。部署到 2C4G 的小规格机器上,光是拉镜像就要几分钟,磁盘也扛不住。问题通常不在代码,而在于把「构建环境」和「运行环境」塞进了同一个镜像:node_modules、源码、编译工具链、npm 缓存全在里面。

## 一、先看清楚镜像里到底装了什么

不要靠猜,直接看每一层的大小:

docker history --no-trunc --format '{{.Size}}\t{{.CreatedBy}}' my-app:latest | head -20

十有八九会发现:node_modules 占了 600MB 以上,构建产物和源码各占一份,apt 装过编译器后又没清理缓存。

## 二、用多阶段构建把构建环境扔掉

核心思路是:第一阶段负责把依赖装好、把代码编译成产物;第二阶段只把产物拷进来。第二阶段的基础镜像里没有 npm、没有源码、没有编译工具。

FROM node:20-alpine AS builder WORKDIR /app COPY package*.json ./ RUN npm ci COPY . . RUN npm run build FROM node:20-alpine AS runner WORKDIR /app ENV NODE_ENV=production COPY --from=builder /app/dist ./dist COPY --from=builder /app/node_modules ./node_modules COPY package.json ./ USER node EXPOSE 3000 CMD ["node","dist/main.js"]

## 三、只装生产依赖

builder 阶段为了跑构建,装的是全部依赖(含 devDependencies)。如果运行阶段直接把 node_modules 拷过去,体积还是会偏大。更彻底的做法是运行阶段单独装一次生产依赖:

RUN npm ci --omit=dev

代价是多跑一次安装,但换来的镜像通常小一半以上。配合 .dockerignore 排除 node_modules、.git、测试用例,构建上下文也能从几百 MB 降到几 MB。

## 四、几个容易踩的坑

1)alpine 镜像用的是 musl libc,如果依赖里有原生模块(bcrypt、sharp 之类),要在 alpine 里重新编译,否则运行时报 cannot open shared object file。稳妥起见可以改用 node:20-slim。

2)COPY --from=builder 只能拷文件,不能拷环境变量和 ENV,运行阶段的环境变量要重新声明。

3)用 USER node 切到非 root 用户后,如果容器内要写日志或缓存目录,记得提前 chown,否则启动就报 EACCES。

4)不要把 .env 打进镜像。用 docker run --env-file 或编排工具注入,镜像里进不去的秘密才叫秘密。

## 五、结果

同一个项目,改造前 1.2GB,改造后 92MB,冷启动拉镜像从 90 秒降到 6 秒。分层缓存也变好用了:只改业务代码时,依赖层命中缓存,构建从 3 分钟降到 20 秒。

多阶段构建不是什么高级技巧,但它几乎是最省事的一次镜像治理。建议先把 docker history 跑一遍,看清楚体积花在哪,再决定砍哪一块——盲目换基础镜像往往效果有限。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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