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,而不是覆盖已有值。
按自己的节奏,确认真正理解。