Docker镜像动辄几个G?你可能从第一步就写错了

前几天帮一个朋友排查 CI 流水线的问题,打开他的 Jenkins 日志一看,好家伙,一个 Node.js 项目的镜像构建了整整 12 分钟,推送到镜像仓库还要再等 5 分钟。登录服务器一看,镜像体积 1.8G。我问他:”你这 Dockerfile 是照着网上随便抄的吧?”他嘿嘿一笑:”能跑就行。”

能跑确实就行,但代价是每次发版都像过年,构建慢、推送慢、拉取慢、部署慢,磁盘还动不动就被镜像塞满。其实 Dockerfile 写得好不好,直接决定了镜像体积和构建速度,这里面有非常明确的工程规律可循。今天站长就把这些年踩过的坑和总结出的实战经验,一次性讲清楚。

先搞懂:为什么你的镜像会”膨胀”?

💡 推荐阅读:别再用22端口了!手把手教你给Linux服务器SSH换把“隐形锁”

在进入 FAQ 之前,先建立一个核心认知:Docker 镜像是分层的,每一条 RUN、COPY、ADD 指令都会产生一个新层,层与层之间不会自动清理。这意味着你在某一层下载了 500M 的编译依赖,即使下一层用 rm -rf 删掉了,那 500M 依然躺在镜像历史里,镜像体积一点没减。

理解这一点,后面的所有优化手段你都能自己推导出来:要么减少层数,要么让临时文件根本不进入最终层,要么用更小的基础镜像。

高频疑问一:多阶段构建到底怎么用?为什么我用了还是很大?

🔥 【限时特惠福利】高性价比独享云服务器限时 1 折起

搭建网站或部署容器推荐选择高稳定性独享云服务器。限时特惠通道开放中,点击即可领取专属满减代金券与特惠折扣:

👉 立刻领取云服务器限时优惠券

💡 延伸阅读:云服务器安全组和系统防火墙“打架”了?手把手教你揪出那个拦截流量的真凶

Q:听说多阶段构建能大幅瘦身,我照着改了,结果镜像还是有 800M,问题出在哪?

这是笔者被问得最多的问题之一。多阶段构建(Multi-stage Build)的原理是:用一个大镜像(比如 golang、node)做编译,然后把编译产物复制到一个极小的运行镜像里。关键在于”复制什么”。

很多人犯的错误是直接把整个源码目录 COPY 过去,或者把 node_modules 整个复制过去,那多阶段构建就白做了。正确的姿势是只复制必要的产物。

# ---------- 构建阶段 ----------
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

# ---------- 运行阶段 ----------
FROM node:20-alpine
WORKDIR /app
# 只复制产物和运行时依赖,不复制源码和 devDependencies
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./
EXPOSE 3000
CMD ["node", "dist/main.js"]

核心原则:构建阶段负责”造”,运行阶段只负责”用”。编译工具链、源码、测试文件、缓存,统统不要带进运行镜像。

高频疑问二:COPY 和 ADD 到底有什么区别?为什么我的 .git 目录也被打进去了?

💡 深度技术指南:服务器半夜又炸了?聊聊 Swap 交换分区到底怎么配才不踩 OOM 这个坑

Q:镜像里莫名其妙多了 .git、node_modules、.env 文件,删都删不掉,怎么办?

九成是因为你用了 COPY . . 却没有写 .dockerignore 文件。Docker 在构建时会把整个上下文目录(build context)打包发给 Docker Daemon,如果你的目录里有 .git、测试数据、日志文件,它们会一股脑全进去,不仅体积爆炸,还可能泄露敏感信息(比如 .env 里的数据库密码)。

在项目根目录建一个 .dockerignore,内容参考如下:

.git
.gitignore
node_modules
dist
*.log
.env
.env.*
Dockerfile
docker-compose.yml
README.md
.vscode
.idea
coverage

另外补充一点:ADD 指令会自动解压 tar 包、支持远程 URL,但正因为”自作聪明”,反而容易出坑。除非你明确需要解压功能,否则一律用 COPY,行为可预测,也更符合最佳实践。

高频疑问三:RUN 指令怎么写才能既快又小?

Q:apt-get install 装了一堆东西,镜像直接胖了 600M,能救吗?

能救,而且有标准套路。核心口诀:合并 RUN、及时清理、加 –no-install-recommends。

错误示范(每层都留垃圾):

RUN apt-get update
RUN apt-get install -y curl git
RUN rm -rf /var/lib/apt/lists/*

正确示范(一条 RUN 搞定,垃圾在同层清掉):

RUN apt-get update && \
    apt-get install -y --no-install-recommends curl git && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

为什么必须在同一条 RUN 里清理?因为前面说过,层一旦生成就无法删除。你在下一层删,只是打了个”删除标记”,底层数据依然占体积。用 && 串联,保证下载、安装、清理都发生在同一层。

同理,Alpine 系统用 apk add --no-cache,Python 用 pip install --no-cache-dir,都是同样的思路——别让缓存落地。

高频疑问四:构建缓存总是失效,每次都从头编译怎么办?

Q:明明只改了一行业务代码,为什么每次构建都要重新 npm install?

这是构建速度的头号杀手,根因是Docker 的层缓存是按指令顺序逐层匹配的,一旦某一层的内容变了,它后面的所有层缓存全部失效。

如果你这么写:

COPY . .
RUN npm install

那你改任何一个源码文件,COPY 层就变了,npm install 必然重跑。正确做法是先复制依赖清单,再安装依赖,最后复制源码:

COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build

这样只要 package.json 没变,npm ci 那一层就能命中缓存,秒过。业务代码的改动只会影响最后两层,构建速度能提升好几倍。

一张表看懂优化前后差距

优化项 优化前 优化后
基础镜像 node:20(约 1G) node:20-alpine(约 130M)
构建方式 单阶段,源码全进 多阶段,只带产物
依赖安装 COPY . . 后 install 先 COPY 清单再 install
临时文件 跨层删除,残留 同层清理,不落地
上下文 无 .dockerignore 精准排除无用文件

按这套组合拳打下来,一个典型 Node 项目从 1.8G 降到 150M 以内、构建时间从 12 分钟压到 2 分钟,是非常常见的。

预防建议:把好习惯固化成规范

  • 基础镜像选 slim 或 alpine 版本,除非确实需要完整工具链。注意 alpine 用的是 musl libc,个别依赖 glibc 的二进制包可能不兼容,遇到诡异报错先往这个方向排查。
  • 固定基础镜像版本号,比如 node:20.11-alpine3.19,别用 latest,否则哪天上游更新了你的构建就”薛定谔”了。
  • RUN 指令能合并就合并,减少层数的同时保证清理动作和安装动作同层。
  • 每个项目必备 .dockerignore,这是成本最低、收益最高的一个动作。
  • 用 docker history <镜像名> 定期体检,一眼就能看出哪一层体积异常,对症下药。
  • CI 里开启 BuildKit(DOCKER_BUILDKIT=1),并行构建和缓存挂载能再快一截。

最后说句实在的,镜像优化这件事,收益是复利的。构建快一点、推送快一点、部署快一点,日积月累省下的时间和磁盘成本相当可观。如果你还在用那种配置寒酸、磁盘动不动就满的小水管服务器跑 CI,建议趁早换一台 IO 性能靠谱、带宽充足的云服务器,构建和推送体验完全是两个世界——毕竟 Dockerfile 优化得再好,也架不住底层磁盘拖后腿。选服务器的时候认准正规厂商,别贪便宜买那种超售严重的机器,不然镜像层一多,光解压就能让你等到怀疑人生。

把这篇文章里的几个点挨个落地,你的 Dockerfile 就能从”能跑”进化到”跑得漂亮”了。

相关技术专题与延伸阅读

滚动至顶部