本文主要是介绍从零手写实现 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这样的机制,任何图书馆的人都可以随意去其他图书馆借书,这可能会导致一些问题:
隐私问题:图书馆的书籍可能包含敏感信息,不应该被未经授权的人访问。
安全问题:如果有人恶意访问图书馆,可能会造成书籍损坏或信息泄露。
管理问题:图书馆需要能够控制谁可以借阅书籍,以及借阅的条件。
通过CORS,网站可以明确哪些外部网站是可信的,并且可以设置规则来控制它们如何访问资源。
这样,既保护了网站的资源不被滥用,又允许了安全的跨网站交互,比如社交媒体登录、API调用等。
简而言之,CORS是网络安全和资源共享之间的一个平衡点。
开发过程中遇到了 CORS 限制,如何解决?
遇到CORS(跨源资源共享)限制时,通常有以下几种解决方法,分别针对后端、前端和浏览器:
后端解决方法
设置Access-Control-Allow-Origin响应头: 在服务器响应中添加
Access-Control-Allow-Origin
头,指定允许访问的源。例如,如果你想允许所有源访问你的资源,可以设置为*
(不推荐,因为不安全):Access-Control-Allow-Origin: *
或者指定具体的源:
Access-Control-Allow-Origin: https://www.example.com
处理预检请求(Preflight Request): 对于某些类型的请求,浏览器会先发送一个预检请求(OPTIONS请求),询问服务器是否允许实际的请求。服务器需要正确响应这个OPTIONS请求,并在响应中包含必要的CORS头信息。
设置其他CORS相关的响应头:
Access-Control-Allow-Methods
:指定允许的HTTP方法,如GET, POST等。Access-Control-Allow-Headers
:指定允许的自定义请求头。Access-Control-Allow-Credentials
:如果需要携带凭证(如cookies),则需要设置为true
。Access-Control-Max-Age
:指定预检请求的缓存时间。
前端解决方法
使用代理服务器:
在开发过程中,可以通过设置一个代理服务器来绕过CORS限制。
例如,使用Webpack的devServer.proxy配置或Node.js的http-proxy-middleware。
使用CORS代理服务: 对于一些简单的请求,可以使用公共的CORS代理服务,如
https://cors-anywhere.herokuapp.com/
。同源策略: 确保前端应用和后端服务部署在同一源(相同的协议、域名和端口)。
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 cookies
和 Cookies without SameSite must be secure
选项来解决[^3^]。
其他方式:
使用Chrome扩展: 安装一些允许CORS的Chrome扩展,如
Allow CORS: Access-Control-Allow-Origin
。开发者工具中的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 配置文件的适当位置,通常是在server
或location
块中。 - 根据你的应用需求,可能需要调整
Access-Control-Allow-Methods
和Access-Control-Allow-Headers
的值。 - 如果你的应用需要处理预检请求,确保正确配置
OPTIONS
请求的处理。 - 重启 Nginx 服务以使配置更改生效。
通过这些配置,Nginx 可以支持跨源资源共享,从而允许前端应用从不同的源安全地请求后端服务。
小结
本节我们实现了 cors,这个对于浏览器安全和日常开发帮助比较大。
我们给出了常见的解决方案,不过实际生产注意使用安全。
下一节,我们考虑实现一下 cors 的支持。
我是老马,期待与你的下次重逢。
开源地址
为了便于大家学习,已经将 nginx 开源
https://github.com/houbb/nginx4j
这篇关于从零手写实现 nginx-19-HTTP CORS(Cross-Origin Resource Sharing,跨源资源共享)介绍+解决方案的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!