Skip to content

cl3m4x1l/IPbandit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

313 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

IPbandit is a tool that protects you from malicious IP addresses and CIDR blocks (IPv4/IPv6).
IPbandit aggregates several blacklists created by the community. You can select your lists, add or delete them, and even create your own blacklists to block entire countries, for example.

It's an aggregation of lists of malicious IP addresses to integrate with your firewalls. Examples : Fortinet FortiGate, Palo Alto, pfSense, OPNsense, iptables, NFtables, etc...

Using the default lists, you'll already block approximately 300,000 malicious IP addresses.

Designed to improve the security of your critical servers. Secure your Linux infrastructure : RHEL, Centos, AlmaLinux, Rocky Linux, SUSE, openSUSE, Debian, Ubuntu, Alpine Linux, Gentoo, NixOS, Arch Linux and the others.

this Version 1.1.0 Alpha

Licence

IPbandit is free and open-source software licensed under the GNU General Public License v3.0 (GPLv3).
You are free to use, modify, and distribute this software in compliance with the license terms. See the LICENSE file for more details.

Roadmap

  • 2026-01 Init project, share on github
  • 2026-02 Add IPv6, add custom config file
  • 2026-03 Add Fail2ban extras option, version Nightly
  • 2026-04 Version 1.0 Beta
  • 2026-05 Version 1.0 Release Candidate
  • 2026-06 Version 1.0 Stable
  • coming soon, IPV6::/64 and clean IPV4 file if is containt to Subnet file
  • coming soon, extras option Ipset / Iptables / Nftables

Logs

Changes for this edition 1.1.0

  • Rename file: Subnet to CIDR
  • Convert IPv6 only CIDR/64
  • Add white list
  • Coming soon: filter IPv4 for deletion if included in the CIDR file

HOW TO

You can use our lists generated directly from our web servers (default configuration) without installation.
Download the following files directly

Requirements

You must have curl, sipcacl to install

Install

Git clone project

mkdir /opt/clemaxil
cd /opt/clemaxil/
git clone https://github.com/cl3m4x1l/IPbandit.git

Or download zip with wget

mkdir /opt/clemaxil
cd /opt/clemaxil/
wget https://github.com/cl3m4x1l/IPbandit/archive/refs/heads/main.zip
unzip main.zip 
mv IPbandit-main IPbandit

Access rights

Navigate to the parent directory

chown -R root:root /opt/clemaxil/IPbandit
cd /opt/clemaxil/IPbandit
chmod +x IPbandit.sh extras/aggregator.sh extras/fail2ban.sh

Run

You can choose to run the script manually.

cd /opt/clemaxil/IPbandit/
./IPbandit.sh --aggregator

Automate it using cron.

You can use crontab -e,

crontab -e

Add this line, and adjust time

30 05 * * * nice -n 10 /opt/clemaxil/IPbandit/IPbandit.sh --aggregator >/dev/null 2>&1

Or creating a file in /etc/cron.d.

nano /etc/crond.d/IPbandit

Add this line, and adjust time

30 05 * * * root nice -n 10 /opt/clemaxil/IPbandit/IPbandit.sh --aggregator >/dev/null 2>&1

With full options (see extras section)

30 05 * * * root nice -n 10 /opt/clemaxil/IPbandit/IPbandit.sh --fail2ban --aggregator >/dev/null 2>&1

Results

After execution, you will find the generated files in IPbandit/list.d directory, which you can then use for your services.

  • IPbandit_all.txt
  • IPbandit_ipv4.txt
  • IPbandit_ipv4_subnet.txt
  • IPbandit_ipv6.txt
  • IPbandit_ipv6_subnet.txt

CUSTOMIZE

Note: IPdeny offers free downloads of GEO IP address blocks by country. You can add a list of IP addresses from a country to this directory. https://www.ipdeny.com/ipblocks/

Personnal lists

You can add your own lists to the extras/list.d directory. Important ! Name your files with the .list extension.

External lists

You can choose which lists to download by editing the IPbandit_custom.txt file.

EXTRAS

Fail2ban

You can retrieve the list of IPs detected by fail2ban on your machine.

The Ips will be written in the files extras/list.d/myfail2ban.list.\ This file will then be imported directly by IPbandit.

You can run the scriptextras/fail2ban.sh separately

cd /opt/clemaxil/IPbandit/extras/
./fail2ban.sh 

or with the IPbandit options.

cd /opt/clemaxil/IPbandit/
./IPbandit.sh --fail2ban

Ipset, Iptables, Nftables... Coming soon ....