Nginx 中如何使用 proxy_set_header 实现多租户路由-Nginx-PHP中文网

Nginx 的 proxy_set_header 不直接实现多租户路由，而是通过透传 Host、X-Tenant-ID 等头信息为后端提供租户标识，由后端完成路由、鉴权与数据隔离。

nginx 中如何使用 proxy_set_header 实现多租户路由

在 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;
}

}

~^(?<tenant>.+)\.example\.com$</tenant> 使用命名捕获提取租户名，避免硬编码
X-Tenant-ID 是常用自定义头，后端可直接读取该值做路由或数据隔离
保留原始 Host 头（proxy_set_header Host $host）有助于后端生成正确 URL

用请求头或路径携带租户信息

若租户通过请求头（如 X-Tenant）或路径前缀（如 /t/tenant-a/api）标识，Nginx 可标准化后传递：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

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;
}</tenant>

路径重写剥离租户前缀，避免后端重复解析
同时透传 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; } 防止默认租户被滥用