从零手写实现 nginx-19-HTTP CORS(Cross-Origin Resource Sharing,跨源资源共享)介绍+解决方案

前言

大家好,我是老马。很高兴遇到你。

我们为 java 开发者实现了 java 版本的 nginx

https://github.com/houbb/nginx4j

如果你想知道 servlet 如何处理的,可以参考我的另一个项目:

手写从零实现简易版 tomcat minicat

手写 nginx 系列

如果你对 nginx 原理感兴趣,可以阅读:

从零手写实现 nginx-01-为什么不能有 java 版本的 nginx?

从零手写实现 nginx-02-nginx 的核心能力

从零手写实现 nginx-03-nginx 基于 Netty 实现

从零手写实现 nginx-04-基于 netty http 出入参优化处理

从零手写实现 nginx-05-MIME类型(Multipurpose Internet Mail Extensions,多用途互联网邮件扩展类型)

从零手写实现 nginx-06-文件夹自动索引

从零手写实现 nginx-07-大文件下载

从零手写实现 nginx-08-范围查询

从零手写实现 nginx-09-文件压缩

从零手写实现 nginx-10-sendfile 零拷贝

从零手写实现 nginx-11-file+range 合并

从零手写实现 nginx-12-keep-alive 连接复用

从零手写实现 nginx-13-nginx.conf 配置文件介绍

从零手写实现 nginx-14-nginx.conf 和 hocon 格式有关系吗?

从零手写实现 nginx-15-nginx.conf 如何通过 java 解析处理?

从零手写实现 nginx-16-nginx 支持配置多个 server

从零手写实现 nginx-17-nginx 默认配置优化

从零手写实现 nginx-18-nginx 请求头+响应头操作

从零手写实现 nginx-19-nginx cors

从零手写实现 nginx-20-nginx 占位符 placeholder

从零手写实现 nginx-21-nginx modules 模块信息概览

从零手写实现 nginx-22-nginx modules 分模块加载优化

从零手写实现 nginx-23-nginx cookie 的操作处理

从零手写实现 nginx-24-nginx IF 指令

HTTP CORS 是什么?

HTTP CORS(Cross-Origin Resource Sharing,跨源资源共享)是一种安全机制,它允许一个网页(运行在浏览器中的网页)去请求另一个不同源(域名、协议或端口不同)的资源。

想象一下,互联网上的每个网站都有自己的“家”,并且通常只能访问自己家里的东西。

但是,有时候一个网站需要访问另一个网站的数据或资源,比如图片、视频或API。如果没有CORS,这种访问是不被允许的,因为浏览器出于安全考虑会阻止这种跨源请求。

CORS机制允许网站“告诉”浏览器,它信任哪些外部网站,并允许它们访问自己的资源。

这样,当一个网站请求另一个网站资源时,浏览器会检查这个请求是否被允许。如果允许,浏览器就会允许这次请求,否则会阻止。

简单来说,CORS就像是一个“通行证”,它让不同的网站之间可以安全地共享资源。

为什么需要 HTTP CORS?

HTTP CORS(跨源资源共享)之所以需要,主要是为了保护用户和网站数据的安全,同时也提供了一种机制来允许安全地跨网站访问资源。

为什么需要CORS:

想象一下,你有一个自己的图书馆(网站A),而你的朋友有一个不同的图书馆(网站B)。通常,你只能借阅你自己图书馆里的书籍,不能直接去朋友图书馆借书。这是因为每个图书馆都有自己的规则和隐私政策,它们不希望其他人随意访问自己的书籍。

但是,有时候你需要借阅朋友图书馆里的一本书,这时候就需要一种机制来确保这个过程是安全的。CORS就相当于是一张“借书证”,它允许你的朋友图书馆知道你想要借书,并且决定是否允许你借阅。

如果没有CORS这样的机制,任何图书馆的人都可以随意去其他图书馆借书,这可能会导致一些问题:

  1. 隐私问题:图书馆的书籍可能包含敏感信息,不应该被未经授权的人访问。

  2. 安全问题:如果有人恶意访问图书馆,可能会造成书籍损坏或信息泄露。

  3. 管理问题:图书馆需要能够控制谁可以借阅书籍,以及借阅的条件。

通过CORS,网站可以明确哪些外部网站是可信的,并且可以设置规则来控制它们如何访问资源。

这样,既保护了网站的资源不被滥用,又允许了安全的跨网站交互,比如社交媒体登录、API调用等。

简而言之,CORS是网络安全和资源共享之间的一个平衡点。

开发过程中遇到了 CORS 限制,如何解决?

遇到CORS(跨源资源共享)限制时,通常有以下几种解决方法,分别针对后端、前端和浏览器:

后端解决方法

  1. 设置Access-Control-Allow-Origin响应头
    在服务器响应中添加Access-Control-Allow-Origin头,指定允许访问的源。例如,如果你想允许所有源访问你的资源,可以设置为*(不推荐,因为不安全):

    Access-Control-Allow-Origin: *
    

    或者指定具体的源:

    Access-Control-Allow-Origin: https://www.example.com
    
  2. 处理预检请求(Preflight Request)
    对于某些类型的请求,浏览器会先发送一个预检请求(OPTIONS请求),询问服务器是否允许实际的请求。服务器需要正确响应这个OPTIONS请求,并在响应中包含必要的CORS头信息。

  3. 设置其他CORS相关的响应头

    • Access-Control-Allow-Methods:指定允许的HTTP方法,如GET, POST等。
    • Access-Control-Allow-Headers:指定允许的自定义请求头。
    • Access-Control-Allow-Credentials:如果需要携带凭证(如cookies),则需要设置为true
    • Access-Control-Max-Age:指定预检请求的缓存时间。

前端解决方法

  1. 使用代理服务器

    在开发过程中,可以通过设置一个代理服务器来绕过CORS限制。

    例如,使用Webpack的devServer.proxy配置或Node.js的http-proxy-middleware。

  2. 使用CORS代理服务
    对于一些简单的请求,可以使用公共的CORS代理服务,如https://cors-anywhere.herokuapp.com/

  3. 同源策略
    确保前端应用和后端服务部署在同一源(相同的协议、域名和端口)。

Chrome 浏览器解决方法

老马推荐直接修改启动参数:

修改启动参数

你可以使用 --disable-web-security 参数来启动 Chrome,这样可以禁用浏览器的同源策略和 CORS 安全特性,从而允许跨域请求。

例如,可以在命令行中使用以下参数来启动 Chrome:

chrome.exe --user-data-dir="D://Chrome dev session" --disable-web-security

此外,还可以通过设置 --args 参数来实现类似的效果,如搜索结果[3]所示:

--args --disable-web-security --user-data-dir=D:\HaoroomsChromeUserData

或者在 macOS 上使用以下命令:

open -n /Applications/Google\ Chrome.app/ --args --disable-web-security --user-data-dir=/Users/Eric/MyChromeDevUserData/

请注意,这些方法仅适用于开发环境,不推荐在生产环境中使用,因为这会降低浏览器的安全性。

此外,如果遇到跨域 cookies 问题,还可以通过访问 chrome://flags 并禁用 SameSite by default cookiesCookies without SameSite must be secure 选项来解决[3]。

其他方式:

  1. 使用Chrome扩展
    安装一些允许CORS的Chrome扩展,如Allow CORS: Access-Control-Allow-Origin

  2. 开发者工具中的CORS禁用

    在Chrome的开发者工具中,可以临时禁用CORS限制。

    但是,这种方法只适用于开发和测试,不应用于生产环境。

    • 打开Chrome的开发者工具。
    • 点击“Network”(网络)标签。
    • 在右侧的“Request Blocking”(请求拦截)部分,勾选“Disable cache”(禁用缓存)和“Disable CORS”(禁用CORS)。

注意

  • 安全考虑:在生产环境中,不建议使用通配符*来设置Access-Control-Allow-Origin,因为这可能会带来安全风险。
  • 预检请求:对于需要发送额外头信息(如自定义头)或使用非简单方法(如PUT、DELETE等)的请求,服务器必须正确处理OPTIONS预检请求。
  • 凭证支持:如果需要跨域请求时携带cookies或认证信息,确保服务器设置了Access-Control-Allow-Credentials: true,并且前端请求时需要使用withCredentials: true

通过上述方法,可以解决开发过程中遇到的CORS限制问题。

nginx 是如何支持 CORS 设置的?

Nginx 是一个流行的 Web 服务器和反向代理服务器,它可以通过配置文件来支持 CORS 设置。

以下是如何在 Nginx 配置文件中设置 CORS 的一些示例。

基本 CORS 设置

如果你想允许所有来源的跨域请求,可以在 Nginx 配置文件中添加以下行:

location / {
    add_header 'Access-Control-Allow-Origin' '*';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Max-Age' 1728000;
}

允许特定来源的 CORS 设置

如果只想允许特定的域名进行跨域请求,可以将 * 替换为具体的域名:

location / {
    add_header 'Access-Control-Allow-Origin' 'https://www.example.com';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Max-Age' 1728000;
}

处理预检请求

对于需要预检的请求(如带有自定义头或使用非简单HTTP方法的请求),Nginx 需要正确响应 OPTIONS 请求:

if ($request_method = 'OPTIONS') {
    add_header 'Access-Control-Allow-Origin' 'https://www.example.com';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization';
    add_header 'DAV' 1;
    return 204;
}

应用到特定路径

你可以将 CORS 设置应用到特定的路径或位置块:

location /api/ {
    add_header 'Access-Control-Allow-Origin' 'https://www.example.com';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Max-Age' 1728000;
}

注意事项

  • 确保 CORS 相关的 add_header 指令在 Nginx 配置文件的适当位置,通常是在 serverlocation 块中。
  • 根据你的应用需求,可能需要调整 Access-Control-Allow-MethodsAccess-Control-Allow-Headers 的值。
  • 如果你的应用需要处理预检请求,确保正确配置 OPTIONS 请求的处理。
  • 重启 Nginx 服务以使配置更改生效。

通过这些配置,Nginx 可以支持跨源资源共享,从而允许前端应用从不同的源安全地请求后端服务。

小结

本节我们实现了 cors,这个对于浏览器安全和日常开发帮助比较大。

我们给出了常见的解决方案,不过实际生产注意使用安全。

下一节,我们考虑实现一下 cors 的支持。

我是老马,期待与你的下次重逢。

开源地址

为了便于大家学习,已经将 nginx 开源

https://github.com/houbb/nginx4j

热门相关:煌煌天道无上剑宗   独步仙尘   重生后我嫁给厂公被宠上天   我的绝色美女房客   我的时光里,满满都是你