Docker 多阶段构建:把 Go 镜像从几百 MB 瘦到十几 MB

举报
yd_278073926 发表于 2026/11/17 06:12:24 2026/11/17
【摘要】 把 Go 程序放进 Docker,最容易踩的坑是镜像越做越大:一个 golang 基础镜像本身就几百 MB,再装上构建工具、源码、缓存,打出来的镜像常常超过 1GB。部署时每次拉取都要传这么大的包,又慢又占磁盘。多阶段构建就是解决这个问题的标准做法:一个阶段负责编译,另一个阶段只负责运行,最后镜像里只留运行必需的东西。第一阶段用 golang 镜像做构建。Dockerfile 里先 FROM...

把 Go 程序放进 Docker,最容易踩的坑是镜像越做越大:一个 golang 基础镜像本身就几百 MB,再装上构建工具、源码、缓存,打出来的镜像常常超过 1GB。部署时每次拉取都要传这么大的包,又慢又占磁盘。多阶段构建就是解决这个问题的标准做法:一个阶段负责编译,另一个阶段只负责运行,最后镜像里只留运行必需的东西。

第一阶段用 golang 镜像做构建。Dockerfile 里先 FROM golang:1.22-alpine AS builder,设置工作目录,把 go.mod 和 go.sum 先拷进去跑 go mod download,这样依赖层可以被缓存;只有 go.mod 变了才重新下载依赖,改业务代码时不用重复下载。再把源码拷进去,执行 CGO_ENABLED=0 GOOS=linux go build -o app .,得到一个静态编译的二进制文件。CGO_ENABLED=0 很关键:它让二进制不依赖系统里的 C 库,后面才能放进一个几乎空的运行镜像里。

第二阶段用尽量小的运行镜像。FROM alpine:latest,装一个 ca-certificates 就够了(程序要调 HTTPS 接口时需要根证书),再把第一阶段编译好的二进制 COPY --from=builder /app/app /app,设好 EXPOSE 和 CMD。最终镜像里没有 Go 工具链、没有源码、没有编译缓存,只有几 MB 的二进制加一个十几 MB 的 alpine,总体十几到二十 MB,和原来几百 MB 甚至 1GB 的镜像比,拉取速度和磁盘占用都完全是另一个量级。更极端的做法是用 scratch 空镜像,连 alpine 都不要,镜像可以压到只有二进制本身的大小,但要自己处理时区文件和根证书,适合对体积特别敏感的场景。

多阶段构建还有一个附带好处:构建环境和运行环境彻底分开。构建阶段装什么工具、用什么版本,都不会污染运行镜像;运行镜像里没有编译器和包管理器,攻击面也小得多。配合 .dockerignore 把 .git、本地配置文件、测试数据排除在构建上下文之外,构建更快,也不会把敏感文件误打进镜像。

改代码重新构建时,Docker 的层缓存会发挥作用:依赖没变就复用依赖层,只有源码层和编译层重新执行。发布流程也因此变简单:docker build -t ordering-backend:v2 .,再 docker run -d --name ordering --restart unless-stopped -p 8080:8080 ordering-backend:v2,旧容器删了重建,代码就更新了。镜像小,拉取快,回滚也快——出问题直接用旧版本的镜像重新起一个容器,几秒就能恢复。

镜像瘦身不是为了好看:镜像越小,拉取越快、磁盘占用越少、启动越快、攻击面越小。一个 Go 服务配上多阶段构建,十几 MB 的镜像跑在云服务器上,才是部署该有的样子。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。