Nginx不内置地理IP库,需依赖真实IP识别与映射实现区域路由:先用geo/map模块将$realip_remote_addr映射为区域变量,再在proxy_pass或if中使用;前提是正确配置set_real_ip_from和real_ip_header以获取真实客户端IP。

Nginx 本身不内置地理 IP 库或定位能力,无法直接根据“地理位置”(如国家、省份)做路由。所谓“基于地理位置的区域路由”,实际是基于客户端真实 IP 地址段映射到已知地理区域后,再做条件判断或变量分发。核心依赖两个环节:IP 归属识别 + 路由决策。下面分三块讲清楚怎么做、怎么配、容易踩什么坑。
用 geo 或 map 模块预定义区域标识
geo 和 map 都能将 IP 映射为区域标签,但适用场景不同: - geo适合粗粒度区域划分(比如只分“国内”和“海外”),语法简洁,原生支持 CIDR,自动处理 IP 匹配优先级; - map更灵活,支持正则、字符串匹配,适合按运营商(如“电信_广东”)、城市(如“shanghai”)等细粒度打标,但必须写 default 值防空变量。例如,用 map 实现按国家分流:
http {
map $realip_remote_addr $region {
default "unknown";
192.168.0.0/16 "internal";
202.96.0.0/16 "cn_telecom";
114.114.0.0/16 "cn_cnc";
8.8.8.0/24 "us_google";
}
}注意:这里用 $realip_remote_addr 而非 $remote_addr,前提是已配置 set_real_ip_from 和 real_ip_header,否则拿不到真实客户端 IP。
在 server 或 location 中结合 if 或 proxy_pass 使用区域变量
map 定义的 `$region` 是全局变量,可在任意 server 或 location 块中引用: - 直接用于 `proxy_pass` 动态路由(推荐): ```nginx location /api/ { proxy_pass http://backend_$region; proxy_set_header Host $host; } ``` 对应 upstream 需提前定义好: ```nginx upstream backend_internal { server 10.0.1.10:8080; } upstream backend_cn_telecom { server 10.0.2.20:8080; } upstream backend_us_google { server 10.0.3.30:8080; } ``` - 也可配合 `if` 做访问控制或重定向(慎用,仅限简单判断): ```nginx if ($region = "us_google") { return 302 https://global.example.com$request_uri; } ```真实 IP 识别是前提,代理链必须可信
如果 Nginx 前面有 CDN、WAF 或负载均衡器,`$remote_addr` 只是上一跳地址。必须: - 明确哪些上游 IP 是可信代理(如 `set_real_ip_from 192.168.10.0/24; set_real_ip_from 203.208.60.0/24;`); - 指定真实 IP 存在哪条请求头里(常见为 `X-Forwarded-For` 或 `True-Client-IP`): ```nginx real_ip_header X-Forwarded-For; real_ip_recursive on; ``` - 配置完务必用 `curl -H "X-Forwarded-For: 202.96.100.1"` 测试,再查 error log 确认 `$realip_remote_addr` 是否正确。不复杂但容易忽略。



















