开发者指南

API 文档

SDK 文档

设置回源

最近更新时间:2020-06-18 20:15:12

简介

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

说明:

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

操作步骤

  1. 登录 对象存储桶控制台,选择左侧菜单栏【存储桶列表】,进入存储桶列表页面。单击需要设置回源的存储桶,进入存储桶详情页。
  2. 单击左侧菜单栏中的【基础配置】,进入存储桶基础配置页。
  3. 下拉页面找到【回源设置】配置项,修改当前状态为开启,然后输入回源地址。配置项说明如下:
    • 回源地址:只需填入域名或 IP 地址,支持域名或 IP 地址后面添加端口号。无需加上前缀http://https://
    • 回源协议:COS 访问您指定的源站时的 HTTP 协议,可选项为强制 HTTPS、强制 HTTP 和跟随请求协议。
      • 选择强制 HTTPS/HTTP,则 COS 会以 HTTPS/HTTP 协议访问您的源站。
      • 选择跟随请求协议,COS 会以您请求 COS 所使用的协议访问您的源站。
    • 回源参数:指定是否将访问 COS 时携带的请求参数透传到源站。
    • 3xx 跟随策略:当源站返回了 3XX 重定向状态码时,COS 的默认处理策略为跟随 3XX 再次到另一个源站拉取数据,选择不跟随则不会拉取资源。
    • 新增回源头部:COS 在访问您的源站时,可携带您指定的新增头部进行访问。当前最多支持新增10个自定义头部。

      正确示例地址如下:
      abc.example.com
      abc.example.com:8080
      10.10.10.10
      10.10.10.10:8080
  4. 最后单击【保存】即可。

示例

背景
APPID 为 1250000000 的用户创建名为 examplebucket-1250000000 的存储桶,并开启了 CDN 加速访问域名:

examplebucket-1250000000.file.myqcloud.com

设置存储桶回源地址为:

abc.example.com

在源站http://abc.example.com存放图片 picture.jpg。

客户端首次访问

http://examplebucket-1250000000.file.myqcloud.com/picture.jpg

COS 发现无法命中对象时,对客户端返回 302 HTTP 状态码并跳转至如下地址:

http://abc.example.com/picture.jpg

此时对象由源站提供给客户端,保证访问。同时 COS 从源站复制 picture.jpg 并保存至存储桶 example 的根目录中。

第二次访问

http://examplebucket-1250000000.file.myqcloud.com/picture.jpg

COS 直接命中根目录下 picture.jpg 对象并返回给客户端。

目录