Docker 多阶段构建实战:把 Node.js 镜像从 900MB 瘦身到 120MB

举报
yd_240716394 发表于 2026/11/08 15:08:31 2026/11/08
【摘要】 用 Docker 多阶段构建加 Alpine 基础镜像加 .dockerignore,把 Node.js 接口服务的镜像从 912MB 瘦身到 118MB,附完整 Dockerfile 与验证步骤。

上周把一个跑了两年的 Node.js 服务迁到新集群时,CI 构建产物让我吓了一跳:一个简单的 Express 接口服务,镜像居然有 912MB。每次部署都要拉取近 1GB,节点扩容慢,回滚也慢。这篇文章记录我用 Docker 多阶段构建把它瘦身到 118MB 的完整过程,步骤都可以直接复现。

一、单阶段构建的问题

最开始的 Dockerfile 是典型的单阶段写法:

FROM node:20
WORKDIR /app
COPY . .
RUN npm install
EXPOSE 3000
CMD ["node", "server.js"]

这份写法有三个问题:第一,基础镜像 node:20 自带完整的 Debian 系统和构建工具链,光是它就有约 900MB;第二,COPY . . 把源码、测试文件、本地的 node_modules 全部打进镜像;第三,npm install 留下的缓存和开发依赖也一起进了最终镜像。运行一个接口服务,其实只需要 Node.js 运行时和生产依赖,其他东西都是负担。

二、多阶段构建怎么做

多阶段构建的核心思路是:用一个构建阶段装依赖、编译代码,再用一个干净的运行阶段只复制构建产物,构建阶段的臃肿内容不会进入最终镜像。改造后的 Dockerfile 如下:

# 阶段一:构建阶段
FROM node:20-alpine AS builder
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --omit=dev
COPY . .
RUN npm run build

# 阶段二:运行阶段
FROM node:20-alpine
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY package.json ./
USER node
EXPOSE 3000
CMD ["node", "dist/server.js"]

关键点有四处:第一,两个阶段都用 node:20-alpine 替代 node:20,Alpine 基础镜像只有约 40MB;第二,构建阶段先只复制 package.json 再执行 npm ci,利用 Docker 层缓存,依赖不变时不用重复安装;第三,运行阶段只从构建阶段复制 node_modules 和 dist 产物,源码、测试文件和构建工具都被挡在门外;第四,末尾用 USER node 以非 root 用户运行,减少容器逃逸后的风险面。

三、别忘了 .dockerignore

就算 Dockerfile 写得再好,COPY . . 一样会把无关文件带进构建上下文。项目根目录加一个 .dockerignore:

node_modules
.git
*.log
test
coverage
.env

四、构建与验证

执行构建并对比体积:

docker build -t my-api:slim .
docker images my-api
docker run -d --name api -p 3000:3000 my-api:slim
curl http://localhost:3000/health

构建完成后,docker images 显示镜像从 912MB 降到了 118MB;curl 返回健康检查正常,说明瘦身没有破坏功能。想进一步确认体积构成,可以用 docker history my-api:slim 查看每一层的大小,体积最大的层通常就是漏网的基础镜像或依赖。

五、三个常见坑

第一,Alpine 用的是 musl 而不是 glibc,个别包含原生编译模块的依赖会报错,遇到时可以在构建阶段用 apk add python3 make g++ 补齐工具链,或改回 node:20-slim。第二,npm ci 需要提交 package-lock.json,否则构建会失败。第三,COPY --from=builder 的路径写错是最常见的构建失败原因,先在本地用 docker run --rm -it 镜像 sh 进去确认文件位置。

总结一下:多阶段构建加 Alpine 基础镜像加 .dockerignore,三板斧下来,镜像体积可以轻松压缩到原来的十分之一左右。下次写 Dockerfile,先问自己一句:运行这个服务,到底需要哪些东西?

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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