cidre-cli 1.0.6

A CLI tool for fetching and managing CIDR IP ranges from RIRs with firewall integration.

CIDRe is a CLI tool that fetches daily updated IP allocations from Regional Internet Registries (RIRs), compiles them into country-based CIDR files, and allows easy firewall management (e.g., blocking entire countries in UFW).

🔹 Supports AFRINIC, APNIC, ARIN, LACNIC, RIPE NCC
🔹 Merges and optimizes CIDR blocks for efficiency
🔹 Firewall integration (UFW support)
🔹 IPv4 & IPv6 compatible

---

⚡ Quick Start

1️⃣ Install CIDRE

pip install cidre-cli

2️⃣ Pull & Merge CIDR Ranges

cidre pull --merge

• Downloads the latest CIDR allocations from RIRs.
• Merges overlapping IP ranges for efficiency.

3️⃣ Block Specific Countries in UFW

cidre deny ru ir kp

• Blocks Russia (RU), Iran (IR), and North Korea (KP) in UFW.
• Requires UFW installed (sudo apt install ufw).

4️⃣ Allow Specific Countries in UFW

cidre allow us gb de

• Allows United States (US), United Kingdom (GB), and Germany (DE) IPs in UFW.

5️⃣ Reject (Drop) Traffic from Specific Countries

cidre reject cn ru

• Rejects (drops) traffic from China (CN) and Russia (RU).

---

🚀 Features

• Daily automatic CIDR updates.
• Compiles CIDR blocks per country from RIR allocation data.
• Merges overlapping IP ranges for efficiency.
• Allows easy firewall rules for blocking or allowing entire countries.
• Supports both IPv4 & IPv6.

---

🛠️ Installation

1️⃣ Install via PyPI

pip install cidre-cli

2️⃣ Alternative: Clone the Repository

git clone https://github.com/vulnebify/cidre.git
cd cidre
python3 -m venv .venv
source .venv/bin/activate
pip install .

---

⚡ Usage

1️⃣ Pull and Compile CIDR Ranges

Fetches the latest IP allocation data from all RIRs and compiles per-country CIDR blocks:

cidre pull --merge

• --merge: Merges overlapping IP ranges for efficiency.
• --proxy <proxy>: Proxies connection to RIRs.
• --store <path>: Specifies a custom storage directory.
• Output Example:
  • output/cidr/ipv4/us.cidr (United States IPv4 ranges)
  • output/cidr/ipv6/de.cidr (Germany IPv6 ranges)

2️⃣ Block Entire Countries with UFW

Block specific countries' CIDR blocks in UFW firewall:

cidre deny ru ir kp

• Blocks Russia (RU), Iran (IR), and North Korea (KP) in the Uncomplicated Firewall (UFW).
• Requires UFW installed (sudo apt install ufw on Debian/Ubuntu).

3️⃣ Allow Specific Countries

cidre allow us gb de

• Allows United States (US), United Kingdom (GB), and Germany (DE) IPs in UFW.

4️⃣ Reject (Drop) Traffic from Specific Countries

cidre reject cn ru

• Rejects (drops) traffic from China (CN) and Russia (RU).

---

📄 License

This project is licensed under the MIT License.

---

🙌 Inspired By

CIDRE was inspired by herrbischoff/country-ip-blocks and aims to provide an automated alternative with firewall integration.

---

🤝 Contributions

PRs are welcome! Feel free to fork the repo and submit pull requests.

---

📧 Contact

For any questions, open an issue or reach out via GitHub Discussions.