Web 服务器与网关 / 系统课时

传递主机与客户端信息

传递主机与客户端信息

本篇解决反向代理后应用无法识别真实域名、客户端 IP 或访问协议的问题。通过配置标准请求头,上游服务可以恢复用户访问时的原始上下文。

学习目标

  • 理解反向代理中常用转发请求头的作用
  • 配置 Host、X-Real-IP、X-Forwarded-For 和 X-Forwarded-Proto
  • 验证上游收到的客户端信息

为什么需要转发客户端信息

客户端访问 Nginx 后,请求首先到达代理服务器。默认情况下,上游看到的来源可能是 Nginx 地址,而不是用户真实信息,因此需要通过请求头传递上下文。

常用头包括 Host、X-Real-IP、X-Forwarded-For 和 X-Forwarded-Proto,它们分别描述访问域名、客户端地址、代理链路和原始协议。

配置代理请求头

下面是常见反向代理配置。

nginx
server {
    listen <PORT>;

    location / {
        proxy_set_header Host $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;

        proxy_pass http://backend;
    }
}

预期结果

text
上游请求头包含:
Host: example.com
X-Real-IP: 客户端IP
X-Forwarded-For: 客户端IP, 代理链路IP
X-Forwarded-Proto: http 或 https

理解四类关键请求头

Host 用于保持原始访问域名,很多应用依赖它生成绝对地址或执行租户识别。

X-Real-IP 通常表示直接连接 Nginx 的客户端地址,适合简单场景记录来源。

X-Forwarded-For 用于保存代理链路中的多个地址,适合经过多层网关的系统。

X-Forwarded-Proto 用于告诉应用用户最初使用的是 HTTP 还是 HTTPS,避免 HTTPS 部署下生成错误链接。

验证转发效果

可以让上游接口返回收到的请求头进行检查。

bash
curl -H 'Host: example.com' http://example.com/<PATH>

预期输出

text
HTTP 200
响应内容包含 Host、X-Real-IP 和 X-Forwarded-Proto 字段

常见失败处理

如果应用仍然获取不到真实 IP,需要检查应用框架是否信任代理。例如部分 Web 框架默认不会读取 X-Forwarded-For,必须开启 trusted proxy 配置。

如果多层代理环境中 IP 顺序异常,应确认每一层代理是否正确追加 X-Forwarded-For,而不是覆盖已有值。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

传递主机与客户端信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通