Nginx 的 proxy_set_header 不直接实现多租户路由，而是通过透传 Host、X-Tenant-ID 等头信息为后端提供租户标识，由后端完成路由、鉴权与数据隔离。
在 Nginx 中，proxy_set_header 本身不直接实现多租户路由，但它能为后端服务提供关键的租户标识信息（如域名、请求头、路径等），让后端应用据此区分租户。真正的路由逻辑通常由后端（如 Spring Cloud、K8s Ingress Controller 或自研网关）完成，Nginx 起的是“透传+预处理”作用。
用 Host 头识别租户并透传
多数多租户系统以子域名区分租户（如 tenant-a.example.com、tenant-b.example.com）。Nginx 可提取 $host 并注入到上游请求中：
server {
listen 80;
server_name ~^(?<tenant>.+)\.example\.com$;
<pre class="brush:php;toolbar:false;">location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Tenant-ID $tenant; # 提取子域名为租户ID
proxy_set_header X-Forwarded-Host $host;
}}
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
~^(?<tenant>.+)\.example\.com$</tenant>使用命名捕获提取租户名，避免硬编码 -
X-Tenant-ID是常用自定义头，后端可直接读取该值做路由或数据隔离 - 保留原始
Host头（proxy_set_header Host $host）有助于后端生成正确 URL
用请求头或路径携带租户信息
若租户通过请求头（如 X-Tenant）或路径前缀（如 /t/tenant-a/api）标识，Nginx 可标准化后传递：
location /t/ {
rewrite ^/t/(?<tenant>[^/]+)/(.*)$ /$2 break;
proxy_pass http://backend;
proxy_set_header X-Tenant-ID $tenant;
proxy_set_header X-Original-Path $request_uri;
}- 路径重写剥离租户前缀，避免后端重复解析
- 同时透传
X-Tenant-ID和原始路径（X-Original-Path），兼顾兼容性与上下文 - 若客户端已带
X-Tenant，可用proxy_set_header X-Tenant-ID $http_x_tenant;直接转发
安全与健壮性注意事项
透传租户信息时需防范伪造和冲突：
- 禁用客户端随意设置关键租户头：用
underscores_in_headers on;+ignore_invalid_headers on;，并在 upstream 中清除不可信头 - 避免覆盖后端必需头：如
proxy_set_header Host应明确设为上游目标域名（如proxy_set_header Host backend.example.com;），而非$host（除非后端依赖它） - 对未匹配租户的请求返回 400 或重定向：添加
if ($tenant = "") { return 400; }防止默认租户被滥用
配合后端完成闭环
Nginx 不做租户鉴权或数据库切换，只确保标识准确送达：
- 后端收到
X-Tenant-ID后，可加载对应租户配置、连接专属数据库或启用功能开关 - 若使用 API 网关（如 Kong、Traefik），建议将租户路由逻辑下沉至网关层，Nginx 仅作 SSL 终结和负载均衡
- 日志中记录
$tenant或$http_x_tenant_id，便于按租户排查问题
