如何利用 ngx_http_geoip2_module 在日志中注入访客的省份与城市维度信息-Nginx-PHP中文网

需加载GeoIP2数据库、配置geoip2指令提取省份城市字段，并通过log_format注入日志；下载GeoLite2-City.mmdb至Nginx可读路径并授权，http块中定义geoip2变量与中文日志格式，重启后用curl验证字段是否生效。

如何利用 ngx_http_geoip2_module 在日志中注入访客的省份与城市维度信息

要利用 ngx_http_geoip2_module 在 Nginx 日志中记录访客的省份与城市信息，核心是：加载 GeoIP2 数据库、配置 geoip2 指令提取地域字段、再通过 log_format 将这些字段注入日志变量。

准备 MaxMind GeoIP2 City 数据库

该模块不自带数据，必须手动下载并部署官方二进制数据库文件：

前往 MaxMind 官网注册账号，免费获取 GeoLite2-City.mmdb
建议使用中国大陆镜像源（如腾讯云 COS 或阿里云 OSS 公共 bucket）加速下载
将 GeoLite2-City.mmdb 放到 Nginx 可读路径，例如 /usr/local/share/GeoIP/GeoLite2-City.mmdb
确保 Nginx 主进程用户（如 www-data 或 nginx）对该文件有读取权限

在 nginx.conf 中启用 geoip2 并定义变量

在 http 块中添加如下配置，注意路径和字段名需严格匹配数据库结构：

http {
    # 加载 GeoIP2 数据库
    geoip2 /usr/local/share/GeoIP/GeoLite2-City.mmdb {
        $geoip2_data_country_code source=$remote_addr country iso_code;
        $geoip2_data_province source=$remote_addr subdivisions 0 names zh-CN;
        $geoip2_data_city source=$remote_addr city names zh-CN;
        $geoip2_data_lat source=$remote_addr location latitude;
        $geoip2_data_lon source=$remote_addr location longitude;
    }
<pre class="brush:php;toolbar:false;"># 定义含地域字段的日志格式（支持中文，需确保日志文件编码为 UTF-8）
log_format geoip2_log '$remote_addr - $remote_user [$time_local] '
                       '"$request" $status $body_bytes_sent '
                       '"$http_referer" "$http_user_agent" '
                       '$geoip2_data_country_code '
                       '"$geoip2_data_province" "$geoip2_data_city" '
                       '$geoip2_data_lat $geoip2_data_lon';

access_log /var/log/nginx/access_geoip2.log geoip2_log;

}

说明：

subdivisions 0 表示一级行政区（如“广东省”），部分省份可能有多个 subdivision，通常取第 0 个即可
names zh-CN 启用中文名称；若未命中或无中文翻译，字段值为空字符串，可在日志中体现为 ""
若需 fallback 英文名，可额外定义 $geoip2_data_province_en subdivisions 0 names en

验证字段是否生效

重启 Nginx 后，可通过以下方式快速确认：

执行 nginx -t 确保配置语法正确
用 curl 模拟请求：curl -H "X-Real-IP: 1.2.3.4" http://your-domain.com/（替换为真实 IP）
检查日志输出是否出现类似 "CN" "广东省" "深圳市" 22.5431 114.0579 的字段
若字段全为空，常见原因：IP 不在数据库中（如内网地址）、路径错误、权限不足、或 IP 被前置代理覆盖 —— 此时应配合 real_ip 模块还原真实客户端 IP