# 数据来源

查询结果整合多个开放数据源: 以 Merged-IP 为基础, 中国大陆 IP 用 GeoCN 补充区县与运营商, 本地库都查不到时回退到在线 API。

## Merged-IP: 主数据源

[NetworkCats/Merged-IP-Data](https://github.com/NetworkCats/Merged-IP-Data) (MIT), 每日更新。

- 合并 GeoLite2 City / ASN、IPinfo Lite、DB-IP 与纯真 (QQWry): 国家、省份、城市、经纬度、时区、ASN
- 合并 [OpenProxyDB](https://github.com/NetworkCats/OpenProxyDB)、Tor 中继、iCloud Private Relay、X4B VPN 与 anycast 列表: 代理 / VPN / Tor / 机房 / CDN / 校园网 / 匿名网络标记, 即接口里的 `traits`

## GeoCN: 中国大陆增强

- 中国大陆 IP 提供更精准的省 / 市 / 区县级定位与运营商 (电信、联通、移动等)
- 命中时国家固定为中国, `source` 为 `GeoCN`; 北京、天津、上海、重庆四个直辖市不单列城市一级
- 另有 86 条中国 ASN 到运营商的映射, 用于识别国内网络

## 合并规则

| 情况 | 结果 |
| --- | --- |
| GeoCN 命中 | 省市区县与运营商取 GeoCN, 其余字段取 Merged-IP, `source: "GeoCN"` |
| 只有 Merged-IP 命中 | 全部取 Merged-IP, `source: "Merged-IP"` |
| 本地库都无结果 | 依次尝试 MaxMind Web API、IPInfo.io API, `source: "MaxMind"` |
| 私有 / 保留地址 | 不查库, 返回固定的「私有网络」结果 |

## 更新与缓存

- 本地 MMDB 每小时检查一次更新, 发现新版本后在线热替换, 查询不中断
- 查询结果按精度、来源与 IP 类型计算缓存时间, 5 分钟到 3.6 小时不等
- 坐标精度有限, 多数情况下只到城市或区县中心, `location.accuracy_radius` 为误差半径; 本服务不提供街道级定位

## 问题反馈

发现某个 IP 的归属不准, 请到 [论坛](https://www.sunai.net/t/topic/946) 留言, 附上具体 IP 和你认为正确的位置。
