GeoFeed Harvester Dataset
收藏资源简介:
GeoFeed Harvester 从公共RIR数据中发现RFC 8805 geofeed文件,下载它们,验证每一行,添加来源,批量检查BGP可见性,并发布一个干净的数据集,可供GeoForge、MMDB构建器、欺诈系统、路由工具和研究管道使用。该数据集提供每日第一方IP地理定位,旨在使用运营商发布的源地理定位,而不是重新打包不透明的商业GeoIP数据库。
GeoFeed Harvester discovers RFC 8805-compliant geofeed files from public RIR data, downloads them, validates each line, appends source attribution, performs bulk BGP visibility checks, and publishes a clean dataset available for use by GeoForge, MMDB builders, fraud detection systems, routing tools and research pipelines. This dataset provides daily first-party IP geolocation data, which is designed to leverage carrier-published source geolocation information rather than repackaging opaque commercial GeoIP databases.
数据集概述
GeoFeed Harvester 是一个专注于收集并清洗运营商发布的公共地理订阅源(RFC 8805 标准)的数据集工具,旨在提供清晰、可信、可溯源的第一方 IP 地理信息数据。
核心目标
- 溯源为主:直接聚合运营商自主发布的 IP 地理定位(geo-intent)数据,避免使用封闭的商业 GeoIP 数据库。
- 每日更新:通过 GitHub Actions 实现每日自动采集、验证与发布。
最新运行统计
- 生成时间:2026-05-26T07:03:22+00:00
- 有效行数:506,388 行
- 原始行数:568,305 行
- 唯一前缀:506,388 个
- 唯一 geofeed URL:3,371 个
- 覆盖国家:303 个
- 失败抓取数:870 次
- 新增/移除/变更前缀:1,114 / 566 / 801 个
- 数据大小:
- CSV gzip:4.2 MB
- JSONL gzip:5.2 MB
- Parquet:2.9 MB
输出格式
每天自动生成三种格式的数据文件及辅助文件:
| 文件 | 格式 | 说明 |
|---|---|---|
geofeed.csv.gz |
CSV(压缩) | 标准化数据集,每行一条 IP 前缀记录 |
geofeed.jsonl.gz |
JSONL(压缩) | 每条记录为 JSON 对象,一行一条 |
geofeed.parquet |
Parquet | 列式存储,适用于大数据分析 |
failed-geofeeds.csv |
CSV | 抓取失败的 geofeed 列表 |
diff.json |
JSON | 与上一次运行的差异数据 |
manifest.json |
JSON | 数据集清单与元数据 |
changelog.md |
Markdown | 本次运行变更日志摘要 |
SHA256SUMS |
文本 | 各文件的 SHA256 校验和 |
数据字段说明(CSV 格式)
每条记录包含以下字段:
| 字段 | 说明 |
|---|---|
prefix |
IP 前缀(如 5.23.48.0/24) |
country |
国家代码(ISO 3166-1) |
region |
区域代码(ISO 3166-2,可选) |
city |
城市名 |
postal_code |
邮政编码 |
rir |
来源 RIR(如 RIPE, APNIC 等) |
inetnum |
引用的 inetnum 段 |
url |
geofeed 源文件 URL |
fetched_at |
抓取时间 (UTC) |
signed |
是否经过签名 |
signature_valid |
签名是否有效 |
bgp_valid |
前缀是否在 BGP 中可见 |
confidence |
置信度分数 |
flags |
额外标记 |
数据来源与覆盖
自动发现基于公共未认证数据源:
| 来源 | 启用状态 |
|---|---|
| RIPE(公共 inetnum / inet6num 转储) | 已启用 |
| APNIC(公共 inetnum / inet6num 转储) | 已启用 |
| AFRINIC(公共数据库转储) | 已启用 |
| LACNIC(公共 Geofeeds 服务 CSV) | 已启用 |
| ARIN(认证批量 WHOIS / RDAP 回退) | 默认未启用 |
数据管道处理流程
- 从各 RIR 批量转储中提取 inetnum 与 geofeed URL
- 通过 HTTPS 抓取 geofeed CSV 文件
- 按 RFC 8805 标准逐行验证:
- 仅允许 HTTPS 来源
- 国家/区域代码格式校验
- 丢弃超出 inetnum 范围的记录
- 重叠时优先选择最具体的 inetnum
- 添加来源、URL、in etnum、抓取时间等溯源信息
- 可选:使用 Team Cymru 进行批量 BGP 可见性检查
- 输出标准化 CSV / JSONL、变更日志
数据集访问方式
通过 GitHub 发布的稳定版本(Release)下载:
-
稳定下载 URL(始终指向最新版):
https://github.com/ipanalytics/GeoFeed-Harvester/releases/latest/download/geofeed.csv.gz https://github.com/ipanalytics/GeoFeed-Harvester/releases/latest/download/geofeed.jsonl.gz https://github.com/ipanalytics/GeoFeed-Harvester/releases/latest/download/geofeed.parquet https://github.com/ipanalytics/GeoFeed-Harvester/releases/latest/download/manifest.json
-
Git 仓库中保存的小文件(元数据):
runs/latest-changelog.md runs/latest-manifest.json runs/latest-SHA256SUMS
置信度与信任模型
数据集并非绝对真相,而是带有明确溯源的运营商发布数据的标准化视图。置信信号包括:
- 数据来自 RIR 发现的公共 geofeed
- 前缀位于引用的 inetnum 范围内
- 前缀在 BGP 中可见
- 无模式或重叠标记
- 未来可支持 CMS 签名验证
遵循的规范
- 数据格式:RFC 8805(Geofeed File Format)
- 发现机制:RFC 9632(替代 RFC 9092)
- 大规模发现:推荐使用 RIR 批量转储而非暴力 WHOIS/RDAP




