网站Nginx如何设置反向代理保留原始路径？

Nginx反向代理中保留原始路径的意义

在使用 Nginx 做反向代理时，如果目标服务器依赖 URL 路径进行路由（如 API 接口、前端路由系统），保留原始路径是确保后端服务能正确解析请求的关键。若未正确配置，可能导致访问路径丢失或返回 404 错误。

如何配置 Nginx 反向代理并保留原始路径

以下是一个标准的 Nginx 配置示例，用于实现反向代理并完整传递原始路径：

nginx

server { listen 80; server_name example.com; location /api/ { proxy_pass http://backend_server/; # 保留主机头 proxy_set_header Host $host; # 保留真实客户端IP（可选） proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; # 保留协议信息（http/https） proxy_set_header X-Forwarded-Proto $scheme; # 设置超时时间（可选） proxy_connect_timeout 60s; proxy_read_timeout 120s; } }

关键点说明：

proxy_pass 结尾的 / 表示将匹配的路径部分去掉后再转发给后端。例如：

请求地址：http://example.com/api/user/list

实际转发到：http://backend_server/user/list

若希望保留完整路径结构，请根据实际需求调整 location 和 proxy_pass 的写法。

不同场景下的配置建议

场景	配置方式	说明
固定路径代理（如 `/api`）	`location /api/ { proxy_pass http://backend/; }`	自动去除 `/api` 后转发
完整路径透传	`location / { proxy_pass http://backend; }`	所有路径原样转发
多级路径代理	`location ~ ^/service/(.*)$ { proxy_pass http://backend/$1; }`	使用正则提取路径动态转发
子路径代理并重写	`rewrite ^/oldpath/(.*)$ /newpath/$1 break; proxy_pass http://backend;`	支持路径重写后再代理

常见问题与排查建议

问题描述	可能原因	解决方法
路径被截断或丢失	`proxy_pass` 结尾是否带 `/` 设置不当	检查路径映射规则，调整配置
后端无法识别请求来源	缺少必要的请求头（如 Host、X-Real-IP）	添加 `proxy_set_header` 项
返回404或接口找不到	路由不匹配或路径未正确传递	查看后端日志确认接收路径
页面样式异常或资源加载失败	静态资源路径未正确处理	检查 CSS/JS 请求路径是否被代理影响