Docker多阶段镜像构建

引言

直接打包项目代码、编译工具到镜像，镜像体积巨大，部署传输慢。Docker多阶段构建可以在第一阶段编译代码，第二阶段只复制编译后的成品，剔除编译器、源码，大幅度减小镜像大小。

原理

一个Dockerfile可以写多个FROM，每一个FROM代表一个阶段。阶段之间可以复制文件，最终镜像只保留最后一个阶段内容，前面阶段的编译环境不会打包进最终镜像。

示例Dockerfile(PHP项目)

#阶段1：构建
FROM php:8.2-cli AS builder
WORKDIR /app
COPY . .
RUN composer install --no-dev

#阶段2：运行环境
FROM php:8.2-cli-alpine
WORKDIR /app
COPY --from=builder /app .
CMD ["php","index.php"]

最终镜像只有php运行环境加业务代码，没有composer、源码缓存文件。

优势

• 镜像体积大幅缩小，传输更快；
• 减少攻击面，镜像内没有编译工具，安全性更高；
• 只维护单个Dockerfile，构建流程简单。

注意事项

• 多阶段命名便于阅读；
• 不要复制不需要的文件，.dockerignore忽略日志、缓存；
• 区分开发镜像与生产镜像，生产镜像精简。

总结

多阶段构建是容器化部署最佳实践，适合PHP、Go、前端打包等场景，生产环境镜像尽量使用多阶段构建，减小体积提升部署效率。