远端代理实例通过远端代理的缓存功能，实现就近访问的效果，有效提升跨境镜像拉取的效率。远端代理仓支持通过 Docker Hub 的原始域名 https://hub.docker.com，跨境拉取镜像。无需修改业务代码中 Docker Hub 镜像的地址。

注意事项

• 通过 Docker Hub 的原始域名 https://hub.docker.com 拉取镜像时，需要将远端代理仓中的 OCI 制品仓库设置为 公有 类型。
• 拉取远端代理仓中镜像发布应用时，需要将 nginx 替换为 {访问域名}/library/nginx:latest。

场景介绍

在中国大陆地区通过 https://hub.docker.com 域名，拉取 Docker Hub 中官方镜像（有 Docker Official Image 标识）Nginx。

前提条件

• 已创建 VKE 集群，操作详情参见 创建集群。
• 已获取 VKE 集群所处 VPC 信息，支持在集群概览页查看。
  

操作步骤

第一步：创建远端代理仓

1. 登录 镜像仓库控制台，创建远端代理仓。操作详情参见 创建远端代理仓。

   • 远端代理选择 Docker 类型。
   • 必须开启镜像拉取鉴权功能，设置用户名和密码。

   

2. 在远端代理仓概览页，获取 访问域名。
   

3. 使用标准版本远端代理仓时，需要在远端代理仓的 访问控制 > VPC 页面，添加 VKE 集群所在 VPC，确保代理和集群的网络连通。添加 VPC 的说明参见 连通本账号 VPC。

   说明

   小微版远端代理仓时默认使用同地域内网，无需单独配置。

   

第二步：创建命名空间

完成远端代理仓创建以后，需要在镜像仓库中创建和 Docker Hub 中镜像同名的命名空间。

1. 获取 Docker Hub 中镜像所处的命名空间，本示例为 grafana。

   

2. 在远端代理仓中创建命名空间 grafana，操作详情参见 创建命名空间。

   1. 登录 镜像仓库控制台。
   2. 在顶部导航栏，选择目标地域。
   3. 在左侧导航栏单击 实例列表，然后在 实例列表 区域中找到需要创建命名空间的标准版实例，单击 进入实例。
   4. 在标准版实例页面左侧导航栏单击 命名空间。
   5. 在 命名空间 页面，单击 创建命名空间。

   

3. 使用标准版本远端代理仓时，需要在远端代理仓的 访问控制 > VPC 页面，添加 VKE 集群所在 VPC，确保代理和集群的网络连通。添加 VPC 的说明参见 连通本账号 VPC。

   说明

   小微版远端代理仓时默认使用同地域内网，无需单独配置。

   

第三步：添加 Docker Mirror 配置

在 Docker 的 Deamon 文件中添加 registry-mirrors 配置，代码示例如下。

"registry-mirrors": ["https://<访问域名>"]

第四步：通过 Docker Hub 域名拉取镜像

使用访问域名拉取镜像文件。

# docker pull [命名空间]/[镜像仓库]:[镜像版本号]

docker pull grafana/grafana:main-ubuntu

操作结果

拉取成功后，您可以在远端代理仓的镜像详情页查看已拉取的镜像。