让后台知道原始请求来自哪里
🎯 引言
请求经过代理后,后台直接连接到的是 Nginx。生成链接或记录访问来源时,它可能看到错误的域名、协议和地址。本篇解释怎样转交这些信息,以及后台等太久时怎样终止等待。
🧱 请求头与信任边界
请求头是请求中附带的说明信息,例如 Host 指明要访问哪个站点。代理建立了一次新的上游请求,某些信息需要明确设置。
本课程入口直接面对客户端,前面没有其他代理。在已有 /api/ 块中补齐:
location ^~ /api/ {
proxy_pass http://127.0.0.1:9001/;
proxy_http_version 1.1;
proxy_set_header Connection '';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 3s;
proxy_read_timeout 15s;
}
proxy_set_header 设置发给上游的请求头。$host 表示 Nginx 确定的站点主机名,$remote_addr 是直接连接到 Nginx 的客户端地址,$scheme 是到入口这段请求的 http 或 https。本机测试看到 127.0.0.1 是正常结果。
X-Forwarded-For 常表示请求经过代理前的地址链。本例覆盖客户端传入的同名头,只传实际连接地址,避免把访问者随意填的头当成可信来源。应用只有在请求确实来自受信任代理时,才能使用这些头。
如果以后在 Nginx 前增加云负载均衡或 CDN(在多处保存并分发资源的网络服务),$remote_addr 就可能是它们的地址。那时要按明确的可信代理网段设计地址恢复规则,不能直接信任任意转发头。
🧪 让模拟后台展示收到的值
在 mock.conf 的 /notes 块内加入以下响应头,保留原有 X-Backend 和 X-Seen-URI:
add_header X-Seen-Host $http_host;
add_header X-Seen-Proto $http_x_forwarded_proto;
add_header X-Seen-Client $http_x_real_ip;
add_header X-Seen-Forwarded-For $http_x_forwarded_for;
$http_... 表示后台收到的某个请求头,头名被转为小写并以 _ 替代 -。这些回显只用于本机实验,真实应用不必公开内部调试信息。
重载后,用故意伪造的转发头测试:
curl -i -H 'Host: notes.test' -H 'X-Forwarded-For: 203.0.113.9' http://127.0.0.1:8080/api/notes
预期回显主机为 notes.test,协议为 http,客户端和转发地址均为 127.0.0.1。说明入口覆盖了伪造值。请求头的设置与继承规则见官方代理头文档。
🧰 超时限制的是哪段等待
proxy_connect_timeout 3s 限制建立上游连接的等待;proxy_read_timeout 15s 限制两次读取上游数据之间的等待,不是整个请求最多 15 秒。若上游持续间隔更短地发送数据,请求总时间可能超过该值。
连接被拒绝常出现 502 Bad Gateway,上游等待超时常出现 504 Gateway Timeout,最终要结合错误日志判断原因。调大超时不会让慢查询变快,先确定上游为什么没有及时响应。
proxy_http_version 1.1 和清空 Connection 让后续配置上游连接复用有明确基础;它们并不自动让普通代理支持 WebSocket。实时双向通信还需要升级请求的额外配置,超出本门入门主线。
❓ 知识问答
Q1:后台能无条件用 X-Real-IP 作为用户身份吗?
不能。它最多用于受信任链路中的来源记录,不等于登录身份,也不能替代权限校验。
Q2:请求超过 15 秒却没报错,是配置失效了吗?
未必。读取超时关注相邻读取之间的间隔,持续有数据可能一直不触发。
🧪 小练习
保持后台正常,分别使用 Host: notes.test 和 Host: unknown.test 请求 /api/notes,检查回显。
验收:两次都到默认入口,但后台分别收到对应的主机名。能说明站点默认规则并不会把陌生的 Host 自动改成 server_name。线上应用生成绝对链接时仍应校验允许的域名。
🎉 请求的信息与信任关系,现在都有了清晰的来源!
