如何正确配置NGINX实现跨域请求？

EZHJ • 2024-10-04 00:17 • 编程

跨域请求是指一个页面的文档、脚本、图片或其他资源，从不同的域名、端口或协议发起请求。这种需要跨域请求的场景日益增加，比如前后端分离的项目中，前端用Vue、React等框架进行开发，而后端用Java、PHP等语言进行开发。在这种情况下，前后端的域名往往是不同的，因此就需要实现跨域请求。

一、添加响应头

在 NGINX 中，可以使用 add_header 指令来添加响应头，实现跨域请求。例如，以下代码将在响应头中添加 Access-Control-Allow-Origin 字段，允许所有跨域请求的来源，即“*”：

server {
    listen 80;
    server_name example.com;
    add_header 'Access-Control-Allow-Origin' '*' always;
    ...
}

在 add_header 指令中，’Access-Control-Allow-Origin’ 表示要添加的响应头字段，’*’ 表示允许所有来源跨域请求，always 表示将该响应头添加到所有响应中。

另外，当需要支持带有认证信息的跨域请求时，需要将 ‘Access-Control-Allow-Origin’ 的值设置为请求域的完整 URL，而不是“*”。这样做可以提高安全性，避免信息泄露。

二、使用 NGINX 反向代理

NGINX 可以作为反向代理服务器，将请求转发给其他域名的服务器。这样做可以避免跨域请求，但仅适用于同一协议的情况。例如，以下代码将把以 /api 开头的请求转发给另一个域名的服务器：

server {
    listen 80;
    server_name example.com;
    location /api {
        proxy_pass http://api.example.com;
    }
    ...
}

在这个示例中，以 /api 开头的请求会被 NGINX 转发给 http://api.example.com。使用这种方法实现跨域请求需要保证转发的目标域名是可信的，否则存在安全风险。

三、使用 NGINX Lua 模块

NGINX Lua 模块是一个开源的扩展模块，可以通过编写 Lua 脚本实现跨域请求。例如，以下代码将处理以 /api 开头的请求，添加响应头，并将响应体中含有 id 字段的 JSON 数据转换为大写字母：

server {
    listen 80;
    server_name example.com;
    location /api {
        header_filter_by_lua_block {
            ngx.header.content_type = 'application/json'
            ngx.header.access_control_allow_origin = '*';
        }

        content_by_lua_block {
            local json = require('cjson')
            local data = {id = 1234, name = 'John'}
            local str = json.encode(data)
            ngx.say(string.upper(str))
        }
    }
    ...
}

在这个示例中，header_filter_by_lua_block 以 Lua 语言编写的脚本，用于添加响应头；content_by_lua_block 也是以 Lua 语言编写的脚本，用于处理响应体。使用这种方法的好处是可以灵活地控制跨域请求的处理过程，但需要对 Lua 语言有一定的了解。

四、使用 NGINX 自带的模块

NGINX 自带的模块也可以实现跨域请求。例如，以下代码将在 /api 接口的响应头中添加允许跨域请求的字段：

server {
    listen 80;
    server_name example.com;
    location /api {
        add_header 'Access-Control-Allow-Origin' '*' always;
        ...
    }
    ...
}

这种方法相对比较简单，但只能实现基本的跨域请求，不能满足更复杂的需求。

五、总结

以上是实现跨域请求的几种方法，它们分别适用于不同的场景，并且有各自的优缺点。在实际开发中，需要根据项目的具体情况选择合适的方法，以达到较好的效果。

原创文章，作者：EZHJ，如若转载，请注明出处：https://www.506064.com/n/137440.html