前后台Nginx部署同域名路径区分配置

 更新时间:2026年04月30日 09:47:55   作者:遇见火星  
前后台共用一个域名部署时,通过不同路径区分静态文件和API接口,适配VueRouter的历史模式,保证页面刷新和路由跳转正常,配置Nginx时注意路径匹配顺序,前端配置路径必须与Nginx配置一致,proxy_pass后缀不能删,前后端路径要对齐

这篇主要讲的是,前后台用同一个域名部署时,怎么通过不同路径来区分前台、后台的静态文件,还有API,应用程序编程接口)接口。另外也会适配Vue Router的history(历史)模式,保证页面刷新、路由跳转都正常,不报错。

1 Nginx 核心配置

server {
    listen 80;
    server_name nature.us.com;  # 把这个改成你自己的域名
    root /usr/local/nginx/html;
    # 前台静态文件配置(访问根路径就是前台)
    location / {
        root /usr/local/nginx/html/client;  # 前台文件存在这个文件夹里
        index index.html;
        try_files $uri $uri/ /index.html;  # 解决Vue Router的history(历史)模式刷新404的问题
    }
    # 后台静态文件配置(访问/manger路径就是后台)
    location /manger {
        alias /usr/local/nginx/html/manger;  # 后台文件存在这个文件夹里
        index index.html;
        try_files $uri $uri/ /manger/index.html;  # 后台也解决Vue Router的history(历史)模式刷新404的问题
    }
    # API(Application Programming Interface,应用程序编程接口)请求代理(访问/prod-api开头的路径,会转发到后端)
    location /prod-api/ {
        proxy_pass http://localhost:8080/;  # 改成你自己的后端服务地址,末尾的/千万别删
        proxy_set_header Host $host;  # Host(主机)请求头设置
        proxy_set_header X-Real-IP $remote_addr;  # X-Real-IP(真实IP)请求头设置
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # X-Forwarded-For(转发IP列表)请求头设置
        proxy_set_header X-Forwarded-Proto $scheme;  # X-Forwarded-Proto(协议类型)请求头设置
    }
}

2 Nginx 目录结构

下面是文件存放的目录结构,一看就懂:

nginx:
└── html:
    ├── client:  # 前台的静态文件都放这里,访问根路径就找这个文件夹
    └── manger:  # 后台的静态文件都放这里,访问/manger路径就找这个文件夹

3 前端配置(Vue 项目)

3.1 后台项目配置(访问路径带/manger前缀)

1. vue.config.js 配置(给后台路径加个统一前缀/manger,和Nginx配置对应上):

module.exports = {
  publicPath: "/manger", // 后台所有路径都加/manger前缀,和Nginx的/manger路径匹配
}

2. router.js 配置(去掉URL(Uniform Resource Locator,统一资源定位符)里的#,设置基础路径):

export default new Router({
  base: "/manger",  // 基础路径和上面的publicPath一样,都是/manger
  mode: "history",  // 去掉URL(Uniform Resource Locator,统一资源定位符)里的#,这个配置需要Nginx配合上面的try_files才能用
  scrollBehavior: () => ({ y: 0 }),
  routes: constantRoutes,
});

3.2 前台项目配置(API请求设置)

axios 配置(给API(Application Programming Interface,应用程序编程接口)请求加个前缀/prod-api,和Nginx的代理路径对应):

import axios from 'axios'
// 创建axios实例,设置请求基础路径
export const request = axios.create({
  baseURL: "/prod-api",  // 所有API(Application Programming Interface,应用程序编程接口)请求都带/prod-api前缀,和Nginx的/prod-api路径匹配
  timeout: 5000,  // 请求超时时间,5秒没响应就报错
  headers: {
    "Content-Type": "application/json",  // Content-Type(内容类型)请求头,设置为JSON格式
  },
});
// 请求拦截器(举个例子:给请求加Token(令牌),实现登录认证)
request.interceptors.request.use(
  (config) => {
    const token = localStorage.getItem("token");  // 从localStorage(本地存储)拿Token(令牌)
    if (token) {
      config.headers.Authorization = ` ${token}`;  // 把Token(令牌)放到Authorization(授权)请求头里传给后端
    }
    return config;
  },
  (error) => {
    return Promise.reject(error);  // Promise(承诺)是异步编程的解决方案,此处返回错误信息
  }
);
export default request;

4 配置说明(关键注意点,一定要看!)

  •  路径匹配顺序:Nginx是按location的配置顺序来匹配路径的,所以/manger(后台)和/prod-api(API,Application Programming Interface,应用程序编程接口)的配置,一定要放在/(前台)的前面。不然所有请求都会被根路径拦截,后台和API(Application Programming Interface,应用程序编程接口)就访问不到了。
  •  Vue history模式刷新404 :之所以加try_files配置,就是为了解决刷新页面报404的问题。前台要配成/index.html,后台要配成/manger/index.html,必须和前面设置的base路径一致,不然没用。这里的history指的是Vue Router的history(历史)模式。
  •  proxy_pass末尾的/别删:配置API(Application Programming Interface,应用程序编程接口)代理时,proxy_pass后面的地址(比如http://localhost:8080/),末尾的/一定要保留。如果删掉,Nginx会把/prod-api这个前缀一起传给后端,要是后端接口里没有/prod-api,请求就会报错。
  •  前后端路径要对齐:前端配置的publicPath、router.base,必须和Nginx里对应的location路径一致;axios的baseURL,也要和Nginx的API(Application Programming Interface,应用程序编程接口)代理路径一致。只要有一个对不上,就会出现访问不到页面、接口请求失败的问题。

到此这篇关于前后台Nginx部署同域名路径区分配置的文章就介绍到这了,更多相关Nginx同域名路径区分内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Nginx 访问 /root/下 403 Forbidden问题解决

    Nginx 访问 /root/下 403 Forbidden问题解决

    在使用Nginx作为Web服务器时,可能会遇到403 Forbidden错误,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-05-05
  • Linux下yum安装nginx教程

    Linux下yum安装nginx教程

    这篇文章主要介绍了Linux下yum安装nginx教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-02-02
  • 负载均衡下的webshell上传+nginx解析漏洞的过程

    负载均衡下的webshell上传+nginx解析漏洞的过程

    这篇文章主要介绍了负载均衡下的webshell上传+nginx解析漏洞,首先介绍了负载均衡下webshell上传的四大难点及环境搭建教程,感兴趣的朋友跟随小编一起看看吧
    2024-02-02
  • nginx中return和rewrite指令同时存在先执行顺序哪个

    nginx中return和rewrite指令同时存在先执行顺序哪个

    在Nginx配置中,当return和rewrite指令同时存在,其执行顺序取决于配置的具体场景,这篇文章主要介绍了nginx中return和rewrite指令同时存在先执行顺序哪个,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-09-09
  • 利用nginx和腾讯云免费证书制作https的方法

    利用nginx和腾讯云免费证书制作https的方法

    这篇文章主要介绍了利用nginx和腾讯云免费证书制作https的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11
  • 常见的Nginx配置误区

    常见的Nginx配置误区

    对很多人而言,配置Nginx+PHP无外乎就是搜索一篇教程,然后拷贝粘贴。听上去似乎也没什么问题,可惜实际上网络上很多资料本身年久失修,漏洞百出,如果大家不求甚解,一味的拷贝粘贴,早晚有一天会为此付出代价
    2014-03-03
  • CentOS 7.3.1611编译安装Nginx1.10.3+MySQL5.7.16+PHP7.1.2

    CentOS 7.3.1611编译安装Nginx1.10.3+MySQL5.7.16+PHP7.1.2

    这篇文章主要介绍了CentOS 7.3.1611编译安装Nginx1.10.3+MySQL5.7.16+PHP7.1.2,需要的朋友可以参考下
    2018-01-01
  • 详解nginx使用ssl模块配置HTTPS支持

    详解nginx使用ssl模块配置HTTPS支持

    本篇文章主要介绍了详解nginx使用ssl模块配置HTTPS支持 ,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-12-12
  • nginx配置前端请求转发到指定的后端ip方式

    nginx配置前端请求转发到指定的后端ip方式

    文章主要解释了Nginx配置中如何通过location规则将前端静态资源和后端接口请求进行分流,并详细描述了请求转发到后端的具体过程,包括rewrite规则、代理协议设置、请求头透传、代理地址指定及失败重试机制等
    2026-05-05
  • Nginx+Lua脚本+Redis 实现自动封禁访问频率过高IP

    Nginx+Lua脚本+Redis 实现自动封禁访问频率过高IP

    本文主要介绍了如何使用OpenResty+Lua进行动态封禁IP的解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-10-10

最新评论