# ymyuuu/IPDB

Cloudflare反代优选IP库

Repository: https://github.com/ymyuuu/IPDB
Canonical: https://ross.abutalabs.com/products/ipdb
Homepage: https://ipdb.030101.xyz
License: MIT
License Family: permissive
Last push: 2026-08-23T08:19:47+00:00

## Health v2 (maintenance only)
Score: 71/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 35, longevity 73
- inputs: {"age_days": 1024, "days_push": 10, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2554, forks 804 (observed 2026-08-28T04:07:00.658678+00:00)

## What it is
IPDB is a hosted API service that provides curated lists of Cloudflare official and reverse-proxy (preferred) IP addresses, updated in real time or on 30-60 minute cycles. It exposes a simple HTTP API with optional geolocation info and file downloads, helping users pick faster, more stable Cloudflare endpoints.

## Use cases
- get a list of Cloudflare IPv4 and IPv6 addresses
- fetch optimized Cloudflare reverse proxy IPs for faster access
- download preferred Cloudflare IP lists with country geolocation info
- find the best Cloudflare endpoints for a custom domain CNAME setup
- periodically refresh proxy IP lists for a proxy client configuration

## When to choose
- you need up-to-date Cloudflare official or preferred proxy IP lists via a simple API
- you want geolocation-tagged IP lists for endpoint selection
- you need a maintained source of Cloudflare ranges updated in near real time

## When to avoid
- you need a self-hosted IP database with full control over data sources
- you require guaranteed SLA or absolute data accuracy
- your use case involves mainland China users unwilling to accept the stated legal risks

## Facets
- artifact type: service
- maturity: active
- function: networking, proxy, api-framework, search-engine
- domain: networking, cloud-computing, censorship-circumvention, apis
- platform: cloud, self-hosted
- tags: cloudflare, ip-database, preferred-ip, reverse-proxy-ip, cdn-optimization, ip-lists, api, web-server

## Member repositories
- ymyuuu/IPDB (main) score 71

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:00.658678+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-30T02:23:45.452776+00:00, confidence not recorded.
  - readme: https://github.com/ymyuuu/IPDB (fetched 2026-08-28T04:07:00.658678+00:00, sha 9a5aa47cf5e3)
  - homepage: https://ipdb.030101.xyz (fetched 2026-08-29T10:06:43.776041+00:00, sha c4ec2f00328e)
- Data as of 2026-08-30T08:39:29.467469+00:00.