HTML文档在多级反向代理环境下的真实访问结构解析-html教程-PHP中文网

proxy_pass末尾斜杠决定后端路径是否被“吃掉”：location /api/配proxy_pass http://backend/时后端收/v1/user，不带斜杠则收/api/v1/user；多级代理必须透传x-forwarded-*头，html相对路径需用或sub_filter修复。

html文档在多级反向代理环境下的真实访问结构解析

proxy_pass末尾斜杠决定后端收到的路径

真实路径被“吃掉”或“错位”，八成是因为proxy_pass结尾有没有/没搞清。这是多级代理中最常踩的坑，直接导致后端收到的PATH_INFO和预期不符。

关键规则就一条：如果location /api/带末尾/，那么proxy_pass http://backend/也必须带末尾/，否则/api/会被原样拼到后端路径前——比如请求/api/v1/user，后端实际收到/api/v1/user而非/v1/user。

location /api/ { proxy_pass http://backend/; } → 后端收/v1/user
location /api/ { proxy_pass http://backend; } → 后端收/api/v1/user
location /api { proxy_pass http://backend/api; } → 后端收/api/v1/user（注意这里location不带/，proxy_pass也不能带）

X-Forwarded-*头必须逐层透传

前端HTML里用fetch('/user')发请求，经过Nginx A → Nginx B → 后端服务，若中间某一级没透传X-Forwarded-For和X-Forwarded-Prefix，后端就无法还原原始请求路径，尤其在生成跳转URL或签名链接时会出错。

每层代理都得显式加这几行：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Prefix $request_uri;

注意：$request_uri包含查询参数；若只需路径部分，改用$uri；但$uri不带参数，选哪个取决于后端解析逻辑。

HTML相对路径在代理后失效的修复方式

静态HTML里写<script src="js/app.js"></script>，本地开发能跑，一上反向代理就404——因为浏览器按当前URL路径解析相对地址，而代理没改<base>或没重写资源路径。

最稳方案：在HTML头部加<base href="/subpath/">，所有相对路径以此为根
次选方案：Nginx用sub_filter动态替换HTML里的src="js/为src="/subpath/js/（需开启subs_filter_types text/html;）
避免方案：硬编码绝对路径如src="https://example.com/subpath/js/app.js"——跨环境难维护