Nginx反向代理Proxmox /pve01路径失效，页面空白资源404求助

问题根源 #

空白页和资源404的核心原因是Proxmox Web界面的静态资源、API请求均以/为根路径硬编码，当通过/pve01子路径访问时，浏览器会直接向https://www.something.org:8443/xxx发起请求，而非预期的/pve01/xxx，导致资源找不到。你之前的三种配置都未处理页面内的路径替换问题，因此无效。

正确配置方案 #

使用Nginx的sub_filter模块（需确保Nginx编译时包含ngx_http_sub_module），替换页面中所有根路径引用为子路径，同时完善代理头部：

location /pve01/ {
    # WebSocket 相关配置（保留原有效配置）
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    # 基础代理配置
    proxy_pass https://10.10.0.10:8006/;
    proxy_buffering off;
    client_max_body_size 0;
    proxy_connect_timeout 3600s;
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
    send_timeout 3600s;

    # 关键：替换页面内的根路径为子路径
    sub_filter 'href="/' 'href="/pve01/';
    sub_filter 'src="/' 'src="/pve01/';
    sub_filter 'action="/' 'action="/pve01/';
    sub_filter '@@js@@' '/pve01@@js@@'; # 处理动态生成的路径
    sub_filter_once off; # 替换所有匹配项，而非仅第一个

    # 传递正确的客户端和协议信息给Proxmox
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
}

额外验证步骤 #

1. 检查Nginx是否支持sub_filter：执行nginx -V，输出中包含--with-http_sub_module即为支持，若没有则需重新编译Nginx添加该模块。
2. 重启Nginx：执行nginx -s reload加载新配置。
3. 清除浏览器缓存后访问https://www.something.org:8443/pve01，避免旧缓存导致的路径错误。

之前配置无效的原因 #

• 配置1：仅做了路径转发，但页面内资源引用仍为根路径，浏览器请求错误路径。
• 配置2：将/pve01/xxx直接传给Proxmox，后端不存在该路径，返回404。
• 配置3：rewrite仅修改了请求路径，但页面内的硬编码路径未被替换，浏览器依然请求根路径资源。

内容的提问来源于stack exchange，提问作者adviner