当请求方访问 Bucket 中一个不存在的文件（Object）时，veImageX 会向回源规则指定的源站获取这个文件。在获取到目标文件后，veImageX 会将文件返回给请求方并存入 Bucket。

适用场景

镜像回源主要用于小文件数据无缝迁移到 veImageX 的场景，该过程不会中断或停止线上的服务能力。您可以在使用数据迁移迁移大文件的同时，使用镜像回源功能保证业务的正常进行。

1. 您可以通过数据迁移 ，将原有大文件数据迁移至 veImageX 中，同时在 veImageX 为原存储 Bucket 配置镜像回源规则。

2. 建议您将您的业务域名切换成 veImageX 的域名。在还有新生成的部分热数据尚未迁移到 veImageX 的情况下，用户仍可以正常从 veImageX 访问资源。

3. 当您的源站不再产生新的热数据时，您可以再通过数据迁移将源站残余数据导入 veImageX。全部数据迁移完成后，您就可以关闭镜像回源设置。

使用限制

• 如果没有匹配相应的回源条件，则不会命中相应规则。
• 默认超时时间为 600s。
• 如果回源时源站返回 404 状态码，则 veImageX 也会返回 404 给用户。
• 确保需要设置镜像回源的服务未开启版本控制能力。

回源规则

1. 触发回源条件：访问存储桶中的对象不存在。

2. 返回回源内容：通过回源规则中的回源地址继续访问，返回指定资源并存入存储桶。

操作步骤

1. 登录 veImageX 控制台，单击服务管理。选择相应的图片服务，单击基础配置。

2. 在存储配置页签找到镜像回源，单击修改按钮。您可参考下表完成配置。

   

   参数	说明
   主回源地址	协议：可选 https 或 http，默认为 http。 地址：支持填写域名与 IP 地址，但地址中不能包含文件路径。 权重：表示回源时选择主源站的比例，取值范围为 [51,100]，权重越高回源概率越大。
   备回源地址	协议：可选 https 或 http，默认为 http。 地址：支持填写域名与 IP 地址，但地址中不能包含文件路径。 权重：表示回源时选择备源站的比例，不可设置，将根据主回源地址权重自动调整。
   源文件路径	当请求的源文件路径匹配时，可触发回源规则。
   文件名前缀	当请求的文件名前缀匹配时，可触发回源规则。
   回源使用的 HTTP Header	veImageX 在访问指定的源站时，允许传递的响应头，使用 request 和 response 传递附加信息。

3. 单击保存按钮，保存当前配置。

OpenAPI

您可以通过调用 OpenAPI 更新镜像回源配置，具体请参考 UpdateImageMirrorConf。