lionsoul2014/ip2region

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

19468 stars · 3048 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

ip2region is an offline IP-to-region localization library and IP data management framework supporting both IPv4 and IPv6 with city-level results and 10-microsecond query performance. It ships an xdb data storage engine with search clients for 10+ programming languages and tools to generate and manage custom IP location data.

Use cases

• look up the country, province, city and ISP of an IP address offline
• resolve visitor IP locations in a web backend without external API calls
• convert IPv4 and IPv6 addresses to region info with microsecond latency
• manage and generate custom IP geolocation datasets in xdb format
• embed IP location lookup in a Go, Java, Python or PHP service
• avoid third-party geolocation API rate limits and privacy concerns

When to choose

• you need fast, offline IP-to-region lookup with no network dependency
• you need both IPv4 and IPv6 support from one unified API
• you want bindings for many languages or a custom IP data management framework
• you need city-level accuracy for China with Chinese-language region data

When to avoid

• you need street-level or GPS-precise geolocation
• you require constantly updated commercial-grade accuracy without buying the paid data
• you need rich metadata like ASN or timezone from the free dataset out of the box

Facets

library · maturity stable

search-engine database sdk developer-tools networking developer-tools apis security analytics cross-platform go python jvm php rust cpp c lua dotnet elixir ip-geolocation offline-lookup ipv4 ipv6 xdb-format ip-database geoip javascript nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="lionsoul2014/ip2region")