用 map 指令实现基于 IP 地理位置的反向代理就近调度，核心是将真实客户端 IP 映射为区域对应后端服务名后交由 proxy_pass 使用；需先通过 set_real_ip_from 等配置还原真实 IP，再加载 GeoIP2 数据库提取国家/省份编码，最后用 map 预计算 $upstream_backend 变量并关联 upstream 分组完成调度。
用 map 指令做基于 IP 地理位置的反向代理就近调度，核心是把用户真实 IP 映射成对应区域的后端服务名，再交给 proxy_pass 使用。它不写条件判断、不嵌套 if，性能高、逻辑清、易维护。
先确保能拿到真实客户端 IP
如果 Nginx 前有 CDN、SLB 或其他代理，$remote_addr 就不是用户出口 IP。必须还原：
- 在
http或server块中配置可信上游网段：set_real_ip_from 10.0.0.0/8;（填你 CDN 回源段或公司内网段） - 指定取 IP 的请求头：
real_ip_header X-Forwarded-For; - 启用递归解析：
real_ip_recursive on; - 验证是否生效：在
log_format中加$realip_remote_addr，看日志是否为用户真实出口 IP
加载 GeoIP2 数据库并提取地理变量
推荐用 MaxMind 的 GeoLite2-City.mmdb（免费需注册获取 License Key），比旧版 GeoIP 更准，支持城市级定位：
- 编译安装
nginx-module-geoip2（OpenResty 用户已内置） - 在
http块中加载数据库：geoip2 /usr/share/GeoIP/GeoLite2-City.mmdb {<br> $geoip2_data_country_code source=$remote_addr country iso_code;<br> $geoip2_data_subdivision_1_iso_code source=$remote_addr subdivisions 0 iso_code;<br>}; - 变量如
$geoip2_data_country_code和$geoip2_data_subdivision_1_iso_code可直接用于后续map
用 map 预计算后端 upstream 名称
避免在 location 或 if 中硬编码判断，全部交给 map 提前算好目标服务名：
- 按国家分流：
map $geoip2_data_country_code $upstream_backend {<br> default "default_srv";<br> CN "cn_srv";<br> JP "jp_srv";<br> US "us_srv";<br>} - 支持更细粒度，比如“CN-BJ”“US-CA”：
map "$geoip2_data_country_code-$geoip2_data_subdivision_1_iso_code" $upstream_backend {<br> default "default_srv";<br> CN-BJ "bj_srv";<br> CN-GD "gz_srv";<br> US-CA "la_srv";<br>} - 注意：私有地址（如 10.0.0.0/8）、未命中 IP 必须有
default分支，否则会因变量为空导致502 Bad Gateway
关联 upstream 并完成代理转发
定义好 map 后，只需在 upstream 块里声明对应后端组，再在 location 中引用即可：
- 在
http块中定义：upstream cn_srv { server 192.168.10.10:8080; server 192.168.10.11:8080; }<br>upstream jp_srv { server 192.168.20.10:8080; }<br>upstream default_srv { server 192.168.30.10:8080; } - 在
server的location中：proxy_pass http://$upstream_backend; - 配合
proxy_set_header X-Real-IP $realip_remote_addr;等头信息，方便后端识别来源区域
