GeoIP 数据库配置(国家 / 城市)

管理员指南 更新时间: 2026-09-14 浏览: 2

统计中的国家与城市维度依赖本地 GeoIP(mmdb)数据库解析访客 IP。未配置或文件缺失时地理维度为空。

文件位置

默认路径为 storage/app/geoip/country.mmdb,可通过环境变量 GEOIP_MMDB_PATH 覆盖(见 config/services.phpgeoip 段)。

下载免费数据库

推荐 db-ip.com 的免费 lite 库(每月更新):

# 国家库
curl -L https://download.db-ip.com/free/dbip-country-lite-$(date +%Y-%m).mmdb.gz \
  | gunzip > storage/app/geoip/country.mmdb

# 需要城市维度时,用城市库替换同一路径
curl -L https://download.db-ip.com/free/dbip-city-lite-$(date +%Y-%m).mmdb.gz \
  | gunzip > storage/app/geoip/country.mmdb

兼容性:MaxMind GeoLite2 格式同样可用。要展示城市级报表请使用 city 版本库;country 库只有国家级精度。

更新与验证

  • lite 库每月发布,建议配置每月一次的更新脚本重跑上述 curl 命令。
  • 更新后无需重启队列;新的访客数据立即按新库解析。
  • 验证:访问一次站点后,统计页「国家」卡片应出现数据。

常见问题

国家有数据、城市没有
使用的是 country 版 mmdb;换成 city lite 库即可。
本地访问显示未知
内网/回环地址不在 GeoIP 库中,属正常现象。