Bobay Stack 波贝自建栈

安全边界 / 2026-09-19

Cloudflare 后面的真实 IP:三个配置缺一不可

开了 CDN 之后,日志里全是 CF 的 IP,限速和封禁全部失效。恢复真实 IP 要改三处。

7 MIN READ BY BOBAY.TOP 更新于 2026-09-25 ↖ 全部笔记
Cloudflare 后面的真实 IP:三个配置缺一不可

站点挂上 Cloudflare 之后,"按 IP 限速"和"按 IP 封禁"会同时失效——因为服务端看到的全是 CF 边缘节点的 IP。这不是配置错了,是没做还原。

第一处:Nginx 信任 CF 网段

set_real_ip_from 173.245.48.0/20;
set_real_ip_from 103.21.244.0/22;
set_real_ip_from 104.16.0.0/13;
# … 其余 CF 网段补全
real_ip_header CF-Connecting-IP;
real_ip_recursive on;

只写 real_ip_header 不写 set_real_ip_from,Nginx 不会信任任何来源,等于没配。

第二处:日志格式要带真实 IP

log_format main '$realip_remote_addr "$request" $status';

用 $remote_addr 的话,日志里还是 CF 的地址。$realip_remote_addr 才是还原后的值。

第三处:应用层也要认

PHP 默认读 REMOTE_ADDR,那是 CF 的 IP。要读 HTTP_CF_CONNECTING_IP,并且只在请求确实来自 CF 时才信任它——否则任何人都能伪造这个头。

顺序错了会怎样

如果先改应用再改 Nginx,应用会拿到一个客户端自己填的假 IP。这个组合最危险:看起来"真实 IP 生效了",实际是攻击者随便写的值,你的封禁列表从此不可信。

正确顺序是:Nginx 先信任 CF 网段 → 还原头 → 应用读 REMOTE_ADDR(已被 realip 改写过)。

验证

curl -H "CF-Connecting-IP: 1.2.3.4" https://your.site/ip

如果直接访问源站返回 1.2.3.4,说明你信任了伪造头——这时候必须确认源站只接受来自 CF 的连接,或者干脆把源站端口只对 CF 网段开放。

不改日志会怎样

所有请求的 remote_addr 都会变成 Cloudflare 的出口 IP(通常是 162.158.x.x、172.68.x.x 这些段)。结果有三个:

  1. 访问日志全是同一个 IP,看不出谁在扫站
  2. fail2ban 会把 Cloudflare 整段封掉,全站立刻 522
  3. 限流按 IP 计数时,所有访客共用一个桶,第一个热门页面就能把全站打成 429

第 2 条是最容易出事的:fail2ban 判到"同一个 IP 高频 404",一封就是 Cloudflare 的一个节点,接下来所有经过该节点的访客全部报错。

正确顺序

先在 nginx 里声明可信来源,再改日志格式,最后才动 fail2ban。

# 只信任 Cloudflare 官方段
set_real_ip_from 173.245.48.0/20;
set_real_ip_from 103.21.244.0/22;
# …(完整列表见 cloudflare.com/ips)
real_ip_header CF-Connecting-IP;
real_ip_recursive on;
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                '$status $body_bytes_sent "$http_referer" '
                '"$http_user_agent" cf=$http_cf_ray';
access_log /var/log/nginx/access.log main;

cf=$http_cf_ray 这一列很值钱:出问题时能用 Ray ID 去 Cloudflare 后台对同一条请求,比只看时间戳快得多。

验证方法

改完必须验,不然只是"以为改了":

curl -s -o /dev/null -H "CF-Connecting-IP: 1.2.3.4" http://127.0.0.1/
tail -1 /var/log/nginx/access.log   # remote_addr 应为 1.2.3.4

如果日志里还是 127.0.0.1,八成是 real_ip_header 写错,或者那段 IP 不在 set_real_ip_from 列表里。

一个反直觉的点

CF-Connecting-IP 是可以被伪造的:任何人不经过 Cloudflare 直连你的源站,都能自带这个头。所以源站必须只允许 Cloudflare 段访问(防火墙白名单),否则这套配置只是把日志写得更像真的。

补充:IPv6 也要单独写 set_real_ip_from,CF 的 IPv6 段和 IPv4 是两套,只配 IPv4 会发现 v6 访客的 IP 依旧是节点地址。

CloudflareNginx真实IPWAF

参考

Cloudflare 真实 IP ↗ Nginx realip 模块 ↗