proxy_pass是ngx_http_proxy_module模块中最核心的指令，本质是定义http层请求的转发目标与路径映射规则：决定uri重写方式、协议透传及后端解析，仅在location等块中生效，其结尾斜杠直接控制路径截取或追加逻辑，并为proxy_set_header等配套指令提供作用上下文。

proxy_pass 是 ngx_http_proxy_module 模块中最核心的指令，它的本质作用是**定义 HTTP 层（7 层）请求的转发目标与路径映射规则**。它不只简单地“把请求发给后端”，而是决定请求 URI 如何被重写、协议如何透传、后端地址如何解析，直接控制反向代理的行为逻辑和语义一致性。

定位请求转发的入口点

该指令只能出现在 location、if in location 或 limit_except 块中，意味着它始终与客户端请求的 URI 匹配上下文绑定。Nginx 依据 location 的匹配结果（前缀匹配、正则匹配等），决定是否执行 proxy_pass，以及如何处理原始 URI：

• 匹配成功后，proxy_pass 才生效；未匹配则走其他处理逻辑（如静态文件服务、return 等）
• 它让 Nginx 在 URL 路由阶段就明确“这个路径交给谁处理”，是反向代理流量调度的起点

控制 URI 转发行为（最易出错的关键）

proxy_pass 后是否带结尾斜杠（/），会触发完全不同的 URI 处理机制：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• proxy_pass http://backend; → 原始 URI 全量追加（如 /api/v1/user → http://backend/api/v1/user）
• proxy_pass http://backend/; → 截掉 location 匹配前缀，再拼接（如 location /api/ + /api/v1/user → http://backend/v1/user）
• proxy_pass http://backend/new/; → 将匹配部分整体替换为 new/（如 location /old/ + /old/item → http://backend/new/item）
• location 使用正则时（如 ~ ^/v\d+/），proxy_pass 后不能带 URI，否则配置会报错

支持灵活的后端寻址方式

它可指向多种后端资源，且支持运行时解析：

• HTTP/HTTPS 地址：http://10.0.1.5:8080、https://api.example.com
• upstream 名称：http://my_backend（配合负载均衡与健康检查）
• UNIX socket：http://unix:/var/run/backend.sock:/path
• 含变量的动态地址：proxy_pass http://$backend_host:$backend_port;

为其他代理功能提供上下文基础

proxy_pass 的存在，是启用一系列配套指令的前提条件。只有在它生效的 location 块中，以下设置才实际起作用：

• proxy_set_header（透传真实 IP、Host、协议等关键头）
• proxy_redirect（重写后端返回的 Location 或 Refresh 头）
• proxy_buffering / proxy_buffers（控制响应体缓冲策略）
• proxy_next_upstream（定义失败时的重试逻辑）