首页/容器/正文

镜像构建:分层、缓存与体积

镜像体积和构建时间,八成取决于 Dockerfile 里的顺序,而不是基础镜像选得多小。

容器容器与部署2026-07-15约 2 分钟397 字

同一个应用,不同的 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 -20

docker history 能看到哪一层最大,通常是一次忘了清理的 apt-get install。

构建参数里的密钥会留在镜像里

ARG/ENV 写入的令牌会出现在镜像层中,即使后续删除。敏感值用 BuildKit 的 secret 挂载,不要用参数传。

小结

顺序决定缓存,阶段决定体积,忽略文件决定上下文。三件事做好,镜像自然又小又快。

说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2026-07-15。