如何通过location块的proxy_set_header重写Host-Nginx-PHP中文网

nginx中proxy_set_header host可显式重写转发请求的host头，覆盖默认透传行为，仅在含proxy_pass的location中生效，须首字母大写且变量需上下文有效。

如何通过location块的proxy_set_header重写host

在 Nginx 的 location 块中，可以通过 proxy_set_header Host 指令显式重写转发请求的 Host 请求头，从而控制后端服务接收到的主机名。这在反向代理多个域名、调试后端逻辑、或适配不支持虚拟主机的旧服务时非常关键。

明确覆盖默认 Host 行为

Nginx 默认会将客户端原始的 Host 头透传给后端（即 proxy_set_header Host $host;）。若想改写，必须在 location 块内显式声明 proxy_set_header Host，且该声明会覆盖上级（如 server 或全局）的同名配置。

用字面量重写：proxy_set_header Host "api.example.com";
用变量动态构造：proxy_set_header Host "$host:$server_port"; 或 proxy_set_header Host "backend-$host";
清空 Host（极少用，可能触发后端异常）：proxy_set_header Host "";

配合 proxy_pass 使用才生效

proxy_set_header 仅在当前 location 启用了代理（即存在 proxy_pass）时起作用。如果该 location 是静态文件服务或内部重定向，此指令会被忽略。

例如：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

location /api/ {
    proxy_pass https://10.0.1.20:8443/;
    proxy_set_header Host "internal-api.company.local";
    proxy_set_header X-Real-IP $remote_addr;
}

此时所有发往 /api/ 的请求，后端收到的 Host 头固定为 internal-api.company.local，与客户端访问的域名无关。

注意变量作用域和大小写敏感性

Host 是标准 HTTP 请求头，Nginx 中必须严格写成 Host（首字母大写），写成 host 或 HOST 将无效。同时，所用变量（如 $host、$http_host）需确保在该 location 上下文中可解析：

$host：取自请求行的 Host，不带端口，已做规范化（小写，去空格）
$http_host：原始 Host 头（含端口，大小写保留），若客户端未发送 Host，则为空
避免在 rewrite 后立即使用未更新的变量；如有重写逻辑，建议在 proxy_pass 前完成

验证是否生效

最直接的方式是让后端返回接收到的 Host 头（如用 curl 测试一个 echo 接口），或在 Nginx 日志中记录：

log_format debug '$remote_addr - $remote_user [$time_local] '
                  '"$request" $status $body_bytes_sent '
                  '"$http_host" "$sent_http_host"';
access_log /var/log/nginx/debug.log debug;

然后检查 $sent_http_host（即实际发给后端的 Host）是否符合预期。