在 linux 中配置 nginx 实现跨域请求的代理转发，核心做法是在 `location` 块中使用 `proxy_pass` 指令将请求转发给后端服务，并配合 `add_header` 指令动态设置 cors 响应头。这样做可以让浏览器认为请求是同源的，从而绕过同源策略限制。需要注意的是，对于非简单请求（如包含自定义 header 的请求），nginx 必须正确处理 options 预检请求，否则会导致跨域失败。
Nginx 如何处理简单的 GET/POST 跨域请求
Nginx 处理简单跨域请求时，只需在反向代理配置中添加允许的来源、方法和头部信息即可。当浏览器发起 GET 或 POST 请求时，Nginx 会直接转发请求到后端，并在返回响应时附加 CORS 头。这种场景下不需要额外的逻辑判断，配置最为简单。
server {
listen 80;
server_name api.example.com;
location /api/ {
# 转发到后端服务
proxy_pass http://backend_service:8080/;
# 设置 CORS 响应头
add_header 'Access-Control-Allow-Origin' '$http_origin' always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range' always;
# 缓存预检结果
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Content-Type' 'text/plain; charset=utf-8';
add_header 'Content-Length' 0;
}
}
上述配置中，`$http_origin` 变量用于回显请求中的 Origin，确保只允许特定的来源访问。`always` 参数确保无论 HTTP 状态码如何，响应头都会发送。对于 GET 和 POST 请求，Nginx 会自动处理转发，无需额外配置。
Nginx 如何处理 OPTIONS 预检请求
对于包含自定义 Header 或特定 Content-Type 的请求，浏览器会先发送一个 OPTIONS 请求进行预检。Nginx 需要识别这些请求并直接返回 204 No Content 状态码，而不将其转发给后端。这可以避免后端服务因不支持 OPTIONS 方法而报错，同时满足浏览器的安全要求。
server {
listen 80;
server_name api.example.com;
location /api/ {
# 处理 OPTIONS 预检请求
if ($request_method = 'OPTIONS') {
add_header 'Access-Control-Allow-Origin' '$http_origin' always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range' always;
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Content-Type' 'text/plain; charset=utf-8';
add_header 'Content-Length' 0;
return 204;
}
# 转发实际请求
proxy_pass http://backend_service:8080/;
add_header 'Access-Control-Allow-Origin' '$http_origin' always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range' always;
}
}
在这个配置中，`if ($request_method = 'OPTIONS')` 块专门处理预检请求。它返回 204 状态码，表示预检通过，浏览器随后会发起实际的 GET 或 POST 请求。注意，`if` 指令在 Nginx 中需谨慎使用，因为它可能影响性能，但在 CORS 场景中是标准做法。实际请求部分仍需添加 CORS 头，以确保后续请求也能被浏览器接受。
proxy_pass 路径重写对跨域请求的影响
当 `proxy_pass` 配置中包含 URI 路径时，Nginx 会将匹配到的 URI 部分替换为指定的路径。例如，如果 `location /api/` 匹配到 `/api/users`，且 `proxy_pass http://backend:8080/`，则实际转发给后端的 URL 是 `http://backend:8080/users`。这种路径重写行为可能导致后端服务接收到的路径与预期不符，进而引发 404 错误。因此，必须确保 `proxy_pass` 的目标路径与后端服务的接口定义一致。
