开发机拉取海外镜像
更新时间:2026-03-18
背景说明
在使用百度百舸(AI计算平台)创建开发机或训练任务时,如果您填写的容器镜像地址(如 docker.io)或模型下载地址(如 huggingface.co)位于海外,可能会受限于跨国网络环境(防火墙、带宽延迟等),导致以下问题:
- 拉取超时/失败:实例长期处于“创建中”或直接报错。
- 下载速度极慢:严重影响开发与部署效率。
平台处理机制
目前百舸平台对网络访问的处理逻辑如下:
- 无需 VPN 的资源:如果目标镜像/模型地址在国内网络环境下可直连访问,平台将直接进行拉取。
-
需 VPN/受限资源:对于被防火墙阻断或需要特殊网络环境才能访问的海外资源,平台暂不支持自动加速拉取。此类情况建议通过“中转上传”的方式解决。
- 针对无法拉取的海外镜像(如 gcr.io、部分 docker.io 镜像),建议您先将其下载到本地,或上传至百度智能云容器镜像服务 (CCR),再从百舸平台内进行拉取。
操作步骤
- 准备镜像(在您的本地环境/中转机)
- 支持上传至百度智能云 CCR镜像仓库(参见外部镜像迁移至企业版实例。),或直接跳转第3步。
- 在百舸中选用镜像

- 对于上传至百度智能云 CCR镜像仓库的镜像,则直接从CCR仓库选择即可。
- 对于未上传至CCR镜像仓库的镜像,直接填写镜像地址。
备注:若为加密镜像仓库,必须填写账号密码进行授权,否则无法创建开发机,并且,因为在关机后再开机、变更配置、打包docker镜像等多个场景下,都会需要使用账号密码重新拉取镜像,所以请尽量使用长久有效的账号密码,不然某些操作可能出现报错
