多阶段构建可将Go镜像从800MB+压至6–15MB，核心是builder阶段用golang镜像编译并清理冗余，final阶段仅COPY静态二进制到alpine或scratch，严格分离环境，禁用cgo、裁剪符号表、精准路径COPY。

多阶段构建优化 Go 项目镜像体积，核心是只保留运行必需的二进制文件，彻底剥离编译环境和无关文件。单阶段构建常把 Go SDK、源码、测试、.git、vendor 全打进镜像，导致体积超 800MB；而合理设计的多阶段构建可压到 6–15MB，同时提升安全性和启动速度。

分清 builder 和 final 两个阶段职责

builder 阶段只干一件事：编译出干净的静态二进制。final 阶段只做一件事：运行这个二进制。

• builder 镜像选 golang:1.22-slim（推荐）或 golang:1.22-alpine，别用 latest——tag 不固定会导致 CI 构建不可复现
• final 镜像优先选 alpine:latest（带 shell 和基础工具，便于调试）；若追求极致精简且确认无 TLS/时区/DNS 问题，可用 scratch
• 务必用 AS builder 显式命名构建阶段，后续才能通过 --from=builder 精准复制

精准控制 builder 阶段内容，避免“一把梭”

COPY 操作顺序和范围直接影响缓存复用与最终体积。

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

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

下载

• COPY go.mod go.sum ./ 必须单独成层，且放在 COPY . . 之前——只要依赖没变，go mod download 就能复用缓存
• 源码只 COPY 实际需要的部分，例如 COPY cmd/ main.go ./，不要 COPY . .，否则会引入 .git、testdata、vendor、IDE 配置等冗余内容
• 编译前加 RUN go clean -cache -modcache -deps（可选），防止上一次构建残留影响当前结果

编译参数一个都不能少

Go 默认行为会悄悄带上调试信息、绝对路径、C 动态链接，让二进制变大、不兼容、甚至启动失败。

• CGO_ENABLED=0 是硬性要求——Go 1.20+ 默认启用 cgo，哪怕没写 C 代码，net 或 os/user 包也可能链接 libc
• GOOS=linux 必须显式指定，否则在 macOS/Windows 上构建会产出 Darwin/Windows 二进制，扔进 Linux 容器直接报错
• -trimpath 剥离源码绝对路径，保证构建可重现
• -ldflags="-s -w" 同时清除符号表和 DWARF 调试信息，体积常降 30%–50%
• 完整命令示例：RUN CGO_ENABLED=0 GOOS=linux go build -trimpath -ldflags="-s -w" -o /app/main ./cmd/app

final 阶段只拷正确路径，别拼错

Docker 不会自动纠错，路径写错、WORKDIR 设偏、阶段名打错，都会导致静默失败——镜像构建成功，但里面没有可执行文件。

• COPY --from=builder 后面的路径必须和 builder 阶段中 go build -o 指定的目标路径严格一致，比如 /app/main 就不能写成 ./main 或 main
• 如果 final 镜像要用 HTTPS（如调用外部 API），需确保 CA 证书可用：要么 RUN apk --no-cache add ca-certificates（alpine），要么从 builder 阶段复制 /etc/ssl/certs/ca-certificates.crt
• 建议在 final 阶段用 USER nonroot:nonroot 降低权限，增强安全性