裸站直接上网代价不只是日志爆盘:反代链路的斜杠、真实 IP 与缓冲五处配置

裸站直接上网的三个真实代价

「搭个博客而已,直接监听 80 端口不行吗」——这话在纯静态站上勉强成立,但在实践中几乎每个站最终都会付出代价。代价通常不是立刻显现的,而是在几个具体场景里才暴露出来。先把这三个场景说清楚,后面的配置才有意义。

第一,磁盘会满。互联网上没有暴露过几天的 HTTP 服务,会收到大量自动化扫描:请求不存在的路径、带畸形参数、尝试漏洞利用。这些请求全部落进 access.log,一个小站日志一天涨几百兆是常事,几个月就把磁盘写满,然后 MySQL 起不来、PHP 写不了临时文件,整站崩掉。

第二,你会看不懂日志。同样大小的日志里,真实用户和扫描器混在一起,出问题时想找「最近一小时内哪个 IP 大量请求了搜索页」这样的问题,几乎没法用 grep 完成。

第三,你失去了一个可控的收口点。没有反向代理这一层,几乎所有的限流、封禁、缓存、压缩、灰度、真实 IP 透传都无从下手,只能改应用代码,而应用代码往往不是你自己写的。

因此更合适的做法是:应用只监听本地回环,由 Nginx 对外。这篇文章按部署顺序,把反代这一层最容易配错、且配错后很难察觉的地方逐个拆开,重点是那些「配置了但不生效」的部分。

第一步:确认应用真的只监听本地

反代的前提是应用不对外暴露。这一点经常被漏掉:Nginx 配好了,但应用仍然监听 0.0.0.0:8080,于是攻击者可以绕过 Nginx 直接打应用端口,你精心配置的限流、过滤全部作废,日志里也不会留下痕迹。

用 ss 确认监听地址:

ss -lntp | grep 8080

如果看到 0.0.0.0:8080 或 [::]:8080,说明对外暴露了。应该改成 127.0.0.1:8080。不同应用的改法不同:Node 的 listen 参数、Java 的 server.address、PHP-FPM 的 listen 指令、Docker 的端口映射(把 -p 8080:8080 改成 -p 127.0.0.1:8080:8080)。Docker 这一处尤其容易忘,因为 compose 文件里写着 ports 就会被当成「要发布」,而实际上可以只绑定到回环。

改完后用防火墙再兜一层,只放行 80 和 443。这两道不是重复劳动:监听地址是第一道,防火墙是第二道,任何一道失守另一道还能挡住。

第二步:proxy_pass 的斜杠决定路径拼接

反代里最容易出错的地方不是超时参数,而是 proxy_pass 后面那个斜杠。这条规则和 alias 的语义很像,但作用对象是 URI 而不是文件路径。

如果 proxy_pass 的地址带路径部分(哪怕只是一个斜杠),Nginx 会把 location 匹配到的那段 URI 替换掉;如果不带路径部分,则把完整的原始 URI 拼上去。举例说明,假设 location 是 /api/:

location /api/ {
    proxy_pass http://127.0.0.1:8080;
}

location /api/ {
    proxy_pass http://127.0.0.1:8080/;
}

第一种写法下,请求 /api/users 会原样转发成 /api/users。第二种写法下,/api/ 被替换成 /,转发成 /users。哪个对完全取决于后端应用的路由设计:如果后端本身就有 /api 前缀,用第一种;如果后端路由是 /users,用第二种。

最常见的故障是「后端 404 但直接访问后端端口正常」。这时只需要对比 Nginx 日志里的 $request 和后端实际收到的路径,差别几乎总在这个斜杠上。排查时可以在日志格式里加一个 $upstream_uri 变量,直接看转发后的 URI,比猜快得多。

另一个变体是使用变量拼接 proxy_pass。当 proxy_pass 里出现变量,Nginx 的行为会变:它不再自动处理 URI,而是把变量求值结果当完整的上游地址,URI 不会被拼接也不会被替换。这种写法在按环境动态选择上游时有用,但需要自己写 rewrite 或额外拼接。遇到「用了变量之后路径全乱了」,原因就在这里。

第三步:真实 IP——为什么日志里全是 127.0.0.1

加了反代之后,应用看到的客户端地址会变成 Nginx 的地址。所有用户的会话、限流、封禁、统计都会失效,最直接的后果是「按 IP 封禁」变成封禁自己。

要恢复真实 IP,需要三方配合,缺一不可。第一,Nginx 必须把原始 IP 传给后端。这可以通过 set_real_ip_from 加 real_ip_header 实现,也可以在 upstream 里加 X-Real-IP 头。

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://127.0.0.1:8080;
}

第二,后端应用必须被配置成信任这些头。PHP 里通常通过 fastcgi_param 传 REMOTE_ADDR,或者用框架的 trusted proxies 配置;Node/Express 需要 app.set('trust proxy', ...);Java 需要 server.forward-headers-strategy。很多人在第一步做完了就以为结束,结果应用仍然记录 127.0.0.1,问题就在第二步。

第三,如果 Nginx 前面还有 CDN,那么 $remote_addr 拿到的是 CDN 的地址,不是用户的。这时需要 set_real_ip_from 把 CDN 的回源地址段都列上,并让 real_ip_header 指向 CDN 传递真实 IP 的那个头(Cloudflare 用 CF-Connecting-IP,其他厂商各有不同)。这里有一个安全要点:set_real_ip_from 只能列你信任的地址段。如果写成 0.0.0.0/0,任何人都可以伪造 X-Forwarded-For 冒充任意 IP,限流和封禁会彻底失效,还可能出现「伪造管理员 IP 绕过 IP 白名单」的提权。

验证真实 IP 生效的方式很简单:在日志格式里打印 $remote_addr 和 $http_x_forwarded_for,从外部访问一次,看两个值是否符合预期。日志格式建议固定成结构化的样子,方便后续统计:

log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                '$status $body_bytes_sent "$http_referer" '
                '"$http_user_agent" $request_time $upstream_response_time';

其中 $upstream_response_time 和 $request_time 的差值,就是 Nginx 侧的处理与排队开销,这是判断瓶颈在后端还是在网络的第一手数据。

第四步:上传体积与超时是两个独立的上限

反代之后,上传会同时受两个地方限制:Nginx 的 client_max_body_size,以及后端自己的上传上限(PHP 的 upload_max_filesize 和 post_max_size,其他语言各有对应配置)。这两处任何一个不够,用户就会看到 413 或者 500。

正确的做法是把两处设成一致,并且注意 Nginx 的主配置和 server 块可能都有 client_max_body_size,后者会覆盖前者。很多「改了不生效」就是因为改的是 http 块,而 server 块里有一句更小的值在覆盖。

超时同理,是三个独立参数:client_header_timeout 管请求头,client_body_timeout 管请求体传输间隙,proxy_read_timeout 管后端响应的等待。上传大文件时最容易踩的是 client_body_timeout,它的含义不是「整个请求必须在 N 秒内传完」,而是「两次读操作之间不能超过 N 秒」。所以慢速上传一般不会触发它,但网络中断就会立刻断开。

而后端的长时间任务(比如导出报表、生成压缩包)容易触发 proxy_read_timeout。这个参数默认 60 秒,导出任务跑三分钟就会 504,而应用可能已经执行完了,用户重试就产生了重复任务。对这类接口,应该在 location 里单独放宽超时,而不是全局调大——全局调大会让真正的故障挂得更久,占用连接。

第五步:缓冲——什么时候该关

Nginx 默认会把后端的响应先缓冲起来再发给客户端。这个行为对普通页面很有利:后端可以快速释放连接,慢速客户端由 Nginx 缓冲吸收,节省后端资源。但它对两类场景是有害的。

第一类是 Server-Sent Events 和流式响应。缓冲会让数据卡在后端,前端一直等不到内容。这时需要在对应的 location 里关掉缓冲:

location /api/stream {
    proxy_buffering off;
    proxy_cache off;
    proxy_set_header Connection '';
    proxy_http_version 1.1;
    chunked_transfer_encoding off;
    proxy_pass http://127.0.0.1:8080;
}

location /api/upload {
    client_max_body_size 512m;
    client_body_timeout 600s;
    proxy_request_buffering off;
    proxy_read_timeout 600s;
    proxy_pass http://127.0.0.1:8080;
}

第二类是大文件上传。默认 proxy_request_buffering 是开的,意味着 Nginx 会先把整个请求体落盘到临时目录,再一次性转给后端。这会让上传的耗时变长,并且临时目录所在的磁盘要能容纳整个文件。关掉它,请求体会边收边转。但要注意:关掉之后后端会直接看到慢速连接,后端本身的超时也要相应调整,否则后端先断。

至于压缩,反代层要不要开 gzip 是一个常见分歧。如果后端已经压缩并带了 Content-Encoding,Nginx 再压一次会无效甚至出错。稳妥的原则是只在一层开:要么后端开,要么 Nginx 开并在后端关掉。用 curl -sI 看响应头有没有 Content-Encoding: gzip,重复的压缩往往表现为「压缩率异常低」或客户端解析错误。

一份上线前的自检

把这套配置真正用起来之前,按下面的顺序逐条确认。每一条都能在几分钟内验证,且每一条对应的故障都在实践中反复出现过。

确认应用只监听回环地址,防火墙只放行 80 和 443。确认 proxy_pass 的斜杠与后端路由匹配,用日志里的转发 URI 验证。确认真实 IP 链路完整:Nginx 传头、应用信任头、CDN 的 set_real_ip_from 只列可信段。

确认上传体积在两处一致,Nginx 的 server 块没有更小的覆盖值。确认流式接口和大文件上传的 location 单独关掉了缓冲并放宽了超时,且后端超时与之匹配。确认压缩只有一层在做。

最后确认日志格式里有 $request_time 和 $upstream_response_time,这样将来出问题时你能立刻区分是后端慢还是链路慢。这一步在配置阶段只要几秒钟,但在故障当晚能省下几个小时。

反代的价值从来不是「多一层转发」,而是把所有入口收束到一个你能控制、能观察、能修改的地方。配置一旦正确,它就是这个站点最省心的一层;配置错了,它也是最难发现的一层——因为它永远以 502、504、413 这些含糊的状态码出现在用户面前,而不是告诉你原因。所以宁可在上线前多花半小时对照上面这几条,也不要等到半夜被「网站打不开」的告警叫醒再逐条试。

Last modification:November 19th, 2026 at 09:32 pm

Leave a Comment