合并run指令是减少docker镜像层数最直接有效的手段，必须将同一构建意图的操作（如更新源、安装、清理）锁在同一run中，用&&串联确保原子性，并配合buildkit、多阶段构建等协同优化。

合并 RUN 指令是减少 Docker 镜像层数最直接、最有效的手段。每条 RUN 都会生成一个新层，而层越多，镜像体积越大、构建越慢、启动时 overlay2 查找路径开销越高。关键不是“能不能合并”，而是“必须按逻辑意图合并”——把属于同一构建目标的操作锁在同一层里。

同一构建意图的操作必须放在一个 RUN 中

比如安装软件包，本质是一次性动作：更新源 → 下载安装 → 清理缓存。拆成三行 RUN 就产生三层，且中间层残留大量 /var/lib/apt/lists/ 数据，徒增体积和安全风险。

• 错误写法（3 层，残留缓存）：
  RUN apt-get update
  RUN apt-get install -y curl
  RUN rm -rf /var/lib/apt/lists/*
• 正确写法（1 层，无残留）：
  RUN apt-get update && \
    apt-get install -y --no-install-recommends curl && \
    rm -rf /var/lib/apt/lists/*

用 && 保证原子性，用反斜杠提升可读性

RUN 底层调用的是 /bin/sh -c，天然支持 shell 运算符。&& 不仅串联命令，更确保前序失败时整条指令中止，避免半截状态污染镜像。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 所有命令必须用 && 连接，不能用 ; 或换行符替代
• 长命令用 换行，语义仍属单条 RUN，Docker 不会因此多建层
• 可加 set -eux 提升调试能力（例如 RUN set -eux && apt-get update && ...）

安装与清理必须同层，否则等于白干

很多团队只记得“装软件”，却忘了清理。apt-get install 后不执行 rm -rf /var/lib/apt/lists/*，那一层就会永久携带几百 MB 的包索引文件。即便你在下一层 RUN 中清理，上一层的残留依然存在——Docker 层不可变，只能叠加，不能删改。

• 常见残留目录：/var/lib/apt/lists/、/tmp、/var/cache/apk（Alpine）、.npm、node_modules（若未 .dockerignore）
• 推荐统一清理模板：&& rm -rf /var/lib/apt/lists/* /tmp/* /var/cache/*
• 对于 Alpine：RUN apk add --no-cache curl nginx

配合其他策略才能真正极致收敛

单靠合并 RUN 只能解决“显性层数”，要压到 2–3 层，还需组合技：

• 启用 BuildKit：自动跳过未变更层，减少冗余 I/O
• 采用多阶段构建：builder 阶段编译，final 阶段只 COPY 二进制，彻底剥离 dev 工具链
• 选用 distroless 或 scratch 基础镜像：没有包管理器、shell、man 文档，从源头砍掉 10+ 层
• 用 docker history --no-trunc your-image 查看真实层数，警惕 和异常大层