Docker 镜像越 build 越大?用多阶段构建给镜像瘦身

举报
yd_232552650 发表于 2026/11/13 14:53:51 2026/11/13
【摘要】 镜像 1.2GB、代码不到 20MB:编译工具链和源码全留在层里了。用多阶段构建把编译和运行分开,只拷产物进最终镜像,再配 .dockerignore 和层缓存,镜像能从 1GB 压到几十 MB。

上周给一个 Go 服务打镜像,docker images 一看:1.2GB。代码本身不到 20MB,剩下的全是编译器、源码和中间文件。更糟的是每次改一行代码重新 build,镜像又大一圈。问题不在应用,在 Dockerfile 的写法。

1. 镜像为什么越 build 越大

镜像是一层一层叠上去的,每条 RUN、COPY、ADD 都会产生新的一层。关键点:后面一层删掉文件,前面那层的体积不会缩小——文件还在历史层里占着空间。编译用的 gcc、npm 包、源码只要进过某一层,就永远留在镜像里。

docker history myapp:latest
# 每一层多大,一目了然

2. 多阶段构建:编译和运行分开

思路很简单:第一个阶段负责编译,第二个阶段只从上一个阶段把编译产物拷过来,最终镜像里没有编译工具链。

# 阶段一:编译
FROM golang:1.22 AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o server .

# 阶段二:运行,只留产物
FROM alpine:3.19
WORKDIR /app
COPY --from=builder /app/server .
EXPOSE 8080
CMD ["./server"]

同一个 Dockerfile,产物从 1.2GB 压到 20MB 出头。Node 项目同理:builder 里 npm ci、npm run build,最终阶段只拷 dist 和生产依赖。

3. .dockerignore:别把杂物打进去

构建上下文会整个发给 Docker daemon,.git、node_modules、本地日志一不小心就全进去了。项目根目录放一个 .dockerignore:

.git
node_modules
*.log
.env

4. 层缓存:依赖不变就别重装

Docker 按顺序缓存每一层,某一层变了,后面全重建。所以先 COPY 依赖清单、装依赖,再 COPY 源码:

COPY package.json package-lock.json ./
RUN npm ci --only=production
COPY . .

这样改业务代码不会触发 npm ci,build 快得多。反过来写(先 COPY . 再 npm ci)每次改代码都重装依赖,又慢又大。

5. 验证瘦身效果

docker images myapp
docker history myapp:latest --no-trunc | head -20

改完对照一下 images 大小,再用 history 看哪一层还占地方,继续砍。

一句话总结

镜像瘦身就三招:多阶段构建把编译和运行分开,.dockerignore 挡住杂物,COPY 顺序保住层缓存。镜像小了,拉取、部署、回滚都跟着变快。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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