GeoIP 数据库配置(国家 / 城市)
管理员指南 更新时间: 2026-09-14 浏览: 2
统计中的国家与城市维度依赖本地 GeoIP(mmdb)数据库解析访客 IP。未配置或文件缺失时地理维度为空。
文件位置
默认路径为 storage/app/geoip/country.mmdb,可通过环境变量 GEOIP_MMDB_PATH 覆盖(见 config/services.php 的 geoip 段)。
下载免费数据库
推荐 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 库中,属正常现象。