在 nginx 中实现不同域名的请求头动态透传,核心做法是在 `server` 块或 `location` 块中使用 `proxy_set_header` 指令。该指令会覆盖默认的转发行为,将客户端的原始 host、ip 和协议信息传递给后端服务,从而让后端能根据这些头部信息识别具体的域名来源。

如何配置基础域名透传
要实现基础的域名透传,只需在对应的 `server` 块中添加 `Host` 头的设置。Nginx 默认会将 `Host` 头替换为当前监听的域名,通过显式指定 `$http_host`,可以确保透传的是客户端请求中的原始值。

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_server;
proxy_set_header Host $http_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;
}
}
上述配置中,`$http_host` 变量直接获取客户端请求的 Host 字段。如果客户端请求的是 api.example.com,即使 Nginx 配置的 server_name 是其他值,透传给后端的依然是 api.example.com。同时,X-Real-IP 和 X-Forwarded-For 用于传递客户端真实 IP,X-Forwarded-Proto 传递 HTTP 或 HTTPS 协议标识。
多域名环境下的路由与透传
当存在多个域名指向同一 Nginx 实例时,可以通过不同的 server 块分别处理。每个 server 块独立配置 proxy_set_header,确保各域名的请求头被正确隔离和透传。

server {
listen 80;
server_name domain-a.com;
location / {
proxy_pass http://backend_a;
proxy_set_header Host $http_host;
}
}
server {
listen 80;
server_name domain-b.com;
location / {
proxy_pass http://backend_b;
proxy_set_header Host $http_host;
}
}
在此场景中,访问 domain-a.com 的请求会被路由到 backend_a,并携带 Host: domain-a.com;而访问 domain-b.com 的请求则路由到 backend_b,携带 Host: domain-b.com。这种配置方式确保了不同域名的请求在后端得到区分,且各自的头部信息保持完整。
使用自定义 Header 进行条件透传
除了标准头部,有时需要根据特定条件(如 URL 路径)透传自定义头部。这可以通过 map 指令结合 if 判断实现,但更推荐直接使用 proxy_set_header 配合变量。
map $uri $custom_header {
/api/v1 "v1-access";
/api/v2 "v2-access";
default "default-access";
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
proxy_set_header X-Custom-Auth $custom_header;
}
}
该配置利用 map 指令根据 URI 生成自定义头部值 $custom_header,并通过 proxy_set_header 将其作为 X-Custom-Auth 透传给后端。这种方式允许基于请求内容动态调整透传的头部信息,满足复杂的业务逻辑需求。











