nginx配置vue前端代理

最新推荐文章于 2025-06-08 17:02:53 发布

原创最新推荐文章于 2025-06-08 17:02:53 发布 · 8.5k 阅读

30 ·

CC 4.0 BY-SA版权

前端开发、vue 同时被 2 个专栏收录

12 篇文章

订阅专栏

nginx

1 篇文章

订阅专栏

本文详细介绍了在Vue项目中如何配置Nginx解决跨域问题，包括开发阶段的vue.config.js代理配置，以及部署阶段Nginx的代理配置调整。同时，文章还解决了浏览器刷新导致的404问题，提供了有效的try_files和rewrite解决方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

背景：做一个前后端分离的项目，使用vue-cli创建的前端项目，在前端配置跨域请求。
一、开发阶段
在vue.config.js中配置devserver的proxy进行代理请求配置，然后将所有请求改为/api开头的即可。但是这样配置只在开发阶段起作用。所以在nginx上部署的时候，需要再重新配置请求代理。
vue.config.js中代码配置如下：

// 相当于webpack-dev-server，对本地服务器进行配置 
    devServer: {
        port:8089, // 启动端口
        open:true,  // 启动后是否自动打开网页
        proxy: {
            "/api": {
                target: "http://192.168.xx.xx:8083", // 如果访问/api就在其前面加target
                changeOrigin: true, // 跨域
                pathRewrite: {
                    "^/api": '' //再把访问路径中的/api替换掉
                }
            }
        }
    },

二、nginx配置代理
因为第一次自己配置nginx(之前都是打包交给后端配置)，所以在网上搜索方案，大致一看很简单。于是在nginx.config中做了如下配置：

server {
        listen       8001;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }
		
		location /api {
            proxy_pass http://192.168.xx.xxx:8083;
        }

大致一看是没有问题。可是，请求后端接口发送会报404错误。结果百思不得其解，只能百度百度再百度。最后，在 /api 和其代理的路径后面加上一个 / 就好了。虽然说的轻松，但是，在自己试的时候，真的是有点难受。配置文件，不要放过哪怕一个斜杠。
正确配置如下：

    server {
        listen       8001;
        server_name  localhost;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;

        location / {
            root   html;
            index  index.html index.htm;
        }
		
		location /api/ {
            proxy_pass http://192.168.31.126:8083/;
        }

三、解决刷新浏览器问题。
配置完上述配置后发现，点击浏览器刷新按钮，会出现无法404页面，无法返回原网页的问题。如图：
在这里插入图片描述
需要进行如下配置：

location / {
            root   html;
            index  index.html index.htm;
			
			# 方便界面文件路径查找
			try_files $uri $uri/ @router; 
            index  index.html ;
        }
#因此需要rewrite到index.html中，然后交给路由在处理请求资源
     location @router {
         rewrite ^.*$ /index.html break;
     }

四、匹配文件路径
1.如果vue-router使用hash模式，则可以在vue.config.js中设置publicPath 为空字符串 (’’) 或是相对路径 (’./’)，这样所有的资源都会被链接为相对路径，这样打出来的包可以被部署在任意路径。
2.如果使用history模式，在生产环境静态资源(打包成chunk的js和css)都链接为 '/'绝对路径，此时直接点击index.html找不到资源，需要使用nginx配合。

location / {
            root   html;
            index  index.html index.htm;
			
			# 方便界面文件路径查找
			try_files $uri $uri/ @router; 
            index  index.html ;
        }

其实此时的配置没起作用，因为资源默认在服务器的根目录下。但是当nginx代理多个服务，且html中的文件结构相对复杂的时候需要进行try_files的相对配置。
五、注意
尽管你配置代理了，但是network中显示的始终是配置之前的路由地址(一般是localhost)。所以很容易会误导新手！不过只要下功夫分析，没有处理不了的问题。

PS：vue项目中引入静态资源文件(如打印机的配置文件.lbx)，应该放在public目录下的static文件夹下。打包后，也会出现在输出文件夹(dist)中的static文件夹下（默认的，可以使用webpack来配置）。代码中使用location.origin拼接static文件夹下路径，即可引入