当站点需要根据访问者来源国家提供不同语言或内容版本时，Apache通过GeoIP模块可以直接在Web服务器层完成判断和分发，不需要改动后端应用。GeoIP数据库会把公网IP地址映射到国家代码或更细的地理信息，Apache配置中依据这些变量执行重定向、目录切换或反向代理。这套方案对中小型站点尤其实用，因为地域判断集中在边缘层，响应速度快，而且不会把压力传导给应用服务。
安装mod_geoip2并准备GeoIP数据库
要让Apache具备IP到国家的解析能力，需要安装GeoIP模块和数据库文件。以Debian或Ubuntu为例，可以直接使用发行版提供的包：
sudo apt update sudo apt install libapache2-mod-geoip2 sudo a2enmod geoip2 sudo systemctl restart apache2
安装完成后，Apache会加载动态模块，但还需要在配置文件中声明数据库位置。传统GeoIP Legacy数据库文件通常是GeoIP.dat或GeoIPCountry.dat，可以从MaxMind的历史归档中获取。如果条件允许，更建议使用GeoIP2的mmdb格式和对应模块，但很多现有系统仍然依赖mod_geoip2，掌握其配置方式有助于维护旧项目。
在虚拟主机或全局配置中加入如下指令：
GeoIPEnable On GeoIPDBFile /usr/share/GeoIP/GeoIP.dat MemoryCache GeoIPOutput Env GeoIPScanProxyHeaders Off
GeoIPEnable用于开启解析功能，GeoIPDBFile指定数据库路径，MemoryCache选项会把数据库加载到内存中，避免每次请求都读写磁盘。GeoIPOutput设置为Env后，GeoIP查询结果会注入到Apache环境变量，供后续重写规则读取。如果站点直接暴露在公网，GeoIPScanProxyHeaders可以先关闭；如果前面有Nginx或CDN反向代理，则要结合真实IP策略调整。
基于国家代码实现跳转与内容分发
最常用的变量是GEOIP_COUNTRY_CODE，它保存两位国家代码，例如德国为DE、日本为JP、中国为CN。借助mod_rewrite可以非常灵活地按国家执行301或302跳转：
RewriteEngine On
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^DE$ [NC]
RewriteRule ^/?(.*)$ https://de.ipipp.com/$1 [R=302,L]
这段规则会检查环境变量里的国家代码，如果等于DE，就把当前请求临时重定向到德语子域名，路径部分被保留下来。多个国家可以合并到一个正则条件中，例如德语区用户统一跳转：
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(DE|AT|CH)$ [NC]
RewriteRule ^/?(.*)$ https://de.ipipp.com/$1 [R=302,L]
如果需要根据不同国家分发到不同子域，可以按顺序编写多条规则。要注意RewriteCond只对紧随其后的RewriteRule生效，因此每条规则之间需保持条件与动作紧邻。重定向通常使用302，方便调试确认；上线后改成301可以提高SEO信号，但一定先确认国家判断无误，否则用户会被长期错误导向。
除了跳转到子域，还可以在同一个域名下把请求内部重写到不同目录。比如德国用户读取/de/目录，日本用户读取/jp/目录，规则如下：
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^DE$ [NC]
RewriteCond %{REQUEST_URI} !^/de/ [NC]
RewriteRule ^/?(.*)$ /de/$1 [L,QSA]
第二个条件用来避免已经进入/de/目录的路径再次被追加前缀，否则容易产生无限重写。内部重写不会改变浏览器地址栏URL，适合维护同一品牌下多语言内容。若目录结构复杂，还可以把国家代码写入请求头供后端程序读取，由应用层做更细的渲染控制。
反向代理地域分流与真实IP处理
当不同区域的后端服务部署在不同机房时，Apache可以直接充当反向代理，根据国家代码把流量转发到对应上游。配置需要先启用代理模块并编写重写规则：
RewriteEngine On
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^CN$ [NC]
RewriteRule ^/?(.*)$ http://backend-cn.internal/$1 [P,L]
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^US$ [NC]
RewriteRule ^/?(.*)$ http://backend-us.internal/$1 [P,L]
使用[P]标志会把请求交给mod_proxy转发，对客户端来说仍然是同一个入口域名。由于地域分流依赖访问者真实IP，前置了Nginx、Cloudflare或AWS ELB等代理后，Apache看到的是代理IP，直接查询GeoIP会得到错误国家。此时需要打开GeoIPScanProxyHeaders并配合mod_remoteip恢复真实地址：
RemoteIPHeader X-Forwarded-For RemoteIPInternalProxy 10.0.0.0/8 RemoteIPInternalProxy 172.16.0.0/12 GeoIPScanProxyHeaders On
但GeoIPScanProxyHeaders直接读取X-Forwarded-For存在信任风险，因为任何请求都可以伪造该头。正确的做法是只相信来自内部代理的X-Forwarded-For，mod_remoteip会根据可信代理列表处理，再由GeoIP模块基于REMOTE_ADDR判断。生产环境中务必把代理IP范围限制在最小集合，否则地域规则可能被攻击者绕过。
性能优化与维护建议
GeoIP查找虽然比磁盘日志轻，但每次请求都执行仍会带来少量延迟。为了降低开销，推荐在GeoIPDBFile中使用MemoryCache，将数据库常驻内存。如果访问量很大，可以进一步配合mod_cache缓存按国家划分后的响应，或者把国家识别结果写入Cookie，避免同一用户后续请求反复判断。不过Cookie方案需要额外的校验机制，防止用户篡改国家信息绕过分发策略。
数据库文件决定了IP归属的准确度。IP分配会随运营商和地域变化，因此需要定期更新GeoIP数据。老旧的GeoIP Legacy数据库已经进入停止维护阶段，新项目建议直接选择GeoIP2的mmdb数据库以及支持mmdb的Apache模块。虽然变量和模块名称会有所不同，但重写分发思路完全一致。
正式上线前，建议准备几组不同国家的代理IP做模拟测试，验证跳转、目录重写和反向代理是否正确。测试时观察Apache错误日志和重写日志，能快速定位规则不生效的原因。地域定向分发并不是绝对精准的，因为代理、VPN和移动网络可能导致IP归属与实际位置不一致，所以在关键业务中应提供手动切换国家或语言的入口，避免用户被错误锁定在某个区域。
Apache GeoIP地域定向分发mod_geoip2修改时间：2026-09-20 20:28:08