dat 格式文件不能用于 Nginx,需按用途选对应格式;raw.githubusercontent.com 不可访问时改用 cdn.jsdelivr.net,再不行换 fastly.jsdelivr.net;使用前需先下载文件并放到程序目录内
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.
https://raw.githubusercontent.com/Loyalsoldier/geoip/release/geoip.dat
https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/geoip.datREADME 未说明
每周自动生成并可用 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 等类别
容易踩的坑
- 202611050019最新正式版2026-11-05 · 2026-11-05 00:20 UTC
这个版本没有写更新说明。
- 2026110221362026-11-02 · 2026-11-02 21:38 UTC
这个版本没有写更新说明。
- 2026102900222026-10-29 · 2026-10-29 00:23 UTC
这个版本没有写更新说明。
- 2026102304452026-10-23 · 2026-10-23 04:46 UTC
这个版本没有写更新说明。
- 2026102302522026-10-23 · 2026-10-23 02:53 UTC
这个版本没有写更新说明。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
名词解析
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 下载地址
此 dat 格式文件不能用于 Nginx。
所有国家/地区、新增类别的 dat 格式文件,请查看本项目 release 分支下的 dat 目录。
- geoip.dat:
- geoip.dat.sha256sum:
- geoip-only-cn-private.dat(精简版 GeoIP,只包含
geoip:cn和geoip:private): - geoip-only-cn-private.dat.sha256sum:
- geoip-asn.dat(精简版 GeoIP,只包含上述新增类别):
- geoip-asn.dat.sha256sum:
- cn.dat(精简版 GeoIP,只包含
geoip:cn): - cn.dat.sha256sum:
- private.dat(精简版 GeoIP,只包含
geoip:private): - private.dat.sha256sum:
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):
- 白俄罗斯(Belarus):
- 土库曼斯坦(Turkmenistan):
新增类别:
- cloudflare:
- cloudfront:
- facebook:
- fastly:
- google:
- netflix:
- telegram:
- twitter:
- tor:
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 文件:
适用于 Nginx,需要配合 ngx_http_geoip2_module 模块使用。
本项目生成的 mmdb 格式文件中,国家/地区类别保留了
Continent和Country里的所有字段,新增类别和GEOIP,PRIVATE类别只保留了Country里的iso_code(两位英文字母表示的国家/地区代号)字段。关于 Maxmind 官方GeoIP2-Country.mmdb和GeoLite2-Country.mmdb数据文件的完整字段,请查看代码。
- Country-without-asn.mmdb(传统版 GeoIP,只包含国家/地区类别和
GEOIP,PRIVATE类别,不包含上述新增类别。建议优先使用): - Country-without-asn.mmdb.sha256sum:
- Country.mmdb(增强版 GeoIP,包含国家/地区类别、
GEOIP,PRIVATE类别,以及上述新增类别。但由于 MaxMind mmdb 格式限制,部分国家/地区类别的 IP 地址数据不如上述 Country-without-asn.mmdb 准确): - Country.mmdb.sha256sum:
- Country-only-cn-private.mmdb(精简版 GeoIP,只包含
GEOIP,CN和GEOIP,PRIVATE): - Country-only-cn-private.mmdb.sha256sum:
- Country-asn.mmdb(精简版 GeoIP,只包含上述新增类别):
- Country-asn.mmdb.sha256sum:
2️⃣ MaxMind 官方版国家/地区类型 mmdb 文件:
适用于 Nginx,需要配合 ngx_http_geoip2_module 模块使用。
- GeoLite2-Country.mmdb:
- GeoLite2-Country.mmdb.sha256sum:
3️⃣ MaxMind 官方版 ASN 类型 mmdb 文件:
适用于 mihomo、Shadowrocket、Surge。
- GeoLite2-ASN.mmdb:
- GeoLite2-ASN.mmdb.sha256sum:
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 目录。
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):
- 白俄罗斯(Belarus):
- 土库曼斯坦(Turkmenistan):
新增类别:
- cloudflare:
- cloudfront:
- facebook:
- fastly:
- google:
- netflix:
- telegram:
- twitter:
- tor:
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 目录。
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):
- 白俄罗斯(Belarus):
- 土库曼斯坦(Turkmenistan):
新增类别:
- cloudflare:
- cloudfront:
- facebook:
- fastly:
- google:
- netflix:
- telegram:
- twitter:
- tor:
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 目录。
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):
- 白俄罗斯(Belarus):
- 土库曼斯坦(Turkmenistan):
新增类别:
- cloudflare:
- cloudfront:
- facebook:
- fastly:
- google:
- netflix:
- telegram:
- twitter:
- tor:
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 目录。
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):
- 白俄罗斯(Belarus):
- 土库曼斯坦(Turkmenistan):
新增类别:
- cloudflare:
- cloudfront:
- facebook:
- fastly:
- google:
- netflix:
- telegram:
- twitter:
- tor:
Nginx allow 和 deny 格式文件
所有国家/地区、新增类别的 Nginx allow 和 deny 格式文件,请查看本项目 release 分支下的 nginx 目录。
纯文本 txt 格式文件
所有国家/地区、新增类别的纯文本 txt 格式文件,请查看本项目 release 分支下的 text 目录。
部分国家/地区类别:
- 中国大陆(Mainland China):
- 香港(Hong Kong):
- 澳门(Macau):
- 台湾(Taiwan):
- 美国(America):
- 日本(Japan):
- 韩国(Korea):
- 新加坡(Singapore):
- 缅甸(Myanmar):
- 伊朗(Iran):
- 俄罗斯(Russia):