需借助ngx_http_geoip2_module模块和geolite2数据库实现就近负载均衡：先安装模块并验证，再配置数据库映射国家/省份变量，通过map指令按地域路由至对应upstream，最后设置default兜底及容错机制。
要实现基于国家或省份的就近负载均衡，Nginx 本身不内置地理定位能力，需依赖第三方模块（如 ngx_http_geoip2_module）结合 MaxMind 的 GeoIP2 数据库，解析客户端 IP 所属地理位置，并据此将请求路由到对应区域的后端服务节点。
安装并启用 GeoIP2 模块
Nginx 官方源码不含 GeoIP2 支持，需手动编译或使用预编译包：
- Ubuntu/Debian 推荐用 nginx-extras 包（含 geoip2 模块），或通过 ppa:nginx/stable 安装；
- CentOS/RHEL 需先安装 libmaxminddb 和 geoipupdate，再从源码编译 Nginx 并添加 --add-dynamic-module=../ngx_http_geoip2_module；
- 验证是否启用：运行 nginx -V 2>&1 | grep -o with-http-geoip2-module，有输出即成功。
配置 GeoIP2 数据库与变量映射
下载并定期更新 MaxMind GeoLite2 City 数据库（免费版足够用于国家/省份识别）：
- 注册 MaxMind 账号获取 License Key，用 geoipupdate 自动下载数据库（默认路径：/usr/share/GeoIP/GeoLite2-City.mmdb）；
- 在 http 块中加载数据库并定义变量：
geoip2 /usr/share/GeoIP/GeoLite2-City.mmdb {
$geoip2_data_country_code source=$remote_addr country iso_code;
$geoip2_data_province_code source=$remote_addr subdivisions 0 iso_code;
}
这样就得到了两个可用变量：$geoip2_data_country_code（如 CN、US）、$geoip2_data_province_code（如 GD、BJ、CA、NY）。
按地域划分 upstream 并做条件路由
在 http 或 server 块中定义多个 upstream 组，再用 map 指令将地理变量映射为后端组名：
- 先定义各区域后端集群（支持健康检查、权重等）：
upstream backend_cn_gd { server 192.168.10.101:8080; server 192.168.10.102:8080; }
upstream backend_cn_bj { server 192.168.20.101:8080; }
upstream backend_us_ca { server 10.1.1.101:8080; }
- 用 map 构建路由逻辑（注意：map 只支持字符串匹配，建议组合国家+省份）：
map "$geoip2_data_country_code:$geoip2_data_province_code" $upstream_group {
default backend_global;
"CN:GD" backend_cn_gd;
"CN:BJ" backend_cn_bj;
"US:CA" backend_us_ca;
}
然后在 location 中使用：proxy_pass http://$upstream_group;
兜底与容错处理
真实场景中，IP 地理数据可能缺失、不准或省份字段为空（如某些海外小国无 subdivision），需保障服务不中断：
- 始终设置 default 分支指向一个全局备用集群（backend_global）；
- 对空值做预处理：可在 map 前加一层 map 将空 province 转为占位符，例如：map "$geoip2_data_province_code" $province_safe { "" other; default $geoip2_data_province_code; }，再组合使用；
- 建议开启 proxy_next_upstream error timeout invalid_header http_500 http_502 http_503，自动故障转移。
