Geo 数据库
它们是什么、为什么需要
访客到来时,追踪器只能看到一个 IP 地址。geo 数据库把 IP 变成事实:国家、地区和城市,运营商(ISP)和网络(ASN),以及这个 IP 是不是属于机房、VPN 或代理。
没有它:
- 报表里没有国家数据;
- 流里的国家过滤器无法判定,直接弃权;
- 斗篷把每个访客都看作 Unknown — 一旦开了国家过滤器,就会把全部流量送进安全页;
- 斗篷里的机房、ISP 和 VPN 检测全部失效。
所以在跑第一个活动之前先把数据库装好。只要一分钟。
有哪些数据库
| 数据库 | 提供什么 | 费用 | 需要准备 |
|---|---|---|---|
| Sypex Geo City Lite | 国家、地区、城市 | 免费 | 什么都不用 — 一键安装 |
| MaxMind GeoLite2 City + ASN | 城市、运营商和 ASN | 免费 | 一个免费的 MaxMind 账号:Account ID + License key |
| IP2Location LITE DB11 | 国家、城市、坐标、邮编、时区 | 免费 | 一个免费的 IP2Location 账号:download token |
| IP2Location ASN LITE | 运营商 / 网络 | 免费 | 同一个 token |
| IP2Proxy LITE PX12 | VPN、代理、Tor、机房、住宅、欺诈评分 | 免费 | 同一个 token |
| 付费版本(IP2Location DB4、IP2Proxy PX12 商业版、MaxMind GeoIP2……) | 精度更高 | 付费 | 手动上传文件 |
推荐组合: Sypex(国家)+ MaxMind GeoLite2 ASN(运营商)+ IP2Proxy PX12(VPN/代理)。装齐后斗篷的每一层都能工作。
仪表盘上的横幅
| 横幅 | 含义 |
|---|---|
| No geo database installed | 什么都没装 — 立即安装 Sypex |
| Only the basic Sypex Geo database is connected | 国家可用,但斗篷没有运营商、机房和 VPN 数据。加上 MaxMind 和 IP2Location |


怎么安装
Sypex(一键)
点击横幅上的 Install Sypex Geo (free),或 ⚙ → Geo Databases → Update(Sypex 行)。全新服务器上安装器也会自动完成。
MaxMind GeoLite2
- 在 maxmind.com 注册(免费)。
- 在 MaxMind 账号里:Manage License Keys → Generate new license key。记下 Account ID 和密钥。
- ⚙ → Geo Databases:粘贴 MaxMind Account ID 和 MaxMind License Key,点 Save Keys。
- 在 GeoLite2 City 和 GeoLite2 ASN 两行分别点 Update。
IP2Location / IP2Proxy
- 在 lite.ip2location.com 注册(免费)。
- 从账号里复制 download token。
- 粘贴到 IP2Location Download Token,点 Save Keys,然后在 DB11、ASN LITE 和 PX12 三行分别点 Update。

每行显示 Status、上次更新时间和大小。下载失败的数据库会显示错误信息。
自带文件
Upload database file 接受 .dat、.bin、.mmdb,或包含其中之一的 .zip — 适合付费数据库或没有外网的服务器。
更新
数据库由后台任务每月自动刷新(cli/geo_update.php,安装时自动配置)。MaxMind 和 IP2Location 只有在密钥保存后才会更新。行内的 Update 可以立即刷新。
验证
- 打开活动测试链接并加
&_dbg=1— 轨迹会显示它为你识别出的国家。 &_geo=DE可以在没有数据库时覆盖国家用于测试。- ⚙ → Logs → Traffic 里的点击显示国家;装了相应数据库后,点击卡片还会显示 ISP 和 ASN。
Geo 档案
⚙ → Geo profiles 是命名好的国家列表 — EU、CIS、Tier 1,或自定义。在国家过滤器里一键插入,不用一个个敲 27 个国家。
在 GitHub 上查看源码: github.com/fenjo26/Orbitra.link/wiki
全部教程