关键在于多阶段构建与彻底清理：第一阶段用Alpine编译Nginx并安装，第二阶段仅复制二进制、配置和静态资源，删除源码、中间文件及构建依赖，最终镜像仅15–25MB。
直接用源码安装 Nginx 构建 Docker 镜像，关键不是“能不能装”，而是“装完怎么不留下一堆编译垃圾”。轻量的核心在于：编译在构建阶段完成，安装后立刻清理源码和中间文件，最终镜像只保留运行所需的二进制、配置和静态资源。
选对基础镜像，从源头减重
优先用 Alpine Linux（如 alpine:3.21.2）或精简版 Ubuntu（如 ubuntu:22.04-slim）。Alpine 镜像本身仅约 5–6MB，比标准 Ubuntu（~70MB）或 CentOS（~120MB）小一个数量级。注意：Alpine 使用 musl libc，若你依赖某些 glibc 特性或预编译模块，需验证兼容性；否则它是最优起点。
分阶段构建（multi-stage），隔离编译环境
把整个过程拆成两个阶段：第一阶段负责下载、编译、安装；第二阶段只复制编译好的 nginx 二进制、配置和 HTML 文件。这样最终镜像里完全不包含 gcc、make、.tar.gz 源码包等任何构建依赖。
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 第一阶段用
FROM alpine:3.21.2 AS builder，安装 build-base、pcre2-dev、openssl-dev、zlib-dev 等编译依赖 - 下载并解压 nginx 源码（如
wget https://nginx.org/download/nginx-1.25.3.tar.gz），执行./configure --prefix=/opt/nginx ... && make && make install - 第二阶段用
FROM alpine:3.21.2（纯净运行时），COPY --from=builder /opt/nginx /usr/local/nginx - 再 COPY 自定义的
nginx.conf和index.html，删掉默认 HTML 内容避免混淆
精简安装路径与启动方式
configure 时指定明确前缀（如 --prefix=/usr/local/nginx），避免分散文件；安装后用 make install 而非 make && make install（后者会保留 obj/ 目录）。启动命令固定为前台模式：CMD ["/usr/local/nginx/sbin/nginx", "-g", "daemon off;"]，确保容器不退出。
- 不要用
RUN nginx -t && nginx -s start这类后台启动，它会让容器立即退出 - 删除所有未使用的模块（如不用 HTTPS 就去掉
--with-http_ssl_module），减少二进制体积 - 用
apk del .build-deps（Alpine）或apt-get clean && rm -rf /var/lib/apt/lists/*（Debian/Ubuntu）清理包管理缓存
验证镜像是否真正轻量
构建完成后运行 docker images 查看大小。纯 Alpine + 源码编译 + multi-stage 的典型结果是 15–25MB；若超过 50MB，大概率是没清理源码、没分阶段、或误装了完整开发工具链。可用 docker run --rm -it <image> sh -c "ls -la /usr/local/nginx"</image> 进去确认只有 sbin、conf、html、logs 等必要目录，没有 src、obj 或 .o 文件。
