metacubex/geo

🗺An easy way to manage all your Geo resources. Available as both a CLI and a Go library.

geo

🗺An easy way to manage all your Geo resources.

Support GeoIP/GeoSite code lookup and converting among all popular GeoIP/GeoSite databases.

Install

Requirements:

• Go 1.20+

go install -v github.com/metacubex/geo/cmd/geo@master

Usage

Type geo help for more details.

Look up codes from existing Geo databases

The default directory to find Geo databases is ~/.geo. You can specify it through -D argument.

IP

geo look 223.5.5.5

geo look 2001:250::

Site

geo look example.com

geo look --no-resolve example.com

Supported databases for look command:

• MaxMind MMDB
• V2Ray dat GeoIP/GeoSite
• sing-geosite
• sing-geoip MMDB
• Meta-geoip MMDB

Convert

IP

geo convert ip -i <input_type> -o <output_type> -f [output_filename] input_filename

geo convert ip -i v2ray -o meta ./geoip.dat

Available types:

• MaxMind (MMDB)
• V2Ray-geoip (dat)
• sing-geoip (MMDB)
• Meta-geoip (MMDB)

Supported conversion pairs: (Column=From, Row=To)

	MaxMind	V2Ray-geoip	sing-geoip	Meta-geoip
MaxMind	-
V2Ray		-
sing-geoip	✅	✅	-	✅
Meta-geoip		✅		-

Conversion to MaxMind is not available for legal reasons.
Conversion to V2Ray is on the TODO list.

Site

geo convert site -i <input_type> -o <output_type> -f [output_filename] -c [country code] input_filename

geo convert site -i v2ray -o sing ./geosite.dat

Only v2ray -> sing conversion is supported for GeoSite.

Unpack

site

geo unpack site ./geosite.dat -d output -c cn

• -d output dir
• -c code (optional, unpack all geosite if not set)

Frequently Asked Questions (FAQ)

Why conversion MaxMind/sing-geoip -> Meta-geoip is not available?

Meta-geoip is designed to support IP with multiple results, which will help users who use GeoIP functionality as IPList or IPSet.

For sources such as MaxMind and sing-geoip, which only have a single possible result, according to the principle of Occam's razor, there is no need to convert to Meta-geoip database.
In the other hand, when there is only a single result, the data structure of Meta-geoip and sing-geoip is completely consistent, and even compatible with the parsing logic.

Clash.Meta supports all of these databases, so everything is well. :-)

geo's Issues

geo look ip 没有显示全部的 GeoIP codes

geoip.dat 来自 https://github.com/peeweep/geoip/releases/tag/202401111336
223.119.50.147 同时在 GEOIP,CMI (223.118.0.0/15) 和 GEOIP,CN (223.64.0.0/10) 中，使用其他工具比如 clash-meta 两个都可以匹配到，但是 geo look 只返回了 CN

实际结果

$ geo look 223.119.50.147 
🔎Querying from [/home/peeweep/.geo/geoip.dat]
🎉Query finished in 46.96831ms!
Total 1 results (GeoIP codes):
  CN %  

期望结果:

$ geo look 223.119.50.147 
🔎Querying from [/home/peeweep/.geo/geoip.dat]
🎉Query finished in 46.96831ms!
Total 2 results (GeoIP codes):
  CMI CN %