我完全懂你的痛点——内部私有仓库的基础镜像没法被外部客户端访问，直接写无前缀的基础镜像又有安全风险，想用别名来兼顾构建便利性和分发后的可用性。下面给你几个实用的解决方案：

方案1：用构建参数（ARG）动态切换镜像源 #

这是最灵活的方式，既能在内部构建时指向私有仓库，又能在分发阶段无缝切换到公共仓库地址：

1. 修改Dockerfile，引入构建参数作为镜像前缀：

   # 默认指向内部私有仓库
   ARG BASE_REGISTRY=docker.internal.example.com:5000
   FROM ${BASE_REGISTRY}/java/jetty-jdk8:latest
   
   # 后续构建步骤...
   

2. 内部构建时直接使用默认值：

   docker build -t my-app:internal .
   

3. 准备分发前，先把内部基础镜像同步到分发仓库：

   # 拉取内部镜像
   docker pull docker.internal.example.com:5000/java/jetty-jdk8:latest
   # 重标记为分发仓库地址
   docker tag docker.internal.example.com:5000/java/jetty-jdk8:latest docker.distr.example.com/java/jetty-jdk8:latest
   # 推送到分发仓库
   docker push docker.distr.example.com/java/jetty-jdk8:latest
   

4. 构建分发版本镜像时，覆盖BASE_REGISTRY参数：

   docker build --build-arg BASE_REGISTRY=docker.distr.example.com -t my-app:distr .
   

   最终生成的镜像，其基础镜像地址会自动替换为分发仓库的地址，客户端拉取时完全没有访问障碍。

方案2：配置Docker本地镜像别名（满足你想要的DOCKER-PRIVATE形式） #

如果你确实想用类似DOCKER-PRIVATE:5000/java/jetty-jdk8:latest的别名，可以通过Docker配置文件实现本地解析：

1. 在构建机器上编辑Docker配置文件（系统级为/etc/docker/config.json，用户级为~/.docker/config.json），添加镜像别名映射：

   {
     "aliases": {
       "DOCKER-PRIVATE:5000/java/jetty-jdk8:latest": "docker.internal.example.com:5000/java/jetty-jdk8:latest"
     }
   }
   

   保存后重启Docker服务生效：systemctl restart docker

2. 现在你可以在Dockerfile里直接写：

   FROM DOCKER-PRIVATE:5000/java/jetty-jdk8:latest
   

   构建机器会自动把别名解析成内部私有仓库的真实地址。

3. 分发时，先把基础镜像同步到分发仓库，再修改配置文件里的别名映射为分发仓库地址，重新构建镜像即可：

   {
     "aliases": {
       "DOCKER-PRIVATE:5000/java/jetty-jdk8:latest": "docker.distr.example.com/java/jetty-jdk8:latest"
     }
   }
   

注意：这个别名是构建机器本地的配置，未配置的机器无法解析，建议在CI/CD流水线里统一配置该文件，确保构建环境一致。

方案3：用工具批量同步镜像 #

如果内部有大量基础镜像需要同步到分发仓库，可以用skopeo工具直接在仓库间同步，无需拉取到本地：

# 同步单个镜像
skopeo copy docker://docker.internal.example.com:5000/java/jetty-jdk8:latest docker://docker.distr.example.com/java/jetty-jdk8:latest

这个工具效率更高，适合批量迁移场景。

最后再补充下官方不推荐无前缀FROM java/jetty-jdk8:latest的原因：Docker会默认从Docker Hub拉取镜像，如果你的内部镜像和Hub上的官方镜像同名，很可能拉取到错误版本甚至恶意镜像，生产环境里这种风险完全不可接受，所以带前缀或别名的形式才是更安全的选择。

内容的提问来源于stack exchange，提问作者user5479362