运维指南 | COS回源设置实践

一、回源设置功能简介

1.简介

可以通过对象存储控制台，对存储桶设置回源规则，当请求的对象在存储桶中不存在或者需要对特定的请求进行重定向时，可以通过回源规则从 COS 访问到对应的数据。设置回源主要用于数据的热迁移、特定请求的重定向等场景，可以按照自身实际需要进行设置。

说明：

• 回源拉取数据的成功率依赖网络环境，请优先使用电信、移动、联通等 IP 段。
• 金融云地域的存储桶不支持回源设置。

二、离线回源与同步回源架构示意图

1.离线回源示意图

2.同步回源示意图

三、控制台配置指南

1.操作步骤

1）登录 对象存储桶控制台，选择左侧菜单栏【存储桶列表】，进入存储桶列表页面。单击需要设置回源的存储桶，进入存储桶详情页。

2）单击左侧【基础配置】>【回源设置】配置项，然后单击【添加回源规则】。

3）按照以下配置项说明进行配置，最后单击【保存】即可。

回源条件：可按需求选择触发回源的条件，触发回源需同时满足配置的所有回源条件。

• HTTP 状态码：当前仅支持条件为 HTTP 状态码404时触发回源，该项为必选且不可取消。
• 文件名前缀：当请求的文件名前缀匹配时，可触发回源规则。例如：设置文件名前缀为 prefix，则访问 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/prefix123.jpg 并且返回的 HTTP 状态码为404时，会触发回源规则。

回源协议：COS 访问指定的源站时所使用的 HTTP 协议，可选项为强制 HTTPS、强制 HTTP 和跟随请求协议。

• 选择强制 HTTPS/HTTP，则 COS 会以 HTTPS/HTTP 协议访问源站。
• 选择跟随请求协议，COS 会以您请求 COS 所使用的协议访问源站。

回源地址：只需填入域名或 IP 地址，支持域名或 IP 地址后面添加端口号。无需加上前缀http://或https://。正确示例地址如下：

回源地址支持具体的地址设置，可以配置为如下配置项。

• 固定文件：触发回源规则时，默认全部跳转至固定的文件。
• 指定前缀：触发回源规则时，跳转至指定前缀的文件。例如指定前缀为test，访问 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/prefix123.jpg 时触发回源规则，则会跳转至 <回源地址>/test/prefix123.jpg；
• 指定后缀：触发回源规则时，跳转至指定后缀的文件。例如指定后缀为.jpg，访问 https://examplebucket-1250000000.cos.ap-chengdu.myqcloud.com/prefix123 时触发回源规则，则会跳转至 <回源地址>/prefix123.jpg；

注意：

• 选择固定文件时，其他两种类型默认不可选。
• 指定前缀和指定后缀的配置可以同时生效。

同步回源：开启同步回源后，当 COS 需要去源站拉取数据时将不返回3XX 状态码。该配置项当前仅支持北京、上海、新加坡、孟买地域的存储桶。

3xx 跟随策略：开启后，当源站返回了 3XX 重定向状态码时，COS 的默认处理策略为跟随 3XX 再次到另一个源站拉取数据，选择关闭则不会拉取资源。

回源参数：指定是否将访问 COS 时携带的请求参数透传到源站。

回源头部：COS 在访问源站时，可携带指定的新增头部进行访问。当前最多支持新增10个自定义头部。

4）当添加完规则后，系统将为您的新规则分配最高优先级；COS 将按照最高优先级的规则回源；此外也可以在规则列表页面，单击修改按钮调整优先级。

四、离线回源与同步回源的实践操作

1.离线回源案例

1）首先在 COS 控制台添加回源规则，相关配置如下；其中，回源地址填写源站的外网地址 111.230.xxx.xxx ，同步回源选择 “关闭” ，其它的设置可以根据实际情况需要进行配置。

2）在源站添加一个 COS 上不存在的测试文件 test-1.txt，并确保通过源站可以正常访问 ；同时在桶上可以看到此时桶上并没有 test-1.txt 文件。

3）源站使用的是 nginx ，这里通过 tail -f 方式监控下 nginx 的访问日志，便于后面验证离线回源的请求过程。

4）现在通过 cos 的域名进行访问测试，从测试结果可以看到，客户端是先收到了 cos 返回的 302 后，重新去请求了源站 test-1.txt 文件，并且 cos 在延时后也发起了一个源站 test-1.txt 文件的请求，且最终把该文件拉取保存到了 cos 上。

2.同步回源案例

1）首先在 COS 控制台添加回源规则，相关配置如下；其中，回源地址填写源站的外网地址 111.230.xxx.xxx，同步回源选择 “开启” ，其它的设置可以根据实际情况需要进行配置。

2）在源站添加一个 COS 上不存在的测试文件 test-2.txt，并确保通过源站可以正常访问 ；同时在桶上可以看到此时桶上并没有 test-2.txt 文件。

3）源站使用的是 nginx ，这里通过 tail -f 方式监控下 nginx 的访问日志，便于后面验证同步回源的请求过程。

4）现在通过 cos 的域名进行访问测试，从测试结果可以看到，客户端是直接收到 cos 返回的 200 响应，而不是302响应；同时 cos 也发起了一个源站 test-2.txt 文件的请求，且最终把该文件拉取保存到了 cos 上。