1. 理解 CORS 和同源策略1.1 同源策略同源策略是一种浏览器安全机制用于阻止不同源不同域名、协议或端口的 Web 应用相互访问数据。它确保了 Web 应用的隔离性防止恶意网站访问用户数据或执行不安全的操作。同源策略下同一个域相同的协议、域名和端口内的资源可以自由访问。但如果协议、域名或端口有任何不同浏览器会阻止这种访问。1.2 跨域资源共享 (CORS)CORSCross-Origin Resource Sharing跨域资源共享是 W3C 标准用于解决跨域访问问题。通过 CORS服务器可以声明哪些来源的请求是被允许的以及允许客户端通过哪些 HTTP 方法和头部进行访问。CORS 的实现依赖于服务器返回的特定 HTTP 头信息这些头信息指导浏览器允许或拒绝特定的跨域请求。2. Nginx 解决跨域问题的基本原理Nginx 可以通过配置 HTTP 响应头来支持 CORS。这些头信息包括Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers和Access-Control-Allow-Credentials等。通过在 Nginx 中配置这些头信息可以允许特定的域、方法和头部进行跨域访问。3. 配置 Nginx 解决跨域问题下面是如何在 Nginx 中配置 CORS 的具体步骤。3.1 基础配置假设我们有一个 API 服务器域名为api.example.com需要允许来自www.example.com的前端应用进行跨域请求。首先找到或创建 Nginx 的配置文件通常位于/etc/nginx/nginx.conf或/etc/nginx/conf.d/目录中然后在需要跨域的服务器块server块或位置块location块中添加 CORS 相关的头部配置。server { listen 80; server_name api.example.com; location / { # 设置允许跨域的域名可以使用通配符 * 允许所有域访问 add_header Access-Control-Allow-Origin http://www.example.com; # 设置允许的 HTTP 方法 add_header Access-Control-Allow-Methods GET, POST, OPTIONS, DELETE, PUT; # 设置允许的请求头 add_header Access-Control-Allow-Headers Authorization, Content-Type, Accept, Origin, X-Requested-With; # 如果需要支持 cookie可以设置以下 header add_header Access-Control-Allow-Credentials true; # 如果是预检请求OPTIONS 请求则直接返回 204 状态码 if ($request_method OPTIONS) { return 204; } # 其他正常请求的处理逻辑 proxy_pass http://backend_server; } }3.2 关键配置项详解Access-Control-Allow-Origin指定允许跨域请求的来源。可以设置为具体的域名如http://www.example.com或使用通配符*允许所有来源。使用通配符时不允许设置Access-Control-Allow-Credentials为true。Access-Control-Allow-Methods指定允许的 HTTP 请求方法如GET、POST、OPTIONS、PUT、DELETE等。可以根据实际需要设置。Access-Control-Allow-Headers指定允许客户端发送的自定义 HTTP 头部如Authorization、Content-Type等。此配置项通常用于支持复杂请求带自定义头部的请求。Access-Control-Allow-Credentials如果客户端请求包括凭据如 Cookies则该选项必须设置为true。注意此时Access-Control-Allow-Origin不能为*必须为具体的域名。预检请求的处理浏览器在发送某些复杂请求之前会发送一个OPTIONS请求进行预检询问服务器是否允许该请求。Nginx 可以在检测到OPTIONS请求时直接返回状态码204表示请求被允许但不包含任何内容。3.3 配置通配符在某些场景中如果需要允许所有域访问即不限制跨域请求的来源可以将Access-Control-Allow-Origin设置为*add_header Access-Control-Allow-Origin *;需要注意的是使用通配符时不能同时启用Access-Control-Allow-Credentials否则浏览器会拒绝请求。3.4 动态设置 CORS 头如果需要根据请求动态设置Access-Control-Allow-Origin可以使用$http_origin变量来匹配请求来源。例如location / { if ($http_origin ~* https?://(www.)?(example1.com|example2.com)) { add_header Access-Control-Allow-Origin $http_origin; add_header Access-Control-Allow-Credentials true; add_header Access-Control-Allow-Methods GET, POST, OPTIONS; add_header Access-Control-Allow-Headers Authorization, Content-Type, Accept; } if ($request_method OPTIONS) { return 204; } proxy_pass http://backend_server; }这种配置可以在满足特定条件时动态地允许多个域名进行跨域访问。4. 预检请求与 OPTIONS 方法的处理预检请求是 CORS 规范中定义的一种机制用于在实际请求之前探测服务器是否允许某个跨域请求。浏览器在发送某些复杂请求时会首先发送一个OPTIONS请求询问服务器是否允许该请求。Nginx 可以通过简单的配置处理这种预检请求if ($request_method OPTIONS) { add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods GET, POST, OPTIONS, PUT, DELETE; add_header Access-Control-Allow-Headers Authorization, Content-Type, Accept, Origin, X-Requested-With; return 204; }这段配置会在收到OPTIONS请求时返回一个204 No Content响应并带有必要的 CORS 头部信息表明服务器允许接下来的实际请求。5. 实践中的注意事项5.1 安全性考虑虽然 CORS 是解决跨域问题的有效手段但不应随意允许所有域访问即设置Access-Control-Allow-Origin为*。这种配置可能会引发安全隐患因为任何来源的脚本都可以访问资源。因此在配置时应明确指定允许的来源并严格控制跨域访问的权限。5.2 性能优化CORS 请求处理会增加服务器的负载特别是在预检请求频繁的情况下。为了减少性能开销可以通过以下方法进行优化启用缓存通过设置Access-Control-Max-Age头可以让浏览器缓存预检请求的结果减少实际请求前的预检次数。合并请求在可能的情况下减少跨域请求的数量避免不必要的预检请求。5.3 配置管理在生产环境中管理 Nginx 配置时建议将 CORS 相关的配置与其他配置分开管理。例如可以在 Nginx 的配置文件中创建一个单独的文件来管理 CORS 配置并在需要的server或location块中包含此文件include /etc/nginx/cors.conf;这种方式可以使配置更清晰、更易于管理。6. 示例场景与配置示例6.1 单页应用与 API 后端假设有一个单页应用SPA部署在www.example.com它通过 Ajax 请求从api.example.com获取数据。Nginx 的配置可以如下server { listen 80; server_name api.example.com; location /api/ { add_header Access-Control-Allow-Origin http://www.example.com; add_header Access-Control-Allow-Methods GET, POST, OPTIONS; add_header Access-Control-Allow-Headers Authorization, Content-Type; if ($request_method OPTIONS) { return 204; } proxy_pass http://backend_api_server; } }6.2 支持多个域名的跨域访问如果需要支持来自多个域名的跨域请求例如www.example1.com和www.example2.com可以使用如下配置location /api/ { if ($http_origin ~* https?://(www.example1.com|www.example2.com)) { add_header Access-Control-Allow-Origin $http_origin; add_header Access-Control-Allow-Credentials true; add_header Access-Control-Allow-Methods GET, POST, OPTIONS; add_header Access-Control-Allow-Headers Authorization, Content-Type; } if ($request_method OPTIONS) { return 204; } proxy_pass http://backend_api_server; }7. 总结通过 Nginx 配置 CORS 头部信息可以有效解决前端跨域问题允许前端应用从不同的域名、协议或端口请求资源。在配置过程中需要仔细考虑安全性、性能优化和管理的易用性以确保跨域请求的安全和高效处理。Nginx 强大的配置能力使其能够灵活应对各种跨域需求为前端应用提供强有力的支持。