如何利用 map 指令实现基于 IP 地理位置的访问控制与动态路由重定向-Nginx-PHP中文网

Nginx 的 map 指令可基于 GeoIP2 国家码实现静态映射，用于分流、白名单或路由；需在 http 块中定义，配合 geoip2 模块还原真实 IP，不可在 server/location 内声明，且不支持动态逻辑。

如何利用 map 指令实现基于 ip 地理位置的访问控制与动态路由重定向

用 Nginx 的 map 指令做基于 IP 地理位置的访问控制和动态路由，核心在于把国家代码映射成可编程的变量，再结合条件判断或后端选择实现跳转或拦截。它不依赖外部 API、无运行时延迟，且配置简洁可靠。

准备地理信息数据源

Nginx 本身不自带 IP 归属识别能力，需先接入 GeoIP 数据库：

推荐使用 MaxMind 的 GeoLite2（免费版已足够多数场景），下载 GeoLite2-Country.mmdb
将文件放在服务器固定路径，如 /usr/share/GeoIP/GeoLite2-Country.mmdb
在 nginx.conf 的 http 块中加载模块与数据库：
load_module modules/ngx_http_geoip2_module.so;
geoip2 /usr/share/GeoIP/GeoLite2-Country.mmdb { $country_code source=$remote_addr country iso_code; }

用 map 定义路由逻辑或访问策略

map 指令把原始国家码转换为更易读、更灵活的值，比如目标域名、状态码或是否放行标志：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

按国家分流到不同后端：

map $country_code $backend {<br>
    default "https://global.example.com";<br>
    "CN" "https://cn.example.com";<br>
    "US" "https://us.example.com";<br>
    "JP" "https://jp.example.com";<br>
  }

实现白名单访问控制：

map $country_code $allowed {<br>
    default 0;<br>
    "CN" 1;<br>
    "SG" 1;<br>
    "HK" 1;<br>
  }

在 server 或 location 中执行动作

有了映射变量，就可以在具体请求处理阶段做跳转或拦截：

重定向到对应区域站点：

location / {<br>
    return 302 $backend;<br>
  }

拒绝非白名单国家访问：

if ($allowed = 0) {<br>
    return 403 "Access denied for your region."; <br>
  }

配合 proxy_pass 实现透明路由（适合反向代理架构）：

location /api/ {<br>
    proxy_pass https://$backend/api/;<br>
    proxy_set_header X-Country $country_code;<br>
  }

注意事项与避坑点

实际部署时几个关键细节直接影响效果稳定性：

确保 $remote_addr 是真实用户 IP：若网站前置了 CDN（如 Cloudflare），需开启「Real IP」功能，并用 set_real_ip_from + real_ip_header CF-Connecting-IP 还原原始地址
map 必须定义在 http 块内，不能写在 server 或 location 中
国家码字段名以所用模块为准：GeoIP2 模块用 country iso_code，老版 GeoIP 模块用 country_code
避免在 map 中调用函数或执行复杂逻辑，它只支持静态映射；动态判断（如“除中国外全部跳转”）应放在 if 或 rewrite 中