Skip to main content

A Django app to block the IP addresses which sends too many hits to your application

Project description


This is a simple Django app to block the IP addresses which sends too many hits to your application.
You can decide the number of hits that are allowed per IP address in defined time.

Quick start

1. Add "django_bot_crawler_blocker" to your INSTALLED_APPS setting like this::


2. Add 'CrawlerBlockerMiddleware' to your middleware classes in file::


'CrawlerBlockerMiddleware' can be and should be first middleware as we need to make sure IP check is the very first
thing in processing request.

3. If cache settings are not defined in your file, then you need to add below lines to your file::

'default': {
'BACKEND': 'django.core.cache.backends.db.DatabaseCache',
'LOCATION': 'cache_table',

Make sure you have database settings configured. Run the below command to create cache_table in database::

'python createcachetable'

You may choose whatever cache backend you want to use.

4. (optional) Set variables in MAX_ALLOWED_HITS_PER_IP and IP_HITS_TIMEOUT in file::

MAX_ALLOWED_HITS_PER_IP = 2000 # max allowed hits per IP_TIMEOUT time from an IP. Default 2000.
IP_HITS_TIMEOUT = 60 # timeout in seconds for IP in cache. Default 60.

To test on local system, set these values to very low, e.g. IP_HITS_TIMEOUT = 30 and MAX_ALLOWED_HITS_PER_IP = 2.
Restart the server and send requests frequently. After two requests you will start receiving 403 error.
If not defined in settings file, default values will be used.

5. In case of any query or issue, please feel free to reach out to me. Email provided in MANIFEST file.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-bot-crawler-blocker-1.0.tar.gz (3.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page