Docker 多阶段构建实战:把镜像体积压到最小
镜像体积过大是容器化落地中最常见的抱怨之一:一个 Go 服务打出来 800MB,一个前端应用 1.2GB,CI 流水线推拉镜像慢、集群节点磁盘被吃光、冷启动时间翻倍。多阶段构建(Multi-stage Build)是 Docker 17.05 引入的特性,能把构建环境和运行环境彻底分离,让最终镜像只包含真正需要的文件。本文结合真实项目,梳理多阶段构建的核心写法与几个实战技巧。
一、为什么镜像会膨胀
先看一个典型的反模式 Dockerfile:
FROM golang:1.22
WORKDIR /app
COPY . .
RUN go build -o server ./cmd/server
CMD ["./server"]
这个镜像里塞进了完整的 Go 工具链、源码、模块缓存和编译中间产物,最终产物可能只有 20MB,但镜像轻松超过 800MB。更糟的是,构建工具链里还带着潜在的安全漏洞,扩大了攻击面。
根本问题是:构建时需要的东西(编译器、依赖源码、测试工具)和运行时需要的东西(可执行文件、运行时库、配置文件)被装进了同一层文件系统。
二、多阶段构建的最小写法
# 第一阶段:构建
FROM golang:1.22 AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -ldflags="-s -w" -o server ./cmd/server
# 第二阶段:运行
FROM alpine:3.20
WORKDIR /app
COPY --from=builder /app/server ./server
EXPOSE 8080
CMD ["./server"]
关键点:
AS builder给第一阶段命名,第二阶段用COPY --from=builder只取编译产物。- 最终镜像基于 alpine,只有几十 MB,里面没有 Go 工具链、没有源码。
- 每一阶段都是独立的构建上下文,前一阶段的层不会进入最终镜像(除非显式 COPY)。
实测:同一个 Go 项目,单阶段 860MB,多阶段后 28MB,体积压缩到原来的 1/30。
三、前端项目的经典配方
Node 项目同样受益,构建产物是静态文件,运行时只需要一个 Web 服务器:
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production=false
COPY . .
RUN npm run build
FROM nginx:1.27-alpine
COPY --from=builder /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
注意两个细节:npm ci 比 npm install 更快且可复现;把 package*.json 单独 COPY 一层,可以利用 Docker 层缓存——依赖没变时,npm install 层直接命中缓存,大幅提速。
四、层缓存:让构建快起来的关键
多阶段构建配合层缓存,效果翻倍。几条实战经验:
- 依赖文件先行:先 COPY 锁文件(go.mod、package-lock.json、requirements.txt)并安装依赖,再 COPY 源码。这样源码变更不会让依赖安装层失效。
- 构建参数用 ARG:版本号、构建时间等易变参数放在靠后的层,避免前面的缓存被冲掉。
- 合并 RUN 指令:
apt-get update && apt-get install写在一条 RUN 里,防止 update 层被缓存而 install 装了旧包。
FROM python:3.12-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
--no-cache-dir 避免 pip 缓存占用镜像空间,这个小开关经常被忽略。
五、三个真实踩坑
坑 1:COPY --from 拷错了路径。 构建阶段的 WORKDIR 和输出路径要对齐,建议在构建阶段末尾 ls 一下产物路径,或者用绝对路径。路径写错时构建不会报错,运行时才发现文件缺失。
坑 2:动态链接库没带过去。 用 CGO_ENABLED=1 编译的 Go 程序或 Python 的某些 C 扩展,运行时依赖 glibc 等库。alpine 用的是 musl,直接跑会报 “not found”。两种解法:静态编译(CGO_ENABLED=0),或运行阶段换成 debian:bookworm-slim 并安装对应库。
坑 3:调试时想进构建阶段。 多阶段构建后,中间阶段的容器默认不可用。调试时可以用 docker build --target builder -t myapp:debug . 只构建到指定阶段,再 docker run -it myapp:debug sh 进去看,排查完再全量构建。
六、体积优化清单
- [ ] 构建阶段与运行阶段分离,最终镜像不含工具链和源码
- [ ] 基础镜像选
-slim/-alpine变体,按需取舍 - [ ] 依赖文件先 COPY,利用层缓存
- [ ] 清理包管理器缓存(pip
--no-cache-dir、npm 缓存、apt lists) - [ ] 合并 RUN 指令,减少层数
- [ ] 用
dive工具分析镜像每一层,找出体积大户
多阶段构建的本质是“关注点分离”:构建环境可以臃肿,运行环境必须精益。掌握这个思路后,CI 流水线更快、镜像仓库更省、线上拉取更稳,是一笔稳赚不赔的投入。
- 点赞
- 收藏
- 关注作者
评论(0)