Docker部署Django应用镜像过大：多阶段构建无效，求优化建议

我尝试用Docker部署Django应用，原始Dockerfile如下：

FROM python:3.10.5-slim

ENV DockerHOME = /app

WORKDIR $DockerHOME

COPY requirements.txt .

RUN pip install --upgrade pip

COPY . $DockerHOME

RUN pip install --nocache-dir -r requirements.txt

EXPOSE 8000

CMD ["python", "manage.py", "runserver"]

构建后镜像大小为300MB，觉得尺寸过大，于是尝试多阶段构建，对应的Dockerfile如下：

FROM python:3.10.5-slim as base

ENV DockerHOME = /app

WORKDIR $DockerHOME

COPY requirements.txt .

RUN pip install --upgrade pip

RUN pip install --nocache-dir -r requirements.txt

FROM python:3.10.5-slim

COPY --from=base $DockerHOME $DockerHOME
COPY . $DockerHOME

WORKDIR $DockerHOME

EXPOSE 8000

CMD ["python", "manage.py", "runserver"]

但构建后的镜像大小还是300MB，有两个问题求助：

1. 上述多阶段Dockerfile逻辑是否正确？为何镜像大小未出现明显缩减？
2. 还有哪些方法可以减小镜像大小？我最初使用FROM python:3.10.5时镜像大小为600MB，换成slim版本后降至300MB，是否存在更小的基础镜像或可优化的Django项目配置？

1. 多阶段构建逻辑问题及未缩减原因 #

你的多阶段构建逻辑完全不正确，根本没起到瘦身作用，核心原因有两点：

• 第一阶段（base）安装完依赖后，第二阶段直接把第一阶段的整个/app目录复制过来，随后又把本地项目文件再拷贝一遍，等于依赖和代码重复叠加，没有剔除任何冗余。
• 第二阶段用的基础镜像还是python:3.10.5-slim，和单阶段的基础镜像完全一致，没有减少基础层的体积。

另外注意：ENV DockerHOME = /app的写法有误，等号两边不能加空格，正确写法是ENV DockerHOME=/app，不过这不是体积问题的核心。

给你一个正确的多阶段构建思路：

# 构建阶段：专门安装依赖
FROM python:3.10.5-slim as builder

WORKDIR /app

COPY requirements.txt .
RUN pip install --upgrade pip
# 把依赖安装到单独目录，方便后续精准复制
RUN pip install --nocache-dir -r requirements.txt --target=/app/deps

# 运行阶段：只复制必要的运行文件
FROM python:3.10.5-slim

WORKDIR /app

# 复制构建好的依赖到Python的site-packages目录
COPY --from=builder /app/deps /usr/local/lib/python3.10/site-packages
# 复制项目代码
COPY . .

EXPOSE 8000
CMD ["python", "manage.py", "runserver"]

2. 进一步减小镜像大小的方法 #

（1）换用更小的基础镜像 #

• Alpine版本镜像：python:3.10.5-alpine基于轻量的Alpine Linux，基础镜像只有几十MB，比slim版本小一半以上。但要注意Alpine用musl libc替代glibc，部分Python包需要编译依赖，安装后要及时清理编译工具：

FROM python:3.10.5-alpine

WORKDIR /app

COPY requirements.txt .
# 安装编译工具→安装Python依赖→清理编译工具
RUN apk add --no-cache gcc musl-dev && \
    pip install --upgrade pip && \
    pip install --nocache-dir -r requirements.txt && \
    apk del gcc musl-dev

COPY . .

EXPOSE 8000
CMD ["python", "manage.py", "runserver"]

• Distroless镜像：Google推出的distroless镜像只保留运行必需的组件，体积比Alpine还小，但使用门槛较高，需要确保所有Python依赖都能兼容无glibc的环境。

（2）优化项目内容 #

• 用.dockerignore排除冗余文件：把项目里的.git、虚拟环境、__pycache__、测试文件、日志等无关文件排除，避免打包进镜像。.dockerignore示例：

.git/
venv/
__pycache__/
*.pyc
*.pyo
.env
*.log
tests/

• 生产环境关闭Django调试模式：设置DEBUG=False，既提升安全性，又能减少调试相关资源的加载。但要注意此时需要配置静态文件服务（比如搭配Nginx）。
• 精简依赖：检查requirements.txt，移除不必要的开发依赖（比如pytest、flake8等），只保留生产必需的包。

（3）其他优化技巧 #

• 合并RUN指令：把多个RUN命令合并成一条，减少镜像层数，同时在同一条命令里清理中间产物（比如pip缓存、安装包）。
• 清理pip缓存：安装依赖后执行pip cache purge，清除pip的缓存文件。
• 分层构建：把依赖安装层放在前面，项目代码层放在后面，利用Docker的缓存机制，减少每次构建的体积变动。

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