GeoCN

2周前发布 37 0 0

GeoCN 是 GitHub 用户 ljxi 维护的一个中国大陆高精度 IP 离线库。与常见的在线 API 不同,它直接提供 MaxMind DB 格式的 .mmdb 文件,数据仅覆盖 MaxMind 识别为中国大陆的 IP 段,通过二分算法扫描多个公开的高质量 API 接口,经清洗整理后生成最终数据库。

收录时间:
2026-06-07

一、GeoCN 是什么?

GeoCN 是 GitHub 用户 ljxi 维护的一个中国大陆高精度 IP 离线库。与常见的在线 API 不同,它直接提供 MaxMind DB 格式的 .mmdb 文件,数据仅覆盖 MaxMind 识别为中国大陆的 IP 段,通过二分算法扫描多个公开的高质量 API 接口,经清洗整理后生成最终数据库。
项目数据随缘更新,但作者已经提供了非常稳定的在线演示服务,可以直接体验:
  • 查自己 IPv4:https://ipv4.netart.cn/
  • 查自己 IPv6:https://ipv6.netart.cn/
  • 查其他 IP:https://ip.netart.cn/222.137.1.1
GeoCN

GeoCN 网站截图


二、核心亮点

1. 精度到”区”
这是 GeoCN 最大的杀手锏。传统 IP 库通常只能定位到城市,而 GeoCN 在部分 IP 段上可以精确到区/县级别。对于需要精细化运营、风控、日志分析的场景,这个精度提升非常实用。
2. IPv4 + IPv6 双栈支持
国内 IPv6 普及速度加快,很多库对 IPv6 的支持并不完善。GeoCN 同时支持 IPv4 和 IPv6 查询,一份数据覆盖双栈。
3. 纯离线,零依赖
.mmdb 是 MaxMind 的标准二进制格式,读取速度极快,无需联网调用第三方 API。适合内网环境、对数据隐私要求高的场景。
4. 数据字段完整
依托 xiangyuecn/AreaCity-JsSpider-StatsGov 提供的标准行政区划编码,返回字段包含省份、城市、区、运营商等结构化信息,方便直接入库做关联分析。

三、Docker 一键部署(30 秒搞定)

如果你不想折腾代码,作者已经打包好了 Docker 镜像,内置完整数据,开箱即用:
bash
docker run -d -p 8000:80 netart/ipapi
启动后访问 http://localhost:8000 即可使用。容器内数据不会自动更新,后续想升级数据时,重新拉取最新镜像即可:
bash
docker pull netart/ipapi
docker restart <container_id>
对于想集成到自己项目里的开发者,直接下载仓库 Releases 中的 GeoCN.mmdb 文件,用 Python、Go、Node.js 等语言的 mmdb 读取库即可解析,没有任何网络依赖。

四、适合谁用?

  • 后端/运维:做访问日志分析、用户地域分布统计
  • 安全/风控:需要更细粒度的 IP 归属地判断
  • 数据分析:替代精度不足的在线 API,降低调用成本
  • 内网系统:离线环境无法访问外网 API,直接本地加载 mmdb

总结

GeoCN 的定位非常清晰:不做全球库,只做中国大陆的高精度离线库。如果你之前的 IP 查询方案在城市级别就”够用”,那 GeoCN 可能不是你的菜;但如果你需要更细的区域划分、IPv6 支持、或者纯离线部署,这个项目值得放进你的工具箱。

相关导航

暂无评论

none
暂无评论...