apache需分两步实现ip地理信息记录：先通过x-real-ip等头准确获取真实客户端ip并写入日志，再借助mod_geoip2模块实时注入或离线解析geolite2数据库补全国家、城市等字段，同时建议过滤探针和内网ip以提升统计质量。

Apache 本身不内置 IP 地理位置解析能力，无法直接在日志中写入“国家”“城市”这类地理字段。它只能记录请求中已有的原始数据（比如 IP 地址或某些 CDN 提供的地理头）。要体现“地理位置信息”，必须分两步走：先确保日志里有真实、可信的客户端 IP；再借助外部模块或后续分析工具补全地理属性。

第一步：准确记录真实客户端 IP

如果前端有 Nginx、CDN 或负载均衡器，Apache 默认的 %h 记录的是代理内网 IP，不是用户真实 IP。必须改用请求头中的可信字段：

• 优先用 %{X-Real-IP}i：适用于 Nginx 明确配置了 proxy_set_header X-Real-IP $remote_addr 的场景，通常最可靠
• 次选用 %{X-Forwarded-For}i：头值形如 203.122.45.67, 192.168.10.5，真实 IP 在最左边；但需注意该头可能被伪造，建议只在可信代理链下使用
• 特殊设备请查文档：例如 NetScaler 可能用 %{source-ip}i，需与设备侧 header 设置严格一致

第二步：定义带真实 IP 的日志格式并启用

在 httpd.conf 或虚拟主机配置中添加：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

LogFormat "%{X-Real-IP}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" realip_combined
CustomLog "logs/access_real.log" realip_combined

注意：CustomLog 必须引用你刚定义的 LogFormat 名称（如 realip_combined），不能拼错。

第三步：补充地理位置（二选一）

方式一：用 mod_geoip2 模块实时注入（推荐）
安装 mod_geoip2 后，在 LogFormat 中加入变量即可：

LogFormat "%{X-Real-IP}i %{GEOIP_COUNTRY_CODE}e %{GEOIP_CITY}e %t \"%r\" %>s" geo_combined
CustomLog "logs/access_geo.log" geo_combined

前提：已正确配置 MaxMind GeoLite2 数据库路径和内存映射。

方式二：日志留纯 IP，分析阶段批量解析
保持日志只含 IP（如上一步的 realip_combined），后续用 ELK、GoAccess 或 Python 脚本调用 GeoLite2 数据库做离线地理映射。这种方式更灵活，也避免 Apache 运行时开销。

额外建议：过滤干扰项提升地理统计质量

健康检查、爬虫、内网探测会污染地理分布结果：

• 用 SetEnvIf Request_URI "^/health|^/ping" dontlog 标记探针路径，再在 CustomLog 中加 env=!dontlog 排除
• 过滤常见内网段：SetEnvIf Remote_Addr "^(10|172\.(1[6-9]|2[0-9]|3[0-1])|192\.168)" internal，然后用 env=!internal 控制输出