# lionsoul2014/ip2region

Ip2region is an offline IP-to-Region localization library and IP data management framework with both IPv4 and IPv6 supports, 10-microsecond level query efficiency, xdb search client for many programming languages

Repository: https://github.com/lionsoul2014/ip2region
Canonical: https://ross.abutalabs.com/products/ip2region
Homepage: https://ip2region.net
Language: Go
License: NOASSERTION
License Family: other
Topics: ip-address, ip-lookup, ip-location, ip-address-database, ip-address-location, xdb-engine, ipv4-address, ipv4-lookup, ipv6-address, ipv6-lookup, xdb-ipv4, xdb-ipv6, ipv4-support, ipv6-support
Last push: 2026-08-14T05:46:55+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 92, longevity 100
- inputs: {"age_days": 3958, "days_push": 19, "days_rel": 55, "gap_med": 5, "n_releases_24m": 24}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 19468, forks 3048 (observed 2026-08-28T04:11:28.687348+00:00)

## What it is
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
- artifact type: library
- maturity: stable
- function: search-engine, database, sdk, developer-tools
- domain: networking, developer-tools, apis, security, analytics
- platform: cross-platform, go, python, jvm, php, rust, cpp, c, lua, dotnet, elixir
- tags: ip-geolocation, offline-lookup, ipv4, ipv6, xdb-format, ip-database, geoip, javascript, nodejs

## Member repositories
- lionsoul2014/ip2region (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:28.687348+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:00:06.430471+00:00, confidence not recorded.
  - readme: https://github.com/lionsoul2014/ip2region (fetched 2026-08-28T04:11:28.687348+00:00, sha b97c86da40cb)
  - homepage: https://ip2region.net (fetched 2026-08-29T07:58:31.919879+00:00, sha c14b6fb965dd)
  - site_page: https://ip2region.net/about/intro (fetched 2026-08-29T07:58:31.929131+00:00, sha d2bf1bd829dd)
  - site_page: https://ip2region.net/about/service (fetched 2026-08-29T07:58:31.931223+00:00, sha 3f764506f276)
  - site_page: https://ip2region.net/about/privacy (fetched 2026-08-29T07:58:31.934117+00:00, sha 73cab8240ddd)
- Data as of 2026-08-30T08:39:29.467469+00:00.