proxy_pass末尾斜杠决定路径处理方式：带斜杠时替换location前缀，不带斜杠时原样拼接完整URI；推荐location与proxy_pass均显式以/结尾，确保行为可预测。
在 Nginx 中，proxy_pass 是实现反向代理和内部请求转发的核心指令，常用于将客户端请求转给后端应用服务（如 Node.js、Python Flask、Java Spring Boot 等），而对外仍统一暴露 Nginx 的地址和端口。
基本语法与路径匹配逻辑
proxy_pass 必须写在 location 块中，它的行为高度依赖 location 的匹配方式和末尾斜杠：
- 如果
location /api/以/结尾，且proxy_pass http://backend/也以/结尾，Nginx 会自动“剥离”/api/前缀再转发。例如请求/api/users→ 实际发给http://backend/users - 如果
proxy_pass http://backend不带结尾斜杠，则整个原始 URI（包括/api/）会被完整拼接过去：请求/api/users→ 发给http://backend/api/users - 不推荐在
proxy_pass后直接写带路径的 URL（如http://backend/v1/），Nginx 会忽略该路径，仅用 host + port，容易引发误解
常见配置示例
假设后端服务运行在 127.0.0.1:3000，前端静态资源由 Nginx 直接服务，API 请求需转发：
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"># 静态文件直接返回
location / {
root /var/www/html;
try_files $uri $uri/ /index.html;
}
# 将 /api/ 开头的请求转发到本地 Node.js 服务
location /api/ {
proxy_pass http://127.0.0.1:3000/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}}
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
注意：proxy_pass http://127.0.0.1:3000/ 末尾的 / 是关键，它确保 /api/ 被去掉，避免后端收到冗余前缀。
转发时必须设置的请求头
后端服务常依赖原始请求信息（如真实 IP、协议类型），若不显式透传，可能出错或日志失真：
-
Host：让后端知道原始域名，尤其当多个域名共用一个后端时 -
X-Real-IP和X-Forwarded-For：传递客户端真实 IP（后者支持多层代理链） -
X-Forwarded-Proto：告知后端当前是http还是https，影响重定向或链接生成
调试与排错要点
转发失败时，优先检查这几项：
- 后端服务是否真的在监听对应地址和端口（用
curl -v http://127.0.0.1:3000/health验证） - Nginx 配置是否重载（
nginx -t && nginx -s reload） - 错误日志位置（默认
/var/log/nginx/error.log），关注connect() failed或no live upstreams - 防火墙或 SELinux 是否拦截了 Nginx 到后端的 outbound 连接
