# alecthw/mmdb_china_ip_list

Geoip MaxMind Database for china ip list! This is also an example of generating  MaxMind Database!

Repository: https://github.com/alecthw/mmdb_china_ip_list
Canonical: https://ross.abutalabs.com/products/mmdb_china_ip_list
Language: Go
License: MIT
License Family: permissive
Topics: geoip, geoip2, maxmind, mmdb, china, clash, openclash
Last push: 2026-08-25T19:12:39+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 2299, "days_push": 8, "days_rel": 10, "gap_med": 7, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1134, forks 87 (observed 2026-08-28T04:03:43.091547+00:00)

## What it is
A regularly rebuilt MaxMind GeoIP database (Country.mmdb) that merges multiple community-maintained China IP lists (china_ip_list, Chunzhen CN, Clang.cn, china-operator-ip, CloudCN) into the official MaxMind GeoLite2 data. It is also an example of how to generate MaxMind DB files, with full and lite variants published weekly.

## Use cases
- improve china ip matching in clash or openclash
- get a maxmind country.mmdb with accurate china ip ranges
- replace openclash country.mmdb with a better china geoip database
- generate a custom maxmind mmdb database from ip lists
- geoip lookup for chinese ip addresses
- download a lite mmdb with only iso codes for smaller size

## When to choose
- you use Clash/OpenClash or similar proxy tools and need reliable China IP splitting
- you need a MaxMind-compatible mmdb with better China coverage than GeoLite2
- you want an automatically updated weekly geoip database with fixed download URLs

## When to avoid
- you need detailed city-level or ASN geolocation data
- you need accurate geolocation outside China
- you need a general-purpose geoip service with commercial support

## Facets
- artifact type: dataset
- maturity: active
- function: search-engine, developer-tools
- domain: networking, security, developer-tools
- platform: cross-platform, cli
- tags: geoip, maxmind, mmdb, china-ip-list, clash, openclash, ip-geolocation, network-splitting

## Member repositories
- alecthw/mmdb_china_ip_list (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:43.091547+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-30T06:36:53.998744+00:00, confidence not recorded.
  - readme: https://github.com/alecthw/mmdb_china_ip_list (fetched 2026-08-28T04:03:43.091547+00:00, sha 018b392e9123)
- Data as of 2026-08-30T08:39:29.467469+00:00.