Nginx反向代理配置求助：路径匹配与静态资源加载异常

问题根源 #

你遇到的两个问题本质是Nginx代理路径规则和前端资源路径不匹配：

1. 不加末尾/的proxy_pass http://localhost:9001会把匹配的/merchant/mangooda路径拼到后端地址后，导致代理到不存在的localhost:9001/merchant/mangooda。
2. 加/后代理到后端根路径，但页面里的静态资源（CSS/JS/图片）路径是相对域名根的（比如/css/style.css），浏览器会直接请求server_name/css/style.css，而非代理到后端，因此加载失败。

可行解决方案 #

方案1：Nginx配合sub_filter修改资源路径（无需改Node应用） #

如果你的Nginx已编译ngx_http_sub_module（多数默认安装包含），可以通过替换HTML中的资源路径前缀解决：

location /merchant/mangooda {
    proxy_pass http://localhost:9001/;
    proxy_set_header Host $host;
    proxy_redirect off;

    # 替换HTML中所有根相对资源路径，加上代理前缀
    sub_filter 'href="/css/' 'href="/merchant/mangooda/css/';
    sub_filter 'src="/js/' 'src="/merchant/mangooda/js/';
    sub_filter 'src="/img/' 'src="/merchant/mangooda/img/';
    sub_filter_once off; # 替换所有匹配项，而非仅第一个
}

# 代理带前缀的静态资源请求到后端
location ~* ^/merchant/mangooda/(css|js|img|fonts)/ {
    # 去掉代理前缀，转发到后端对应路径
    rewrite ^/merchant/mangooda/(.*)$ /$1 break;
    proxy_pass http://localhost:9001;
    proxy_set_header Host $host;
}

原理：返回的HTML会被修改为带/merchant/mangooda前缀的资源路径，浏览器请求这些路径时，第二个location块会剥离前缀并转发到后端，实现正确加载。

方案2：修改Node.js应用的基础路径（最彻底） #

直接让Node应用生成带代理前缀的资源路径，从根源避免问题：
以Express框架为例：

const express = require('express');
const app = express();

// 给静态资源添加代理前缀
app.use('/merchant/mangooda', express.static('public'));

// 模板渲染时统一传入基础路径（以EJS为例）
app.get('/', (req, res) => {
    res.render('index', { baseUrl: '/merchant/mangooda' });
});

模板中引用资源时使用基础路径：

<link rel="stylesheet" href="<%= baseUrl %>/css/style.css">
<script src="<%= baseUrl %>/js/main.js"></script>

这种方式无需依赖Nginx的替换模块，逻辑更清晰，也避免了路径替换可能出现的遗漏。

方案3：仅用rewrite规则处理代理 #

如果不想用sub_filter，也可以通过rewrite直接处理所有请求：

location /merchant/mangooda {
    rewrite ^/merchant/mangooda(.*)$ $1 break;
    proxy_pass http://localhost:9001;
    proxy_set_header Host $host;
    proxy_redirect off;
}

这个配置会把所有/merchant/mangooda/xxx的请求重写为/xxx后代理到后端，同时浏览器地址栏保持/merchant/mangooda前缀。但注意：如果页面里的资源路径是绝对根路径（比如/css/xxx），浏览器还是会直接请求域名根下的路径，此时需要额外添加静态资源的代理规则（同方案1的第二个location块）。

内容的提问来源于stack exchange，提问作者Thaung Htike Oo