镜像构建:分层、缓存与体积
镜像体积和构建时间,八成取决于 Dockerfile 里的顺序,而不是基础镜像选得多小。
同一个应用,不同的 Dockerfile 可以做出 200MB 和 1.2GB 两个镜像,构建时间也能差几倍。差别主要在分层缓存和构建阶段。
缓存命中靠顺序
Docker 逐层缓存,某层变了,后面的层全部重建。所以“变化少的放前面”:
dockerfile
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "main.py"]先拷依赖清单再装依赖,最后拷源码。改一行业务代码不会触发重新安装依赖。
多阶段构建
编译工具链只在构建阶段需要,运行阶段不必带上:
dockerfile
FROM golang:1.22 AS build
WORKDIR /src
COPY . .
RUN CGO_ENABLED=0 go build -o /out/app ./cmd/app
FROM gcr.io/distroless/static
COPY --from=build /out/app /app
ENTRYPOINT ["/app"]产物从几百 MB 降到十几 MB,攻击面也小很多。
基础镜像选择
| 基础 | 体积 | 适用 |
|---|---|---|
| alpine | 最小 | 静态编译、无需 glibc 的依赖 |
| slim / debian-slim | 中等 | 大多数 Python/Node 应用 |
| distroless | 小且无 shell | 生产运行阶段 |
alpine 用 musl libc,某些 Python 包需要重新编译,构建时间会变长;不是所有场景都更快。
.dockerignore
不写这个文件,.git、测试数据、本地缓存都会进构建上下文,构建变慢、镜像变大,还可能把密钥打进去。
text
.git
node_modules
__pycache__
*.log
.env体积检查
bash
docker image ls --format '{{.Repository}}:{{.Tag}} {{.Size}}'
docker history --no-trunc example/app:1.2.3 | head -20docker history 能看到哪一层最大,通常是一次忘了清理的 apt-get install。
构建参数里的密钥会留在镜像里
ARG/ENV 写入的令牌会出现在镜像层中,即使后续删除。敏感值用 BuildKit 的 secret 挂载,不要用参数传。
小结
顺序决定缓存,阶段决定体积,忽略文件决定上下文。三件事做好,镜像自然又小又快。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-07-15。