Apache本身不内置地理识别能力,必须依赖mod_maxminddb或mod_geoip2加载GeoLite2数据库,将IP解析为GEOIP_COUNTRY_CODE等环境变量,再通过RewriteCond、ProxyPass或SetEnvIf实现静态地域分流与访问控制;但其仅支持粗粒度、低频变更场景,无法实时聚类或响应RTT变化。

Apache 本身不带地理识别能力,必须靠 mod_maxminddb(推荐)或 mod_geoip2 加载 MaxMind GeoLite2 数据库,把客户端 IP 解析为国家、城市、ASN 等环境变量;再用 RewriteCond、ProxyPass 或 SetEnvIf 做条件判断和分流。但要注意:它只支持静态规则,不能实时聚类、无法响应 RTT 变化、新增 IP 段需 reload 配置——适合粗粒度、低频变更的场景。
一、基础准备:加载模块并注入地理变量
确保已安装 mod_maxminddb 并配置好 GeoLite2-Country.mmdb:
- 启用模块:
LoadModule maxminddb_module modules/mod_maxminddb.so - 指定数据库路径与变量映射:
MaxMindDBEnable On<br> MaxMindDBFile GEOIP_COUNTRY_DB /usr/share/GeoIP/GeoLite2-Country.mmdb<br> MaxMindDBEnv GEOIP_COUNTRY_CODE COUNTRY_ISO_CODE<br> MaxMindDBEnv GEOIP_CONTINENT_CODE CONTINENT_CODE
- 验证是否生效:在日志中加
%{GEOIP_COUNTRY_CODE}e,或用curl -I查响应头是否含X-GEOIP-COUNTRY-CODE(需额外配Header set)
二、按国家/大区做后端集群分流
使用 RewriteCond + ProxyPass 将请求代理到不同后端组,注意顺序和 [P] 标志:
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
- 国内用户走上海集群:
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^CN$<br> RewriteRule ^/api/(.*)$ http://sh-backend/$1 [P] - 美国+加拿大走美东集群:
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(US|CA)$<br> RewriteRule ^/api/(.*)$ http://us-east-backend/$1 [P] - 其他地区统一走默认集群(放最后):
RewriteRule ^/api/(.*)$ http://default-backend/$1 [P]
三、用 SetEnvIf 实现细粒度访问控制
先标记再控制,比直接在 RewriteRule 里写逻辑更清晰、易复用:
- 标记中国及港澳台区域:
SetEnvIf GEOIP_COUNTRY_CODE ^(CN|HK|TW) is_china_region<br> SetEnvIf GEOIP_COUNTRY_CODE ^(US|GB|DE) is_western_region
- 限制仅中国区可访问管理后台:
<location><br> Require env is_china_region<br></location>
- 给特定区域开启调试头:
Header set X-Region "%{GEOIP_COUNTRY_CODE}e" env=is_china_region
四、注意事项与常见陷阱
这些细节不处理好,分流会失效或误判:
-
真实 IP 获取:若前端有 CDN 或 Nginx 反代,必须配
mod_remoteip并设置RemoteIPHeader X-Forwarded-For,否则查的是代理 IP -
大小写敏感:ISO 国家码全大写(如
CN),正则中别写成cn;^CN$比CN更安全,避免匹配到CN123 -
配置重载成本高:每次改规则都要
systemctl reload httpd,线上不宜频繁操作;建议用mod_macro封装常用分流块,提升可维护性 - 不适用于动态调度:比如“过去 5 分钟延迟 >200ms 的广东用户切到备用集群”——这种需 OpenResty + Redis 查表,Apache 不适合承担该角色










