From ff2944eca046b6cbdc1a2ac65f286f881d76396e Mon Sep 17 00:00:00 2001 From: trick77 Date: Fri, 23 Jan 2026 20:20:03 +0100 Subject: [PATCH] Update README.md --- README.md | 38 +++++++++++++++++++------------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 2b060b9c2..caeb405eb 100644 --- a/README.md +++ b/README.md @@ -4,18 +4,22 @@ ## 🔍 Try it online -Look up any IP address or prefix at **[Lens by ipverse](https://lens.ipverse.net)** to see its country delegation and AS information. +Look up any IP address or prefix at **[Lens by ipverse](https://lens.ipverse.net)** to see its country and AS information. ## Overview -Ready-to-use IPv4 and IPv6 prefixes delegated to countries (ISO 3166-1 alpha-2), sourced from all five regional internet registries (RIR). +Ready-to-use IPv4 and IPv6 prefixes by country (ISO 3166-1 alpha-2), sourced from all five regional internet registries (RIR). Aggregated and updated daily. -This dataset saves you from parsing RIR delegation files yourself - the prefixes are aggregated and ready to drop into firewalls, access control lists, or geo-routing configurations. -Updated daily when the underlying RIR data changes, so you always have current allocations. +## 📍 Need more accurate geolocation? -> **Note:** This data shows which country an IP range is *delegated to* by the RIRs. While it can be used for country-level blocking and compliance, it has limitations - delegated IPs can be used in other countries or routed globally. For pinpoint geolocation (city-level, actual user location), you'll need a dedicated geolocation service. +This dataset shows where IP ranges are officially *delegated* - useful for administrative and regulatory purposes. For more accurate operational geolocation based on actual network assignments, check out **[geo-ip-blocks](https://github.com/ipverse/geo-ip-blocks)**. -Available formats: JSON and plaintext +| Dataset | Best for | +|---------|----------| +| [country-ip-blocks](https://github.com/ipverse/country-ip-blocks) | Administrative/regulatory use cases | +| [geo-ip-blocks](https://github.com/ipverse/geo-ip-blocks) | Operational geolocation | + +## Formats **JSON format**: ```json @@ -50,16 +54,9 @@ Available formats: JSON and plaintext 2a01:fb00::/29 ``` -## Recent changes - -- **2026-01-17**: Added bulk download archive in [releases](https://github.com/ipverse/country-ip-blocks/releases/latest) -- **2026-01-03**: Repo renamed from `rir-ip` to `country-ip-blocks` and JSON format updated to use camelCase. Check [MIGRATION.md](MIGRATION.md) if you're already using this data. -- 2025-05-04: Removed country code EU (non-standard code that RIPE only kept for historical reasons) - ## How to use -Download the delegated networks for a specific country (Andorra in these examples): - +Download prefixes for a specific country (Andorra in these examples): **Andorra in JSON format:** ```bash @@ -86,16 +83,19 @@ tar -xzf country-ip-blocks.tar.gz ### Want more granular control? -Instead of blocking an entire geographic region, it might be more effective to block specific internet providers based -on their autonomous system number (ASN). Check out [as-ip-blocks](https://github.com/ipverse/as-ip-blocks) for more information. +Instead of blocking an entire geographic region, it might be more effective to block specific internet providers based on their autonomous system number (ASN). Check out [as-ip-blocks](https://github.com/ipverse/as-ip-blocks) for more information. ## Use cases -- Block entire countries at the firewall (for compliance or security reasons) +- Block countries at the firewall (for compliance or security reasons) - Geo-based access control and traffic routing - Network research and statistical analysis - Threat hunting and security research -- Figure out which IPs are delegated to specific countries -- Pretty much anything where you need to map country codes to their delegated networks + +## Recent changes + +- **2026-01-17**: Added bulk download archive in [releases](https://github.com/ipverse/country-ip-blocks/releases/latest) +- **2026-01-03**: Repo renamed from `rir-ip` to `country-ip-blocks` and JSON format updated to use camelCase. Check [MIGRATION.md](MIGRATION.md) if you're already using this data. +- 2025-05-04: Removed country code EU (non-standard code that RIPE only kept for historical reasons) ## Questions or issues?