如何优化减小Python Streamlit应用的Docker镜像体积？

你当前镜像体积达到1.3GB的核心原因是使用了全量Debian版python:3.9作为基础镜像，该基础镜像本身就接近900MB，叠加系统依赖缓存、可能带入的无关文件后很容易突破1GB，可通过以下方式逐次压缩：

核心优化手段 #

• 替换轻量化基础镜像
  直接弃用默认的全量python:3.9镜像，按需选择更小的基础版本：

  • 优先选slim系列：比如python:3.9-slim-bullseye，裁剪了Debian系统中非必要的工具、文档、开发头文件，基础体积仅120MB左右，兼容性和全量镜像几乎一致，改造成本最低
  • 追求极致体积选alpine系列：比如python:3.9-alpine，基础体积仅50MB左右，由于alpine使用musl libc而非glibc，安装lxml这类带C扩展的依赖时需要额外适配，适合有一定容器化经验的场景

• 使用多阶段构建剥离编译依赖
  你用到的lxml库安装时需要gcc、libxml2-dev、libxslt-dev等编译依赖，这类依赖仅在安装包的阶段有用，完全不需要留在最终运行镜像里。通过多阶段构建，可在编译阶段安装所有编译工具、完成Python依赖安装，最终运行阶段仅拷贝安装好的依赖包和必要的运行时动态库，完全不带编译链，能砍掉数百MB的冗余体积。

• 清理所有冗余缓存与无关文件

  • 根目录新建.dockerignore文件，排除本地虚拟环境目录、__pycache__、.git目录、日志文件、测试代码、本地开发配置等不需要打进镜像的内容，避免COPY指令把无关文件带入镜像
  • 安装系统依赖后立刻清理缓存：用apt安装时执行完安装命令追加rm -rf /var/lib/apt/lists/*，用apk安装时加--no-cache参数，你当前用的pip install --no-cache-dir配置是正确的，保持即可
  • 不要在生产镜像里安装vim、curl、net-tools等调试工具，也不要在应用镜像里额外部署nginx等其他服务，如果需要反代建议用sidecar或者外层网关实现，避免给应用镜像增加不必要的体积

• 精简Python依赖
  生产环境单独维护依赖清单，不要把pytest、代码格式化工具、jupyter等开发依赖装到生产镜像里；如果对体积要求极高，可以在测试验证兼容性的前提下，用pip install --no-deps跳过非必要的关联依赖安装。

优化后可直接使用的Dockerfile示例 #

# 第一阶段：编译阶段，仅用于安装带C扩展的Python依赖
FROM python:3.9-slim-bullseye AS builder
WORKDIR /install
# 安装编译lxml所需的开发依赖，仅在本阶段存在
RUN apt-get update && apt-get install -y --no-install-recommends \
    gcc \
    libxml2-dev \
    libxslt1-dev \
    && rm -rf /var/lib/apt/lists/*
COPY requirements.txt .
# 将所有Python依赖安装到指定前缀目录，方便后续拷贝
RUN pip3 install --no-cache-dir --prefix=/install -r requirements.txt

# 第二阶段：最终运行镜像，无任何编译工具
FROM python:3.9-slim-bullseye
WORKDIR /app
# 仅安装lxml运行需要的动态库，不装开发包
RUN apt-get update && apt-get install -y --no-install-recommends \
    libxml2 \
    libxslt1.1 \
    && rm -rf /var/lib/apt/lists/*
# 从编译阶段拷贝预装好的Python依赖，不需要重新执行pip install
COPY --from=builder /install /usr/local

EXPOSE 8501
COPY ./src ./src
COPY ./deployment/nginx.conf ./deployment/nginx.conf
# 补全原Dockerfile缺失的启动命令
CMD ["streamlit", "run", "src/app.py", "--server.port=8501", "--server.address=0.0.0.0"]

按上述配置构建后，镜像体积通常可以压缩到200-300MB，如果换用alpine基础镜像适配后，体积可进一步压缩到100MB左右。

内容的提问来源于stack exchange，提问作者retr0327