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 实现按国家分流：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
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` 是否正确。不复杂但容易忽略。
