Docker 镜像瘦身实录:多阶段构建把 1.2 GB 的 Python 服务压到 190 MB

举报
yd_221592244 发表于 2026/11/15 10:39:33 2026/11/15
【摘要】 为什么要瘦身镜像大小会直接影响三件事:冷启动扩容时的拉取时间、镜像仓库的存储成本,以及漏洞扫描出来的攻击面。以 Python 服务为例,python:3.11 全量基础镜像本身就有 1 GB 上下,再叠上 pip 依赖、编译工具链和构建缓存残留,很容易膨胀到 1.2 GB 以上。而运行时真正需要的,往往只有那几十兆的虚拟环境和业务代码。下面这套改法只动 Dockerfile,不改一行业务代...

为什么要瘦身

镜像大小会直接影响三件事:冷启动扩容时的拉取时间、镜像仓库的存储成本,以及漏洞扫描出来的攻击面。以 Python 服务为例,python:3.11 全量基础镜像本身就有 1 GB 上下,再叠上 pip 依赖、编译工具链和构建缓存残留,很容易膨胀到 1.2 GB 以上。而运行时真正需要的,往往只有那几十兆的虚拟环境和业务代码。

下面这套改法只动 Dockerfile,不改一行业务代码。

第一步:基础镜像先降一档

  • python:3.11(基于 Debian 全量):约 1.0 GB
  • python:3.11-slim:约 130 MB
  • python: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 左右。在相同网络条件下,拉取耗时基本与体积成正比,等于省掉了八成以上的等待;镜像仓库占用和扫描时长也同步下降。

小结

  1. 基础镜像优先选 slim;
  2. 依赖安装与源码拷贝分成两层;
  3. .dockerignore 是免费的瘦身手段,别省;
  4. 每写完一层都问一句:这个文件运行时真的需要吗?

瘦身不是一次性动作,把它当成 Dockerfile 的 review 检查项,效果更持久。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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