多阶段构建不依赖仓库类型，仅在本地完成构建与镜像精简；发布到私有仓库需正确打标签、配置认证（如insecure-registries或ca证书）、登录后推送，并验证镜像大小、层数及运行效果。
多阶段构建本身不依赖仓库类型，它发生在本地构建阶段；发布到私有仓库时，只需确保最终镜像已按规范打标签并完成推送。关键在于构建出精简镜像后，正确适配私有仓库的地址和认证要求。
构建阶段：用多阶段生成轻量运行镜像
多阶段构建的核心是分离构建环境与运行环境。例如 Go 项目：
- 第一阶段使用
golang:1.21-alpine编译代码，生成静态二进制文件 - 第二阶段基于
alpine:latest或scratch，仅复制二进制文件和必要配置 - 最终镜像不含编译器、源码、开发工具，体积通常压缩至 10MB 以内
标记阶段：添加私有仓库前缀
私有仓库要求镜像名称包含完整地址（如 192.168.10.5:5000 或 harbor.example.com/myproject）。构建完成后必须重命名镜像：
- 假设本地镜像名为
myapp:dev - 执行：
docker tag myapp:dev 192.168.10.5:5000/myapp:v1.2.0 - 若使用 Harbor 等带命名空间的仓库，格式为：
harbor.example.com/devops/myapp:v1.2.0
推送阶段：处理认证与协议限制
私有仓库常需额外配置才能成功推送：
- 对 HTTP 私库（如原生 registry），需在
/etc/docker/daemon.json中添加 insecure-registries 并重启 Docker - 对 HTTPS 私库（如 Harbor），需将 CA 证书复制到
/etc/docker/certs.d/your-registry-domain:port/ca.crt - 推送前必须先登录：
docker login 192.168.10.5:5000（输入用户名密码或令牌） - 最后执行：
docker push 192.168.10.5:5000/myapp:v1.2.0
验证阶段：确认精简效果与可用性
推送完成后建议立即验证：
- 在另一台机器上拉取：
docker pull 192.168.10.5:5000/myapp:v1.2.0 - 检查镜像大小：
docker images | grep myapp，对比是否显著小于含构建环境的版本 - 运行测试容器：
docker run --rm -p 8080:8080 192.168.10.5:5000/myapp:v1.2.0 - 查看层信息：
docker history 192.168.10.5:5000/myapp:v1.2.0，确认只有 2–4 层，无多余依赖
