nginx 的 url 分发由 location 匹配驱动，proxy_pass 仅执行转发；location 前缀匹配决定路由，proxy_pass 尾部斜杠控制路径传递方式，正则 location 和 upstream 可实现灵活分发与负载均衡。

Nginx 中 proxy_pass 本身不直接“根据 URL 分发”，它只是转发动作；真正的 URL 分发逻辑靠 location 匹配规则驱动。proxy_pass 的作用是把匹配成功的请求，按指定方式转发到后端——关键在于 location 怎么写、proxy_pass 后面的 URL 是否带尾部斜杠 /，这两点共同决定路径如何传递。

用 location 路径前缀做基础分发

这是最常用也最清晰的方式。Nginx 按照最长前缀匹配原则选择 location 块，每个块内独立配置 proxy_pass。

• /api/ → 转发给 API 服务：
  location /api/ { proxy_pass http://api-backend/; }
• /static/ → 转发给静态资源服务：
  location /static/ { proxy_pass http://cdn-server/; }
• 其余请求默认走主站：
  location / { proxy_pass http://web-app; }

注意：所有 location 都要放在同一个 server 块里，顺序不影响匹配（Nginx 自动按前缀长度排序）。

FastAPI Flask Proxy

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

下载

proxy_pass 尾部斜杠决定路径是否保留

这个细节直接影响后端能否正确接收请求路径，常被忽略却极易出错。

• proxy_pass http://127.0.0.1/; → 去掉匹配的 location 路径
  访问 /api/v1/user，实际发给后端的是 /v1/user
• proxy_pass http://127.0.0.1; → 保留完整原始路径
  访问 /api/v1/user，实际发给后端的是 /api/v1/user
• proxy_pass http://127.0.0.1/app/; → 替换为指定前缀
  访问 /api/v1，实际发给后端的是 /app/v1

用正则匹配实现更灵活的 URL 分发

当路径规则复杂（如含版本号、多级动态参数），可用 ~ 或 ~* 开头的正则 location。

• 按版本路由：
  location ~ ^/v1/(.*)$ { proxy_pass http://v1-backend/$1; }
• 按查询参数分流（需配合 map 或 if）：
  map $arg_app $backend { default web; "mobile" mobile; }
  location / { proxy_pass http://$backend; }
• 注意：if 在 location 内慎用，优先考虑 rewrite + 正则 location 组合

结合 upstream 实现同一路径下的负载均衡

分发不只是“不同路径去不同服务器”，同一路径也可轮询、权重或按 IP 哈希分发到多个实例。

• 定义后端组：
  upstream api-cluster { server 192.168.1.10:8080; server 192.168.1.11:8080; }
• 在 location 中引用：
  location /api/ { proxy_pass http://api-cluster/; }
• 可加策略：
  upstream api-cluster { ip_hash; server ... } 或 weight=2