对象存储

  • 对象存储 > 使用指南 > 控制台指南 > 空间管理 > 空间设置 > 设置跨域资源共享

    设置跨域资源共享

    最近更新时间: 2024-07-12 10:20:43

    跨域访问即通过 HTTP 请求,从一个域去请求另一个域的资源。只要协议、域名、端口有任何一个不相同,都会被当作是不同的域。跨域资源共享 CORS(Cross-Origin Resource Sharing),是 HTML5 提供的标准跨域解决方案。

    七牛云对象存储 Kodo 系统默认支持 CORS 标准来实现跨域访问,并提供了存储空间(Bucket)级别的 CORS 自定义规则配置,添加规则后七牛云存储会根据已设定的规则来允许或者拒绝相应的跨域请求。

    您可以通过控制台对空间进行设置并对空间中的对象(Object)进行跨域访问。

    说明

    • 存储空间默认允许跨域访问;当添加了自定义跨域规则时,只有在规则匹配时,跨域请求才会被允许。
    • 最多允许设置 10 条跨域规则。
    • 系统支持创建多条跨域访问规则,当收到跨域访问请求时,会依次检查每一条规则,使用第一条匹配的规则来允许请求并返回对应的 Header。
    • 对于同一个域名如果设置了多条规则,那么按顺序使用第一条匹配的规则去生成返回值。
    • 如果所有规则都匹配失败,则不附加任何 CORS 相关的 Header。CORS 规则匹配成功必须满足以下三个条件:
      • 请求的 Origin 必须匹配一个允许来源项。
      • 请求的方法(如 GET、PUT 等)或者 OPTIONS 请求的 Access-Control-Request-Method 头对应的方法必须匹配一个允许 Methods 项。
      • OPTIONS 请求的 Access-Control-Request-Headers 头包含的每个 Header 都必须匹配一个允许 Headers 项。
    • 关于跨域访问的更多信息,请参见 跨域资源共享

    操作步骤

    1. 登录 Kodo 控制台进入空间管理界面
    2. 单击目标空间名称,单击空间设置进入空间设置界面
    3. 找到跨域设置栏,如图1,单击设置,进入图2:跨域设置界面
      图1:
      截屏2021-08-12 上午11.43.11.png
    4. 在图2:跨域设置界面,单击 +新建规则 ,右侧弹出创建新规则界面
      图2:
      截屏2021-08-12 上午11.45.28.png
    5. 在创建跨域规则界面,按如下说明配置各项参数:
      操作名称 说明 规则描述
      来源 请填写来源,即指定允许的跨域请求的来源 - 必填
      - 大小写敏感
      - 允许多条来源,每行一个
      - 每条匹配规则允许使用最多一个「 * 」通配符
      - 单独填写「 * 」通配符,表示允许所有来源的跨域请求
      - 对应服务端响应头里的 Access-Control-Allow-Origin 字段
      允许 Methods 请勾选允许的 Methods,即指定允许的跨域请求方法 - 必填、可多选
      - 对应服务端响应头里的 Access-Control-Allow-Methods 字段
      允许 Headers 请按需填写允许的 Headers,即指定允许的跨域请求的响应头 - 大小写不敏感
      - 允许多条匹配规则,多条规则需换行填写
      - 如果有通配符「 * 」,则单行只能是通配符「 * 」
      - 对应服务端响应头里的 Access-Control-Allow-Headers 字段
      暴露 Headers 请按需填写暴露的Headers,即指定允许用户从应用程序中访问的响应头 - 大小写不敏感
      - 允许多条匹配规则,多条规则需换行填写
      - 不允许使用*通配符。
      - 对应服务端响应头里的 Access-Control-Expose-Headers 字段
      缓存时间(秒) 请按需填写缓存时间,即指定浏览器对特定资源的预取请求返回结果的缓存时间。 - 单位:秒
      - 对应服务端响应头里 Access-Control-Max-Age 字段
    6. 单击确定,完成规则创建。
    7. 事件通知规则保存成功后,您可以在规则列表中查看已设置的规则,也可以对规则进行 编辑删除。如图3,支持单条编辑与删除及批量清空全部规则
      图3:
      截屏2021-08-12 下午12.07.52.png
    以上内容是否对您有帮助?
  • Qvm free helper
    Close