CORS 配置生成器

填写允许跨域访问的来源和规则,生成常用服务器、后端框架和对象存储的跨域配置,并检查常见的配置错误。

允许的方法

配置 CORS 的要点

  • 携带凭证不能用 *:前端设置了 credentials: 'include' 或 withCredentials 时,Access-Control-Allow-Origin 必须是具体的来源,不能是 *,同时需要返回 Access-Control-Allow-Credentials: true。
  • 多个来源:Access-Control-Allow-Origin 只能写一个来源,需要允许多个域名时,服务器要判断请求的 Origin 是否在白名单中再原样返回,并加上 Vary: Origin,避免 CDN 缓存串用。
  • 预检请求:非简单请求(如 PUT、DELETE,或带 Authorization、JSON 的 Content-Type)会先发送 OPTIONS 预检,服务器需要返回 2xx 和允许的方法、请求头。
  • 来源格式:来源由协议、域名和端口组成,末尾不带斜杠,http 和 https、不同端口都算不同的来源;*.example.com 不包含 example.com 本身,需要时单独添加。
  • 错误响应也要带头:Nginx 的 add_header 需要加 always,否则 4xx、5xx 响应不带跨域头,前端只能看到跨域错误而看不到真正的原因。

排查浏览器控制台的跨域报错请用 CORS 跨域调试器,生成其他安全响应头请用 安全响应头配置生成器。

CORS 配置生成器常见问题

CORS 配置生成器怎么使用?

每行填写一个允许的来源(可以使用 https://*.example.com 匹配子域名),勾选允许的方法,填写允许的请求头、暴露的响应头、预检缓存时间和路径,选择是否允许携带凭证;在下拉框中选择服务器、框架或对象存储,复制生成的配置。

怎么允许多个域名跨域?

把来源逐行填入白名单,配置会判断请求的 Origin 并原样返回。

携带 Cookie 时为什么不能用 *?

浏览器规定携带凭证时必须返回具体的来源。

*.example.com 包括 example.com 吗?

不包括,需要单独添加。

OSS 跨域怎么设置?

选择阿里云 OSS / 腾讯云 COS,按生成的规则在控制台填写。

CORS 配置生成器的结果应怎样理解?

生成的是常用写法,具体版本的语法可能略有差别,部署前请在测试环境验证;对象存储不支持携带凭证的设置;IIS 需要安装 CORS 模块。

输入内容会保存或发给外部服务吗?

在浏览器本地生成,不收集数据。

没有结果或操作失败时先检查什么?

配置后仍报跨域错误时,用浏览器开发者工具查看预检请求的响应头,或使用 CORS 跨域调试器逐项检查。

相关工具

Bcrypt 加密与校验 · Cookie 解析器 · CSP 策略生成器 · HTTP 响应头分析器 · 全部安全工具