回源

当请求的文件在桶内不存在时，从指定源站拉取并写入存储，再返回给用户。本文说明回源能力与在管理后台中的配置步骤。

是什么

当用户通过绑定域名访问某文件时，若该文件在桶内不存在，系统可按你配置的回源规则从指定源站（原站 URL、镜像站等）拉取文件并写入存储，再返回给用户；后续相同请求可直接从存储命中。适用于从已有站点平滑迁移、CDN 回源、镜像加速等场景。

入口

1. 在 对象存储 → 存储桶列表 中点击目标存储桶进入桶详情。
2. 进入 存储桶设置 → 回源 Tab。
3. 在回源规则列表中可新增、编辑、删除、调整规则顺序；规则按列表顺序匹配，命中即生效。

需版本或功能开关开放回源能力；若菜单中无「回源」Tab 请确认已开通。相关：绑定域名、存储桶与文件。

新增 / 编辑回源规则（前端配置）

点击「添加回源规则」或某条规则的「编辑」后，按向导三步配置（协议配置 → 源站设置 → 信息确认）。

步骤一：协议配置

配置项	说明
回源模式	异步回源：先返回响应，后台异步拉取并写入存储，首次访问通常返回 302，适合大多数场景。同步回源：实时从源站拉取并返回，同时写入缓存，首次访问稍慢但数据即时可用。重定向：302 跳转到源站地址，不缓存，适合临时重定向或外链资源。
回源条件	文件不存在时触发（HTTP 404）：仅当桶内无该文件且访问返回 404 时回源。匹配路径前缀：可选，填写前缀（如 images/、photo）则仅对该前缀下的请求生效；可与 404 条件同时勾选。
回源协议	跟随请求协议 / 强制 HTTPS / 强制 HTTP，决定回源请求使用的协议。
透传查询参数	开启后，将用户请求 URL 中的 ?key=value 等查询参数原样传给源站。
请求头部	可选择透传指定请求头、或禁止透传指定头到源站，按需配置。

步骤二：源站设置

配置项	说明
源站地址	必填。源站域名或 IP（含端口），如 cdn.example.com 或 10.0.0.1:8080；协议由步骤一「回源协议」决定，此处只填主机部分。
备份源站	可选。开启后可添加多个备份源站地址；主源站不可用时自动按顺序切换备份源站，最多 10 个。
路径改写	使用原始路径：回源请求路径与用户请求路径一致。添加前后缀：可配置路径前缀（如 test/）、后缀（如 ?version=1）。固定路径：无论请求什么文件，都回源到同一固定路径（如 index.html）。
跟随重定向	源站返回 3xx 时是否跟随重定向；异步模式下 3xx 会透传客户端，无法校验重定向目标，请谨慎。
连接超时	回源请求的连接超时时间，可按需设置。

配置过程中可查看「预览」中的回源地址示例，确认路径改写是否符合预期。

步骤三：信息确认

核对规则名称、回源模式、源站与路径等，确认无误后保存。保存后规则出现在回源列表中，可按需调整顺序或编辑、删除。

规则顺序与多条规则

• 可配置多条回源规则；请求命中时按列表从上到下的顺序匹配，命中第一条即按该规则回源。
• 通过「排序」或拖拽调整顺序，可控制不同路径或条件优先使用哪条规则。
• 若需针对不同路径使用不同源站，可新增多条规则并分别设置「匹配路径前缀」与源站地址。

注意事项

• 回源依赖绑定域名访问；通过 S3 端点直连的请求是否走回源以产品行为为准。
• 同步回源会拉长首次响应时间；大文件或高并发场景建议使用异步回源。
• 重定向模式不落存储，不占用桶容量，但每次访问都会请求源站。