镜像瘦身关键在构建源头控制：选用精简基础镜像（如node:20-alpine）、多阶段构建分离编译与运行环境、合并RUN指令避免冗余层，并用docker history定位体积大户。
镜像体积过大，核心问题不在代码本身，而在分层机制和构建过程的冗余。docker 镜像是只读层叠加而成，每条 run、copy 都会新增一层，而删除操作不会抹掉上层已写入的文件，只会加一层“隐藏标记”。所以瘦身不是靠后期清理，而是从构建逻辑源头控制。
选对基础镜像，直接砍掉大头
别用 node:20、openjdk:17 这类带完整工具链的镜像跑生产服务。它们自带 shell、编译器、文档、调试工具，体积动辄 400MB 起。换成精简版：
-
node:20-alpine：基于 Alpine Linux，基础层仅约 5MB，整体常压到 100MB 内 -
openjdk:17-jre-slim或17-jre-alpine：去掉 JDK 中的 javac、javadoc 等非运行组件 - Go/Rust 等静态语言项目可直奔
FROM scratch，零基础体积，只放一个二进制文件
多阶段构建，把编译环境和运行环境彻底分开
这是最有效的一招。构建阶段可以随便装工具、下依赖、跑测试；运行阶段只 COPY 编译产出物，其余一概不带。
例如 Node.js 项目：
FROM node:20-alpine AS builder WORKDIR /app COPY package*.json ./ RUN npm ci --no-cache-dir COPY . . RUN npm run build FROM node:20-alpine-slim WORKDIR /app COPY --from=builder /app/dist ./dist COPY --from=builder /app/node_modules ./node_modules CMD ["node", "dist/server.js"]
这样最终镜像里没有 src/、没有 package-lock.json、没有 devDependencies，连 npm 命令都不在。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
合并 RUN 指令，避免缓存残留
常见错误写法：
RUN apt-get update && apt-get install -y curl RUN rm -rf /var/lib/apt/lists/*
第二行删不掉第一层里的文件，只是覆盖了一层“已删”标记。正确做法是所有安装+清理放在同一行：
RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*- Python 项目用
pip install --no-cache-dir -r requirements.txt - NPM 项目用
npm ci --no-cache-dir，禁用 npm 缓存目录
用 docker history 定位“吃体积”的层
执行 docker history <镜像名>，逐层看 SIZE（注意新版中复用层可能显示 0B，不代表不存在）。重点关注：
- 哪一层占了 300MB+？很可能是
apt install或npm install没清理缓存 - 有没有整套
src/或node_modules/被 COPY 进去？说明没用多阶段或 COPY 范围太宽 - 是否存在重复的
RUN指令？比如两次apt update，会多出无意义层
