GeoIP2-CN

Hackl0usGPL-3.0活跃维护

提供小巧准确的中国大陆 IP 段 GeoIP2 数据库,方便 Clash、Surge 等代理工具做国内直连与分流规则。

小巧精悍、准确、实用 GeoIP2 数据库

暂无版本7,442star217fork同步于 2026-11-10 11:32 UTC

怎么上手

由 README 提炼,执行前请确认
下载 Country.mmdb:https://github.com/Hackl0us/GeoIP2-CN/raw/release/Country.mmdb
或 CDN:https://cdn.jsdelivr.net/gh/Hackl0us/GeoIP2-CN@release/Country.mmdb
硬件要求按 README 说明

README 未说明,纯数据文件,无显存或 GPU 要求

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

只含中国大陆 IP 段的精简 GeoIP2 数据库,替代体积大、判定不准的 GeoLite2 做代理分流

提供小巧准确的中国大陆 IP 段 GeoIP2 数据库,方便 Clash、Surge 等代理工具做国内直连与分流规则。

核心能力

  • 合并 ipip.net 与纯真数据源生成大陆 IP 段
  • 数据库仅约 100 KB,加载快查询效率高
  • 每 3 天全自动更新一次
  • 同时提供 Country.mmdb 与 CN-ip-cidr.txt 两种格式
  • GitHub RAW 与 jsDelivr CDN 双通道下载

容易踩的坑

库中只有中国大陆记录,写 GEOIP, US/HK 等其他地区规则会查不到结果;需先禁用或删除其他中国大陆 IP 规则集,避免与 GEOIP, CN 规则共存冲突;CDN 链接可能有缓存,会下载到旧版本,要最新数据走 GitHub RAW;GEOIP, CN 规则应紧贴 FINAL 规则之上,否则域名规则可能被忽略

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

0 个版本

暂无 release 数据(可能没有发版,或尚未同步)。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    GeoIP2 · CN

    🇨🇳 小巧精悍、准确、实用 GeoIP2 数据库 🇨🇳

    🔖 项目背景

    目前市面上绝大多数的代理工具都依赖于 GeoIP2 数据库判断地址所属地。它们的规则结尾部分一般都会有一条类似 GEOIP, CN,用来查询目的 IP 地址是否属于中国大陆,从而判断是否直连。

    这些代理工具通常使用的 GeoIP2 数据库是来自于 MaxMind 的 GeoLite2 免费数据库。这个数据库目前存在一下几个问题:

    • 获取不便:从 2019 年 12 月 30 日起,必须注册后才能下载
    • 数据量大:数据库庞大,包含全球的 IP 地址段,约 4 MB
    • 准确度低:对中国大陆的 IP 地址判定不准,如:香港阿里云的 IP 被判定为新加坡、中国大陆等

    新的政策要求注册才能下载会增加时间成本,而且会让自动化下载的难度大大增加。

    庞大的数据量无可厚非,但是对于大多数中国大陆的用户来说,仅需要去判断 IP 的地理位置是否属于中国大陆境内,其他国家的 IP 一律代理。过多的数据量会增加载入时间,降低查询效率;

    而最致命的问题就是准确度低,这会导致代理工具查询后得到错误,做出错误的分流判定,最终导致用户体验不佳,如:网站无法访问、访问缓慢等问题。

    🥳 项目优势

    👓 准确度高

    项目选取更新较为频繁、广受好评、准确度高的 ipip.net 和 纯真 IP 数据库的中国大陆 IP 地址段信息进行合并、去重、整理操作,最终生成仅含有中国大陆 IP 信息的 GeoIP2 数据库。准确度高、用户使用体验好。

    ⚛️ 实用精悍

    GeoIP2 数据库的大小仅为 100 KB 左右,对比原来庞大的数据库,显得非常小巧实用,加载时间极短、查询效率极高。

    项目仅包含大陆用户需要的中国 IP 地址段,无需获取多余的其他国家或地区的 IP 地址,完美贴合使用需求。

    🌍 CDN 分发

    项目直接托管于 GitHub,并使用 CDN 全球分发,瞬间即可完成数据库的下载和加载,在较差的网络环境下也较容易完成数据库的更新。

    🤖️ 自动化更新

    项目每隔 3 天通过全自动化部署自动更新,时刻保持最佳体验,无需人工干预。

    📥 下载链接

    📦 项目📃 文件🐙 GitHub RAW🚀 CDN 加速🔧 适用范围
    IP-CIDR 列表CN-ip-cidr.txt点我下载点我起飞防火墙、较老的代理工具等
    GeoIP2 数据库Country.mmdb点我下载点我起飞Surge, Shadowrocket,QuantumultX, Clash等较新的代理工具

    对于网络状况良好、无污染的环境下,建议选择 GitHub RAW 的方式下载,因为可以第一获取到最新的资源,因为服务器在境外,可能下载响应时间和速度稍长,但因为文件小,所以通常问题不大。

    对于网络状况不好,存在污染的环境下,建议选择 CDN 加速的方式下载,速度非常快。但是可能存在缓存未更新的情况,很可能下载到旧的资源。

    📲️ 配置方式

    请参考项目 Wiki 提供的文档教程,在各个工具中自定义 GeoIP2 数据库。

    目前 Wiki 中已经添加了如下工具的配置教程,欢迎大家在 Issues 中补充:

    ⚠️ 注意事项

    1. 禁用或删除 与 中国大陆 IP 地址段 相关的规则或规则集

      RULE-SET, https://handsome.hackl0us.com/China-IP.list, DIRECT # 禁用或删除类似规则
      GEOIP, CN, DIRECT # 与上一条类似的规则与本条规则不可共存
      
    2. GEOIP-CN 查询规则建议紧随最终规则之上,以避免域名规则被忽略导致判断错误。

      # ... 省略其他规则 ...
      GEOIP, CN, DIRECT # 👀 建议在这里使用规则
      FINAL, PROXY # ⬇️ 最终规则
      
    3. 规则中不可以存在其他国家或地区的 GEOIP 查询规则,因为项目提供的数据库中仅包含中国大陆地区的 IP 地址段记录

      GEOIP, US, PROXY # ❌ 错误,无法查询到相关记录
      GEOIP, AU, PROXY # ❌ 错误,无法查询到相关记录
      GEOIP, HK, PROXY # ❌ 错误,无法查询到相关记录
      GEOIP, CN, DIRECT # ✅ 正确
      

    🏅 版权声明

    本项目 Fork 自 JMVoid/ipip2mmdb 项目,并由 Hackl0us 加以调整和修改。

    项目中所使用的 IP 地址信息来自于 17mon/china_ip_list(基于 ipip.net)和 metowolf/iplist (基于 纯真 IP)。

    GeoIP® 商标版权归 MaxMind 公司所有。

    项目的 Soial Preview 图片来源于 Wikimedia Commons,其版权信息为 CC BY-SA 4.0。