文档中心

镜像仓库

实例

创建远端代理仓

标准实例直接拉取境外镜像时，时常会出现拉取速度慢或者访问不通的情况。远端代理实例通过远端代理的缓存功能，实现就近访问的效果，有效提升镜像拉取效率。本文介绍创建远端代理仓的方法。

说明

小微版默认支持内网和公网访问，无需额外操作。同地域内默认内网连通，不仅不消耗公网带宽，还可以有效提升镜像拉取速率。

背景信息

远端代理仓用于代理缓存外部镜像源（Docker Hub、GHCR 或自建 Docker Registry），首次拉取时自动从远端源站同步镜像至本地缓存，后续拉取直接命中缓存。

远端代理仓支持标准版和小微版两种规格。您可以根据业务规模、性能要求和使用场景选择合适的实例类型。具体的实例规格说明参见实例类型。

使用场景

您使用 Docker Hub 或者 GHCR（GitHub Container Registry）源时，可能因为网络或其他问题，无法正常直接拉取。镜像仓库支持通过远端代理仓的方案拉取所需的镜像，且无需更换被拉取镜像的地址。

类型	代理的上游	使用场景
Docker	Docker Hub 官方	代理拉取 Docker Hub 上的公共 / 私有镜像（如 nginx、redis 等官方镜像和社区镜像），解决国内访问 Docker Hub 慢或不可达的问题。
Docker Registry	任意自建 / 第三方 Docker Registry（符合 Docker Registry V2 协议）	代理拉取企业自建 Harbor、AWS ECR、阿里 ACR 等私有仓库的镜像，适合跨云 / 混合云场景下统一镜像入口。
GHCR registry	GitHub Container Registry（ghcr.io）	代理拉取托管在 GitHub Packages 上的容器镜像（如开源项目发布在 ghcr.io/org/image 的镜像）。

注意事项

远端代理仓仅允许将第三方镜像仓库的镜像拉取至镜像仓库 CR，不支持主动推送镜像。

仅标准版远端代理仓支持 Docker Registry 类型。

前提条件

已注册系统账号，详细操作参见如何进行账号注册。

（可选）创建标准版远端代理仓，需要完成企业账号实名认证。详细操作，参见实名认证。

请确保您的火山引擎账户余额不低于 10 元人民币。详细操作，请参见费用中心。

操作步骤

登录镜像仓库控制台。

在顶部导航栏，选择目标地域。

左侧导航栏单击实例列表 > 远端代理，在右侧页面单击创建远端代理仓。

在创建远端代理仓页面，填写配置信息。

参数	说明
域名	自定义代理仓的域名。域名是仓库的访问入口，用于容器镜像的推送、拉取与管理。
项目	关联目标项目。关联后，该项目中成员将根据项目授权获取镜像仓库的对应权限。详情参见项目管理和管理项目授权。
计费类型	支持按量计费，后付费模式。可随开随停，按实际使用时长计费，计费详情参见产品计费。
规格	选择标准版或者小微版。
远端代理	根据您需要拉取的镜像类型，选择远端代理仓类型。拉取 Docker Hub 镜像：类型：选择 Docker。镜像拉取鉴权：开启鉴权：填写登录目标 Docker Hub 的用户名和密码后，支持拉取非官方镜像站（非library 仓库）下镜像。不开启鉴权：仅允许拉取官方镜像站（library 仓库）下镜像。网络加速：默认开启。为保证拉取质量，默认开启网络加速访问。跨境网络加速将收取回源流量费用，计费详情参见产品计费，实际费用以控制台展示为准。拉取 GitHub Container Registry 镜像：类型：选择 Ghcr registry。镜像拉取鉴权：开启鉴权：填写登录第三方镜像仓库的用户名和令牌后，支持拉取私有镜像。不开启鉴权：仅支持通过 https://ghcr.io/token 获取临时访问凭证，拉取公开镜像。网络加速：默认开启。为保证拉取质量，默认开启网络加速访问。跨境网络加速将收取回源流量费用，计费详情参见产品计费，实际费用以控制台展示为准。拉取企业自建私有镜像：类型：默认选择 Docker Registry。访问地址：填写远端代理仓的访问地址。Docker Registry 类型的访问地址支持后续变更。用户名：填写登录第三方镜像仓库的用户名。密码：填写登录第三方镜像仓库的密码。忽略证书有效期：默认不忽略，允许忽略访问地址的证书有效性。
标签	实例的标签（Tag）支持搜索，快速选择存量的标签。如果没有满足需求的标签，支持自定义添加。支持在分账账单中基于实例标签查看账单信息，详情说明参见分账账单。
服务端加密	注意仅标准版支持该功能。开启后不支持通过控制台关闭该功能，如果需要关闭请提交工单。存量实例不支持开启。如需对存量数据使用该功能，请新建一个开启加密的实例。支持通过实例同步功能将存量实例的数据迁移至新实例，降低迁移成本，实例同步的操作参见实例间同步。体积较大的镜像加解密会带来一定的推拉性能损耗，请按需开启。是否开启服务端加密。开启后，镜像数据在服务端将以加密形式存储，帮助您满足部分数据安全合规要求。开启：开启后上传的镜像默认加密。不开启：默认值，不开启加密。

查看实例规格对比和配置费用，确认无误后，单击确认订单。

在确认订单页面再次确认订单信息后，仔细阅读并勾选我已阅读并同意《镜像仓库产品服务条款》。

单击确定提交订单，开始创建。

后续操作

通过专线拉取远端代理仓：部分远端代理仓不支持公网访问，需要通过专线连通。

最近更新时间：2026.07.01 11:28:10

这个页面对您有帮助吗？

有用

无用