Nginx 实现静态资源地理就近分发需结合 GeoIP2 模块与 GeoLite2 数据库，通过 map 指令将客户端国家码映射至对应 upstream，再 proxy_pass 转发；须确保真实 IP 获取、内容同步及降级兜底。
利用 Nginx 实现静态资源的“地理就近分发”，核心是根据客户端 IP 的地理位置，将请求路由到物理距离更近、网络延迟更低的静态资源节点（如不同机房或 CDN 边缘节点）。Nginx 本身不内置 IP 地理库，需结合 GeoIP2 模块（推荐）或第三方模块 + 离线数据库实现。以下是实用、可落地的方案。
一、准备地理信息数据源与 Nginx 支持
Nginx 需编译或安装支持 GeoIP2 的模块（ngx_http_geoip2_module），并下载 MaxMind 的 GeoLite2 City 数据库（免费版足够用于地域判断）：
- 从 MaxMind 官网注册下载
GeoLite2-City.mmdb - 确认 Nginx 已加载模块：
nginx -V 2>&1 | grep -o ngx_http_geoip2_module；若未启用，需重新编译或使用 OpenResty / 官方预编译包 - 在
nginx.conf的http块中加载数据库：geoip2 /path/to/GeoLite2-City.mmdb {<br> $geoip2_data_country_code country iso_code;<br> $geoip2_data_city_name city name;<br> $geoip2_data_continent_code continent code;<br>};
二、按地域定义上游服务器组
用 upstream 块为不同区域预设静态资源服务集群，例如：
-
upstream static-cn { server 10.1.10.10:8080; server 10.1.10.11:8080; }（华北节点） -
upstream static-us { server 192.168.20.5:8080; server 192.168.20.6:8080; }（美西节点） -
upstream static-sg { server 172.20.30.1:8080; }（新加坡节点）
注意：各 upstream 可配合健康检查、负载均衡策略（如 least_conn）提升可用性。
三、在 location 中基于地域变量做条件路由
对静态资源路径（如 /static/、/img/、.js/.css/.png）应用 map 指令映射地域到 upstream 名称，再通过 proxy_pass 转发：
- 先用
map构建路由映射（放在http块）：map $geoip2_data_country_code $upstream_static {<br> default static-global;<br> CN static-cn;<br> US static-us;<br> SG static-sg;<br> JP static-sg;<br> KR static-sg;<br>}; - 在 server 或 location 中使用：
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ {<br> proxy_pass http://$upstream_static;<br> proxy_set_header Host $host;<br> proxy_set_header X-Real-IP $remote_addr;<br>}
该方式避免了 if 判断的性能与逻辑陷阱，清晰高效。
四、补充优化与注意事项
-
CDN 协同：若前端已接入 CDN（如 Cloudflare、阿里云 DCDN），应优先让 CDN 完成边缘缓存和地域调度；Nginx 作为源站时，只需响应来自 CDN 回源 IP 的请求，并可信任
X-Forwarded-For或 CDN 提供的地域头（如Cf-Ipcountry） -
IP 来源准确性：确保获取的是真实客户端 IP。若经多层代理，需配置
real_ip指令识别可信代理段，并用$remote_addr替换为真实 IP 后再查库 - 缓存一致性：不同地域节点内容需同步（如通过 rsync、对象存储统一源、或构建时推送），避免同一 URL 在不同地区返回不同版本
-
降级策略：当 GeoIP 查询失败（如变量为空）时，
map的default分支会生效，建议指向一个稳定兜底集群（如 global 或 nearest）
不复杂但容易忽略细节——关键是准确获取 IP、合理划分地域粒度（国家级通常够用）、以及与现有架构（CDN/源站/发布流程）对齐。上线前务必用不同地域出口 IP（如手机热点、代理工具）验证路由结果。
