Nginx 用 map 指令实现基于 IP 地理位置的静态资源就近调度，需配合 geoip2 模块与离线数据库，通过 province_code 映射镜像节点，再在 location 中 proxy_pass 或 return 302 实现分流，并辅以兜底和定期更新策略。
用 Nginx 的 map 指令做基于 IP 地理位置的静态资源就近调度，核心是把用户 IP 映射成对应区域的后端服务器地址，再配合 proxy_pass 或 rewrite 实现分流。它不依赖外部服务，轻量、可控、适合中低动态性场景。
准备 GeoIP 数据并加载到 Nginx
Nginx 本身不自带 IP 归属地识别，需借助第三方模块（如 ngx_http_geoip2_module）和离线数据库（如 MaxMind GeoLite2）。安装模块后，在 http 块中加载：
- 下载 GeoLite2-Country.mmdb 或 GeoLite2-City.mmdb 到服务器指定路径
- 在 nginx.conf 的
http区域添加：load_module modules/ngx_http_geoip2_module.so; geoip2 /path/to/GeoLite2-City.mmdb { $geoip2_data_country_code source=$remote_addr country iso_code; $geoip2_data_city_name source=$remote_addr city name; $geoip2_data_province_code source=$remote_addr subdivisions 0 iso_code; }
用 map 指令定义区域到镜像节点的映射关系
map 是 Nginx 的变量映射机制，支持嵌套与正则，适合构建“省→节点”的静态路由表。例如：
- 按省份代码映射 CDN 镜像源站：
map $geoip2_data_province_code $upstream_host { default "origin.example.com"; "BJ" "bj-mirror.example.com"; "GD" "gz-mirror.example.com"; "ZJ" "hz-mirror.example.com"; "JS" "nj-mirror.example.com"; ~^SH "sh-mirror.example.com"; # 支持正则匹配以覆盖上海所有子编码 } - 也可结合国家码 + 省份码做二级判断，避免直辖市被误归入邻省
在 server 或 location 中应用映射结果
映射完成后，直接在反向代理或重写逻辑中引用变量即可：
- 用于反向代理静态资源：
location ~* \.(js|css|png|jpg|gif|webp|woff2)$ { proxy_pass https://$upstream_host$request_uri; proxy_set_header Host $upstream_host; proxy_set_header X-Real-IP $remote_addr; } - 若需 302 重定向（适用于跨域镜像或客户端缓存友好场景），可改用：
return 302 https://$upstream_host$request_uri;
- 注意：确保后端镜像节点已配置 CORS、缓存头（如
Cache-Control: public, max-age=31536000）及 HTTPS 支持
补充校准与兜底策略
纯 GeoIP 映射存在偏差风险（如跨省宽带出口集中、移动网络出口漂移），建议叠加简单兜底：
- 对未命中省份码的请求（
$geoip2_data_province_code为空或未知），fallback 到延迟最低的默认节点（可用upstream+least_conn或预设 RTT 表） - 定期更新 GeoIP 数据库（MaxMind 每月发布新版），避免因行政区划调整导致调度失准
- 日志中记录
$geoip2_data_province_code和$upstream_host，用于后续分析调度合理性
