nginx

关注公众号 jb51net

关闭
首页 > 网站技巧 > 服务器 > nginx > nginx代理前端请求

nginx代理前端请求的实现示例

作者:dangfulin

本文介绍了在Vue3项目中使用Axios调用后端接口,并通过Nginx进行反向代理以解决跨域问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

一,项目配置

我在 ip 为 192.168.31.177 的机器上使用 vue3 开发前端项目,项目中使用 axios 调用后端接口。

这是 axios 的配置:

import axios from 'axios';

const request = axios.create({
    baseURL: 'http://192.168.31.177:8001',
    // 设置请求头
    headers: {},
    // 设置超时时间
    timeout: 2000,
});


// 请求拦截器
request.interceptors.request.use(
    config => {
        // 在发送请求之前做些什么

        return config;
    },
    error => {
        // 对请求错误做些什么
        return Promise.reject(error);
    }
);

// 响应拦截器
request.interceptors.response.use(
    response => {
        if (response) {
            // 响应数据为二进制流处理(数据导出)
            if (response.data.data instanceof Blob) {
                return response
            }

            const {code, msg} = response.data
            if (code === 200) {
                return Promise.resolve(response.data)
            } else {
                return Promise.resolve(response)
            }
        } else {
            return Promise.reject(new Error('系统出错'))
        }
    },

    function (error) {
        // 对响应错误做点什么

        // 比如:根据响应状态码,做不同的响应处理
        console.log(error)
        return Promise.reject(error)
    }
)

export default request

这是页面中的请求:

axios.get('/api/getNumbers')
        .then(res => {
            ElMessage({
                message: res.msg,
                type: 'success'
            })
        }).catch(err => {
            ElMessage({
                message: err,
                type: 'error'
            })
        })

这是 package.json 中的配置:

  "scripts": {
    "dev": "vite --host 192.168.31.177",
    "build": "vite build",
    "preview": "vite preview"
  }

然后在 ip 为 192.168.31.45 的机器上启动 expressjs 开发的后端项目 192.168.31.45:3000:

app.get('/api/getNumbers', (req, res) => {
    // 生成两个随机数
    const number1 = Math.floor(Math.random() * 100);
    const number2 = Math.floor(Math.random() * 100);
    res.json({
        code: 200,
        msg: '成功!',
        data: {
            "a": number1,
            "b": number2,
        }
    });
});

现在想使用 nginx 将前端的请求代理到后端,下面将介绍 nginx 需要怎样配置以及具体原理。

二,配置 nginx

前端项目运行在 192.168.31.177(开发机器),后端运行在 192.168.31.45:3000,Nginx 需要配置为反向代理,将前端请求转发到后端。

在开发机器(192.168.31.177)上 Nginx 的配置文件(nginx.conf):

http {
    server {
        listen 8001;                # Nginx 监听的端口,前端 axios 中配置的 端口
        server_name 192.168.31.177; # 前端 axios 中配置的 IP

        location / {
            try_files $uri $uri/ /index.html; # 支持Vue路由的history模式
        }

        # 代理后端API请求
        location /api {
            proxy_pass http://192.168.31.45:3000;	# 后端项目运行的地址

            # 可选:如果后端接口路径不包含/api,移除前缀
            # rewrite ^/api/(.*) /$1 break;

            # 添加必要的代理头信息
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

配置完成后执行:

G:\nginx-1.24.0>nginx -t		 # 检查配置语法
nginx: the configuration file G:\nginx-1.24.0/conf/nginx.conf syntax is ok
nginx: configuration file G:\nginx-1.24.0/conf/nginx.conf test is successful

G:\nginx-1.24.0>start nginx		# 启动nginx

G:\nginx-1.24.0>nginx -s reload # 不停止,重新加载

启动前端项目,访问 http://192.168.31.177:5173/。打开页面后调用接口,获取到接口数据。

三,Nginx 代理原理

反向代理的作用:

请求转发:Nginx 监听前端请求(如 http://192.168.31.177:8080/api/getNumbers),并将匹配 /api 的请求转发到后端服务器 http://192.163.109.134:3000。

隐藏后端细节:前端无需知道后端地址,只需与 Nginx 通信。

解决跨域:浏览器认为请求是同源的(都是 http://192.168.31.177:8080),实际由 Nginx 转发到不同域的后端。

关键配置解释

location /api:匹配所有以 /api 开头的请求路径。

proxy_pass:将匹配的请求转发到后端服务器。

proxy_set_header:设置请求头,确保后端能获取客户端的真实 IP 和协议信息。

add_header:添加 CORS 响应头,显式允许跨域(可选,如果代理已解决跨域,可能不需要)。

为什么这样配置?

  1. 解决跨域问题:浏览器默认禁止跨域请求,但通过 Nginx 代理:前端请求发送到 http://192.168.31.177:8080/api(同源)。Nginx 将请求转发到 http://192.163.109.134:3000/api,后端响应通过 Nginx 返回前端。浏览器认为请求是“同源”的,不会触发跨域限制。
  2. 灵活的路由控制:可以按路径(如 /api)或域名分发请求。
  3. 支持负载均衡、缓存等高级功能(开发阶段可能不需要)。
  4. 统一入口:前端和后端通过同一个端口(如 8080)通信,简化开发配置。

验证配置是否生效:

  1. 在浏览器中访问后端 API http://192.163.109.134:3000/api/getNumbers,确保后端正常返回数据。
  2. 通过 Nginx 访问 API http://192.168.31.177:8080/api/getNumbers,检查是否返回相同数据。
  3. 检查看 Nginx 的访问日志和错误日志,确认请求是否被正确转发。
  4. Nginx 未启动或配置错误问题排查
    status nginx 检查服务状态。
    nginx -t 检查配置语法。
    

到此这篇关于nginx代理前端请求的实现示例的文章就介绍到这了,更多相关nginx代理前端请求内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:
阅读全文