需手动编译Nginx添加GeoIP2模块，配置MaxMind地理数据库，在http块中定义geoip2变量及map映射，再通过if、limit_req、rewrite等指令实现地域跳转、限流与内容分发，并用add_header验证变量生效。
如果您希望在宝塔面板中实现根据访问者地理位置动态调整Nginx行为（如跳转、限流、内容替换等），需绕过宝塔图形界面的限制，直接操作Nginx配置文件并集成地理IP库。以下是具体实施步骤：
一、启用Nginx GeoIP2模块并部署MaxMind数据库
宝塔默认安装的Nginx不包含GeoIP2模块，必须手动编译添加该模块以支持基于国家/城市级的精准识别。模块加载后，需配置二进制格式的GeoLite2数据库供实时查询。
1、登录服务器，执行命令检查当前Nginx是否已含ngx_http_geoip2_module：nginx -V 2>&1 | grep -o ngx_http_geoip2_module；若无输出，则需重新编译。
2、下载并解压与当前Nginx版本一致的源码包，进入源码目录后执行：./configure --with-http_geoip2_module --add-dynamic-module=/path/to/ngx_http_geoip2_module。
3、执行make && make install完成模块安装，随后在宝塔面板【软件商店】→【Nginx】→【设置】→【配置修改】中，在http块顶部添加：load_module modules/ngx_http_geoip2_module.so;。
4、前往MaxMind官网注册账号，下载GeoLite2-Country.mmdb与GeoLite2-City.mmdb，上传至服务器/www/server/geoip2/目录，并确保权限为644。
二、在Nginx主配置中定义地理变量
通过geoip2指令将数据库中的字段映射为Nginx内置变量，后续可在if、map、rewrite等上下文中引用这些变量，实现条件判断基础。
1、打开宝塔面板【网站】→【配置文件】，在server块外部、http块内部添加如下配置段：
geoip2 /www/server/geoip2/GeoLite2-Country.mmdb {
$geoip2_data_country_code source=$remote_addr country iso_code;
$geoip2_data_country_name source=$remote_addr country names zh-CN;
}
2、在同一http块中，补充城市级信息支持（可选）：geoip2 /www/server/geoip2/GeoLite2-City.mmdb { $geoip2_data_city_name source=$remote_addr city names zh-CN; }。
3、保存配置后，在宝塔中点击【重载配置】，再执行nginx -t验证语法正确性。
三、基于地理变量编写动态访问逻辑
利用已定义的$geoip2_data_country_code等变量，在server或location块中嵌入条件分支，控制响应行为。所有逻辑均须使用标准Nginx指令，不可依赖第三方脚本。
1、实现国家维度的访问跳转：在目标站点的server配置中插入以下代码段：
if ($geoip2_data_country_code = "CN") { return 302 https://cn.example.com$request_uri; }
if ($geoip2_data_country_code = "US") { return 302 https://us.example.com$request_uri; }
2、实现地域化限流：在http块内定义limit_req_zone，键值使用地理变量组合：
limit_req_zone $geoip2_data_country_code$binary_remote_addr zone=geo_limit:10m rate=5r/s;
3、在对应location中启用该限流：limit_req zone=geo_limit burst=10 nodelay;
四、使用map指令构建静态映射关系
当需要将地理位置映射为固定字符串（如语言代码、CDN域名、模板路径）时，map指令比重复if更高效且支持缓存，适用于高频读取场景。
1、在http块中添加map定义，将国家码转为本地化资源路径：
map $geoip2_data_country_code $lang_path {
default "/zh/";
CN "/zh/";
JP "/ja/";
KR "/ko/";
}
2、在location中引用该变量实现根路径重写：rewrite ^/(.*)$ $lang_path$1 break;
3、确保目标目录（如/www/wwwroot/example.com/zh/）已存在且包含对应静态资源。
五、验证地理变量是否生效
配置完成后必须验证变量实际取值，避免因数据库路径错误、权限不足或模块未加载导致变量为空，引发逻辑失效。
1、在server块中临时添加调试响应头：add_header X-Country-Code $geoip2_data_country_code;
2、使用curl命令从不同地区IP发起请求：curl -I https://your-domain.com --interface 1.2.3.4（需模拟境外出口IP）。
3、检查响应头中X-Country-Code值是否符合预期；若为空字符串，立即检查/var/log/nginx/error.log中GeoIP2模块加载失败日志。
