geoip

LoyalsoldierCC-BY-SA-4.0活跃维护

自动生成并定制多种格式的 GeoIP 规则文件,覆盖 V2Ray、Clash、sing-box、Nginx 等代理与网络工具,省去手动维护 IP 分流的麻烦。

🌚 🌍 🌝 GeoIP 增强版,自由定制多种格式 GeoIP 文件,包括但不限于 V2Ray dat 格式文件 geoip.dat、MaxMind mmdb 格式文件、sing-box SRS 格式文件、mihomo MRS 格式文件、Clash ruleset、Surge ruleset、Nginx allow & deny 规则文件等。Enhanced edition of GeoIP for Nginx, V2Ray, Xray-core, Clash, mihomo, sing-box, Shadowrocket, Quantumult X, Surge, hysteria, Trojan-Go, dae, etc.

202611050019发布于 2026-11-05 00:20 UTC6,687star +13 / 7 天895fork同步于 2026-11-10 23:34 UTC

怎么上手

由 README 提炼,执行前请确认
https://raw.githubusercontent.com/Loyalsoldier/geoip/release/geoip.dat
https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/geoip.dat
硬件要求按 README 说明

README 未说明

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

项目说明

由 README 自动翻译提炼

每周自动生成并可用 CLI 定制的多格式 GeoIP 数据文件,供代理与网关工具做 IP 分流

自动生成并定制多种格式的 GeoIP 规则文件,覆盖 V2Ray、Clash、sing-box、Nginx 等代理与网络工具,省去手动维护 IP 分流的麻烦。

核心能力

  • 每周四自动生成并发布多格式 GeoIP 文件
  • 提供 CLI 工具自行定制 GeoIP 数据文件
  • 输出 V2Ray dat、MaxMind mmdb、sing-box SRS、mihomo MRS 等格式
  • 生成 Clash、Surge ruleset 及 Nginx allow/deny 列表
  • 新增 cloudflare、google、netflix、telegram 等类别

容易踩的坑

dat 格式文件不能用于 Nginx,需按用途选对应格式;raw.githubusercontent.com 不可访问时改用 cdn.jsdelivr.net,再不行换 fastly.jsdelivr.net;使用前需先下载文件并放到程序目录内

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

最近发版

5 个版本202611050019
  1. 202611050019最新正式版2026-11-05 · 2026-11-05 00:20 UTC

    这个版本没有写更新说明。

  2. 2026110221362026-11-02 · 2026-11-02 21:38 UTC

    这个版本没有写更新说明。

  3. 2026102900222026-10-29 · 2026-10-29 00:23 UTC

    这个版本没有写更新说明。

  4. 2026102304452026-10-23 · 2026-10-23 04:46 UTC

    这个版本没有写更新说明。

  5. 2026102302522026-10-23 · 2026-10-23 02:53 UTC

    这个版本没有写更新说明。

用户点评

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

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

    README 原文

    未翻译

    名词解析

    GeoIP,意为 IP geographic location,即 IP 地址所对应的地理位置信息,例如所属的国家、地区等。GeoIP 数据文件则存储着 IP 地址所对应的地理位置信息。

    GeoIP, which stands for IP geographic location, refers to the geographic location information associated with an IP address, such as the country or region. And GeoIP data files store the geographic location information corresponding to IP addresses.

    项目简介

    本项目每周四自动生成多种格式 GeoIP 数据文件,同时提供命令行界面(CLI)工具供用户自行定制 GeoIP 数据文件,包括但不限于 V2Ray dat 格式文件 geoip.dat、MaxMind mmdb 格式文件 Country.mmdb(GeoIP2-Country.mmdb、GeoLite2-Country.mmdb)、sing-box SRS 格式文件、mihomo MRS 格式文件、Clash ruleset 规则文件、Surge ruleset 规则文件、Nginx allow list(允许访问列表)和 Nginx deny list(拒绝访问列表)。

    This project releases various formats of GeoIP files automatically every Thursday, and provides a command line interface (CLI) tool for users to customize their own GeoIP files, including but not limited to V2Ray dat format file geoip.dat, MaxMind mmdb format file Country.mmdb(GeoIP2-Country.mmdb, GeoLite2-Country.mmdb), sing-box SRS format file, mihomo MRS format file, Clash ruleset file, Surge ruleset file, Nginx allow list and Nginx deny list.

    GeoIP 类别

    本项目默认使用 MaxMind GeoLite2 Country CSV 数据生成各个国家和地区的 GeoIP 文件。类别有:

    • geoip:cn(GEOIP,CN):中国大陆(Mainland China)
    • geoip:hk(GEOIP,HK):香港(Hong Kong)
    • geoip:mo(GEOIP,MO):澳门(Macau)
    • geoip:tw(GEOIP,TW):台湾(Taiwan)
    • geoip:us(GEOIP,US):美国(America)
    • geoip:jp(GEOIP,JP):日本(Japan)
    • geoip:kr(GEOIP,KR):韩国(Korea)
    • geoip:sg(GEOIP,SG):新加坡(Singapore)
    • geoip:mm(GEOIP,MM):缅甸(Myanmar)
    • geoip:ir(GEOIP,IR):伊朗(Iran)
    • geoip:ru(GEOIP,RU):俄罗斯(Russia)
    • geoip:by(GEOIP,BY):白俄罗斯(Belarus)
    • geoip:tm(GEOIP,TM):土库曼斯坦(Turkmenistan)
    • geoip:private(GEOIP,PRIVATE):内网 IP 地址、保留 IP 地址等特殊 IP 地址的集合
    • 更多可用的类别(以两位英文字母表示国家或地区),请查看:https://www.iban.com/country-codes

    与 MaxMind 官方 GeoIP 数据的区别

    本项目对 MaxMind 官方 GeoIP 数据做了如下修改和新增:

    • 中国大陆 IPv4 地址数据使用 @gaoyifan/china-operator-ip
    • 中国大陆 IPv6 地址数据使用 @gaoyifan/china-operator-ip
    • 新增类别(方便有特殊需求的用户使用):
      • geoip:cloudflare(GEOIP,CLOUDFLARE)
      • geoip:cloudfront(GEOIP,CLOUDFRONT)
      • geoip:facebook(GEOIP,FACEBOOK)
      • geoip:fastly(GEOIP,FASTLY)
      • geoip:google(GEOIP,GOOGLE)
      • geoip:netflix(GEOIP,NETFLIX)
      • geoip:telegram(GEOIP,TELEGRAM)
      • geoip:twitter(GEOIP,TWITTER)
      • geoip:tor(GEOIP,TOR)

    下载地址与使用方法

    [!NOTE] 如果无法访问域名 raw.githubusercontent.com,可以使用第二个地址 cdn.jsdelivr.net。 如果无法访问域名 cdn.jsdelivr.net,可以将其替换为 fastly.jsdelivr.net。

    *.sha256sum 为校验文件。

    本项目发布的所有 GeoIP 文件,请查看 release 分支。以下是部分格式 GeoIP 文件的下载地址和使用方法:

    V2Ray dat 使用方法

    "routing": {
      "rules": [
        {
          "type": "field",
          "outboundTag": "Direct",
          "ip": [
            "geoip:cn",
            "geoip:private",
            "ext:cn.dat:cn",
            "ext:private.dat:private",
            "ext:geoip-only-cn-private.dat:cn",
            "ext:geoip-only-cn-private.dat:private"
          ]
        },
        {
          "type": "field",
          "outboundTag": "Proxy",
          "ip": [
            "geoip:us",
            "geoip:jp",
            "geoip:facebook",
            "geoip:telegram",
            "ext:geoip-asn.dat:facebook",
            "ext:geoip-asn.dat:telegram"
          ]
        }
      ]
    }
    
    geodata-mode: true
    geox-url:
      geoip: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/geoip.dat"
    
    direct(geoip:cn)
    proxy(geoip:telegram)
    proxy(geoip:us)
    
    "router": {
      "enabled": true,
      "bypass": ["geoip:cn"],
      "proxy": ["geoip:telegram", "geoip:us"],
      "block": ["geoip:jp"],
      "default_policy": "proxy",
      "geoip": "./geoip.dat"
    }
    

    点击前往查看:《吃鹅直通手册》


    V2Ray dat 下载地址

    适用于 V2Ray、Xray-core、mihomo、hysteria、Trojan-Go、dae。

    此 dat 格式文件不能用于 Nginx。

    所有国家/地区、新增类别的 dat 格式文件,请查看本项目 release 分支下的 dat 目录。

    部分国家/地区类别:

    新增类别:


    MaxMind mmdb 使用方法

    rules:
      - GEOIP,PRIVATE,policy,no-resolve
      - GEOIP,FACEBOOK,policy
      - GEOIP,CN,policy,no-resolve
    
    geodata-mode: false
    geox-url:
      mmdb: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/Country.mmdb"
      asn: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/GeoLite2-ASN.mmdb"
    
    [Rule]
    GEOIP,PRIVATE,DIRECT
    GEOIP,FACEBOOK,PROXY
    GEOIP,CN,DIRECT
    
    [filter_local]
    GEOIP,PRIVATE,DIRECT
    GEOIP,FACEBOOK,PROXY
    GEOIP,CN,DIRECT
    
    [Rule]
    GEOIP,PRIVATE,policy,no-resolve
    GEOIP,FACEBOOK,policy
    GEOIP,CN,policy,no-resolve
    

    MaxMind mmdb 下载地址

    1️⃣ 本项目生成的国家/地区类型 mmdb 文件:

    适用于 Clash、mihomo、Shadowrocket、Quantumult X、Surge。

    适用于 Nginx,需要配合 ngx_http_geoip2_module 模块使用。

    本项目生成的 mmdb 格式文件中,国家/地区类别保留了 Continent 和 Country 里的所有字段,新增类别和 GEOIP,PRIVATE 类别只保留了 Country 里的 iso_code(两位英文字母表示的国家/地区代号)字段。关于 Maxmind 官方 GeoIP2-Country.mmdb 和 GeoLite2-Country.mmdb 数据文件的完整字段,请查看代码。

    2️⃣ MaxMind 官方版国家/地区类型 mmdb 文件:

    适用于 Clash、mihomo、Shadowrocket、Quantumult X、Surge。

    适用于 Nginx,需要配合 ngx_http_geoip2_module 模块使用。

    3️⃣ MaxMind 官方版 ASN 类型 mmdb 文件:

    适用于 mihomo、Shadowrocket、Surge。


    sing-box SRS 使用方法

    "route": {
      "rules": [
        {
          "rule_set": "geoip-cn",
          "outbound": "direct"
        },
        {
          "rule_set": "geoip-us",
          "outbound": "block"
        }
      ],
      "rule_set": [
        {
          "tag": "geoip-cn",
          "type": "remote",
          "format": "binary",
          "url": "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/srs/cn.srs"
        },
        {
          "tag": "geoip-us",
          "type": "remote",
          "format": "binary",
          "url": "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/srs/us.srs"
        }
      ]
    }
    

    sing-box SRS 下载地址

    适用于 sing-box。

    所有国家/地区、新增类别的 SRS 格式文件,请查看本项目 release 分支下的 srs 目录。

    部分国家/地区类别:

    新增类别:


    mihomo MRS 使用方法

    rule-providers:
      cn-cidr:
        type: http
        behavior: ipcidr
        format: mrs
        url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/mrs/cn.mrs"
        path: ./mrs/geoip/cn.mrs
        interval: 86400
    
      google-cidr:
        type: http
        behavior: ipcidr
        format: mrs
        url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/mrs/google.mrs"
        path: ./mrs/geoip/google.mrs
        interval: 86400
    
    rules:
      - RULE-SET,cn-cidr,DIRECT
      - RULE-SET,google-cidr,PROXY,no-resolve
    

    mihomo MRS 下载地址

    适用于 mihomo。

    所有国家/地区、新增类别的 MRS 格式文件,请查看本项目 release 分支下的 mrs 目录。

    部分国家/地区类别:

    新增类别:


    Clash ruleset 使用方法

    rule-providers:
      cn-cidr:
        type: http
        behavior: ipcidr
        format: yaml
        url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/clash/ipcidr/cn.txt"
        path: ./ruleset/ipcidr/cn.yaml
        interval: 86400
    
      telegram-cidr:
        type: http
        behavior: ipcidr
        format: yaml
        url: "https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/clash/ipcidr/telegram.txt"
        path: ./ruleset/ipcidr/telegram.yaml
        interval: 86400
    
    rules:
      - RULE-SET,cn-cidr,DIRECT
      - RULE-SET,telegram-cidr,PROXY,no-resolve
    

    Clash ruleset 下载地址

    适用于 Clash Premium、mihomo。

    所有国家/地区、新增类别的 Clash ruleset 格式文件,请查看本项目 release 分支下的 clash 目录。

    部分国家/地区类别:

    新增类别:


    Surge ruleset 使用方法

    [Rule]
    RULE-SET,https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/surge/us.txt,REJECT
    RULE-SET,https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/surge/cn.txt,DIRECT
    RULE-SET,https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/surge/telegram.txt,PROXY,no-resolve
    

    Surge ruleset 下载地址

    适用于 Surge。

    所有国家/地区、新增类别的 Surge ruleset 格式文件,请查看本项目 release 分支下的 surge 目录。

    部分国家/地区类别:

    新增类别:


    Nginx allow 和 deny 格式文件

    所有国家/地区、新增类别的 Nginx allow 和 deny 格式文件,请查看本项目 release 分支下的 nginx 目录。


    纯文本 txt 格式文件

    所有国家/地区、新增类别的纯文本 txt 格式文件,请查看本项目 release 分支下的 text 目录。

    部分国家/地区类别: