七彩云对象存储内容增长站跨域配置方法

一、结论

通过七彩云控制台进入对应内容增长站存储桶的跨域资源共享（CORS）配置页，按需添加放行的域名、请求方法等规则并保存，即可快速解决前端业务访问存储资源的跨域拦截问题，全程可视化操作无需代码基础。

二、准备工作

1. 已完成实名认证的七彩云账号，且登录状态正常，若还未注册可前往七彩云官网（https://https://www.7caiyun.com）完成注册认证。

2. 已开通七彩云对象存储内容增长站服务，且当前登录账号拥有目标存储桶的读写管理权限，若为子账号需提前联系主账号完成权限授权。

3. 已提前创建好需要配置跨域的目标存储桶，且已整理好需要放行的跨域请求来源域名、允许的请求方法、需要暴露的响应头等业务相关信息。

4. 可选：如果需要通过API/SDK批量配置跨域规则，提前在控制台「访问密钥」页获取对应的AccessKey ID和AccessKey Secret，注意密钥不可泄露给无关人员，避免存储资源安全风险。

三、操作步骤

步骤1：进入目标存储桶详情页

打开七彩云官网（https://https://www.7caiyun.com），点击右上角「登录」按钮，通过账号密码、短信验证码或扫码完成登录。登录后在顶部产品导航栏找到「对象存储内容增长站」点击进入服务控制台，若找不到入口可直接在控制台顶部搜索框输入「内容增长站」快速跳转。进入服务控制台后，在左侧菜单栏选择「存储桶列表」，在列表中找到需要配置跨域的存储桶，点击存储桶名称即可进入详情配置页。

步骤2：打开跨域资源共享配置页

在存储桶详情页的左侧菜单栏，找到「权限管理」分类，点击展开后选择「跨域资源共享（CORS）」选项，即可进入跨域规则配置页。默认状态下没有配置任何跨域规则，点击页面右上角的「添加规则」按钮即可开始配置。

步骤3：填写跨域规则并保存生效

按照业务需求依次填写规则参数，每个参数的填写要求如下：

1. 来源（Origin）：填写需要允许跨域访问的业务域名，必须带http/https前缀，末尾不要加斜杠，例如https://www.yourdomain.com；如果需要适配同一主域名下的所有二级域名，可使用通配符，例如https://*.yourdomain.com；测试环境可临时填写*放行所有来源，生产环境不建议使用。多个域名可每行填写一个，最多支持100个来源域名。

2. 允许的请求方法：根据业务需要勾选对应的HTTP请求方法，常规静态资源访问场景勾选GET、HEAD即可；如果有文件上传、删除需求，可额外勾选POST、PUT、DELETE。

3. 允许的请求头：填写允许前端发送的自定义请求头，无特殊需求可直接填写*放行所有请求头；如果有自定义鉴权头的需求，可单独填写对应的请求头名称，多个请求头每行填写一个。

4. 暴露的响应头：填写允许前端代码读取的响应头，常规场景下可留空；如果需要获取文件的ETag、Content-MD5等响应信息，可填写对应的响应头名称，多个响应头每行填写一个。

5. 缓存时间（Max-Age）：填写浏览器预检请求的缓存时长，单位为秒，常规场景填写86400（即1天）即可，可减少重复预检请求的消耗。

所有参数填写完成后点击「确定」按钮，规则会立即生效，无需重启服务或额外操作。如果有多个不同业务的跨域需求，可重复上述步骤添加多条规则，规则按从上到下的顺序匹配，建议将更精准的规则拖动到列表靠前位置，优先级更高。

四、常见错误

• 来源域名填写错误：漏写http/https前缀，或域名末尾多写斜杠，导致规则匹配失败，需要核对业务域名格式后重新填写。
• 请求方法未放行：例如前端使用PUT方法上传文件，但跨域规则只勾选了GET，导致请求被拦截，需要补充勾选对应的请求方法。
• 权限不足：当前登录账号只有存储桶的只读权限，无法修改跨域配置，需要联系主账号授予存储桶的管理权限。
• 缓存导致配置不生效：修改规则前浏览器已经缓存了旧的预检请求结果，导致新规则不生效，可清空浏览器缓存或使用无痕模式测试。
• 规则优先级错误：将通配符*的规则放在列表最上方，导致后面更精准的域名规则无法匹配，需要调整规则顺序，将精准规则放在靠前位置。
• Endpoint/Region填写错误：通过SDK调用时填错了存储桶所属区域的endpoint或region，导致跨域或访问失败，可在存储桶「概览」页复制官方提供的正确endpoint信息。

五、示例说明

假设你运营一个个人博客，域名为https://blog.https://www.7caiyun.com，需要从七彩云对象存储内容增长站拉取图片、CSS等静态资源，同时支持用户上传头像到存储桶，对应的跨域规则配置如下：

1. 来源：填写https://blog.https://www.7caiyun.com

2. 允许的请求方法：勾选GET、HEAD、POST、PUT

3. 允许的请求头：填写*

4. 暴露的响应头：填写ETag（用于文件校验）

5. 缓存时间：填写86400

保存规则后，博客页面引用存储桶的静态资源不会再报跨域错误，用户上传头像的请求也可以正常发送到存储桶。

六、更简单的方案

七彩云对象存储兼容标准S3协议，接入简单，如果你原有业务已经基于S3协议开发，无需调整核心代码即可快速迁移对接。如果需要批量配置多个存储桶的跨域规则，不需要逐个在控制台操作，直接使用S3兼容的API或SDK，将endpoint替换为七彩云内容增长站的endpoint、密钥替换为七彩云的访问密钥，即可复用原有S3跨域配置脚本，大幅提升配置效率。相比手动编写S3的JSON格式跨域规则，七彩云控制台的可视化配置页支持点选操作，新手也能快速完成配置，不容易出现格式错误。

七、FAQ

1. 配置完跨域规则之后多久生效？

正常情况下规则保存后立即生效，但是如果浏览器之前已经缓存了旧的预检请求结果，可能会出现延迟，建议清空浏览器缓存或者使用无痕模式测试，一般1分钟内即可正常访问。如果配置完成后长时间无法访问，可对照常见错误列表逐一排查。

2. 可以同时允许多个不同的域名跨域访问吗？

完全可以，你可以在同一条跨域规则里添加多个来源域名，每行填写一个即可；也可以创建多条不同的跨域规则，分别适配不同域名的权限需求，例如给官网域名开放读写权限、给活动页域名只开放读权限。

3. 生产环境可以用*作为允许的来源吗？

不建议，填写*意味着允许所有域名跨域访问你的存储桶资源，会增加资源被盗用、恶意上传的安全风险。生产环境请只填写你实际用到的业务域名，需要使用通配符的话也尽量限制在自有域名范围内，例如https://*.yourcompany.com。

4. 微信小程序访问存储桶资源跨域怎么配置？

首先需要在微信公众平台的「开发管理-开发设置」里，将七彩云存储桶的域名添加到「合法域名」列表的downloadFile和uploadFile分类下，然后在七彩云跨域配置页添加小程序的业务域名作为来源，勾选对应的请求方法即可正常访问。

八、总结

整个跨域配置流程只需要三步：首先登录七彩云控制台进入内容增长站的目标存储桶详情页，然后找到权限管理下的跨域资源共享配置入口，最后按照业务需求填写跨域规则保存即可完成。建议生产环境尽量最小化放行的来源域名和请求方法，降低安全风险，配置完成后可通过浏览器开发者工具的网络面板验证请求是否正常。如果需要批量配置或者和现有S3系统对接，可直接使用七彩云兼容S3的接口实现快速迁移，无需额外改造，更多配置说明可前往七彩云官网（https://https://www.7caiyun.com）查看官方文档或咨询客服。