Docker 镜像瘦身实录:多阶段构建把 1.2 GB 的 Python 服务压到 190 MB
为什么要瘦身
镜像大小会直接影响三件事:冷启动扩容时的拉取时间、镜像仓库的存储成本,以及漏洞扫描出来的攻击面。以 Python 服务为例,python:3.11 全量基础镜像本身就有 1 GB 上下,再叠上 pip 依赖、编译工具链和构建缓存残留,很容易膨胀到 1.2 GB 以上。而运行时真正需要的,往往只有那几十兆的虚拟环境和业务代码。
下面这套改法只动 Dockerfile,不改一行业务代码。
第一步:基础镜像先降一档
python:3.11(基于 Debian 全量):约 1.0 GBpython:3.11-slim:约 130 MBpython:3.11-alpine:约 50 MB,但用的是 musl libc,依赖 numpy、psycopg2 这类 C 扩展时要重新编译,容易踩坑
实践上建议 slim 起步,纯 Python、依赖少的小工具再考虑 alpine。这一步通常就能砍掉 80% 以上的体积。
第二步:多阶段构建
核心思路是把"编译安装"和"运行"拆成两个阶段,最终镜像只带走产物:
FROM python:3.11-slim AS builder
ENV PIP_NO_CACHE_DIR=1 PIP_DISABLE_PIP_VERSION_CHECK=1
WORKDIR /build
COPY requirements.txt .
RUN python -m venv /opt/venv && \
/opt/venv/bin/pip install -r requirements.txt
FROM python:3.11-slim
ENV PATH=/opt/venv/bin:$PATH \
PYTHONUNBUFFERED=1
COPY --from=builder /opt/venv /opt/venv
WORKDIR /app
COPY app/ ./app/
RUN useradd -m appuser && chown -R appuser /app
USER appuser
EXPOSE 8000
CMD ["python", "-m", "app.main"]
builder 阶段的编译器、头文件、wheel 缓存全部留在第一阶段,最终镜像只从 /opt/venv 拷一份干净的运行时。顺带把非 root 用户也加上,安全和体积一起解决。
第三步:让层缓存真正生效
Dockerfile 的书写顺序直接决定缓存命中率:先拷依赖清单并安装,再拷源码。如果写成 COPY . . 之后再 pip install,那么改一行代码就会让依赖全部重装,构建时间从十几秒变成几分钟。
.dockerignore 同样不能偷懒,否则 COPY 会把一堆开发期文件塞进镜像层:
.git
.venv
__pycache__
*.pyc
tests/
docs/
*.md
第四步:逐层体重与收尾清理
docker history <image>可以按层看体积,通常一眼就能找出几百 MB 的元凶;- apt 安装在同一层里完成清理:
apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/*; - 更细的可以用 dive 交互式查看每层新增了哪些文件;
- 最后
docker run --rm <image> id确认容器以非 root 身份启动。
效果
同一个服务,镜像从 1.2 GB 降到 190 MB 左右。在相同网络条件下,拉取耗时基本与体积成正比,等于省掉了八成以上的等待;镜像仓库占用和扫描时长也同步下降。
小结
- 基础镜像优先选 slim;
- 依赖安装与源码拷贝分成两层;
.dockerignore是免费的瘦身手段,别省;- 每写完一层都问一句:这个文件运行时真的需要吗?
瘦身不是一次性动作,把它当成 Dockerfile 的 review 检查项,效果更持久。
- 点赞
- 收藏
- 关注作者
评论(0)