Docker 多阶段构建实战:把 Node.js 镜像从 900MB 瘦身到 120MB
上周把一个跑了两年的 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,先问自己一句:运行这个服务,到底需要哪些东西?
- 点赞
- 收藏
- 关注作者
评论(0)