gordon/country-ip-blocks2
1
0
Fork 0
mirror of https://github.com/ipverse/country-ip-blocks.git synced 2026-04-22 00:24:53 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
trick77
2026-01-23 20:20:03 +01:00
parent 4d5bfb3966
commit ff2944eca0
1 changed files with 19 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@@ -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?