Skip to main content

Automatic web server monitoring and defensive DoS/DDoS detection with blocking

Project description

webnetwork

webnetwork is a Python package that automatically monitors your web server traffic, detects DoS/DDoS attacks, and blocks malicious IPs in real-time. It supports Linux, Windows, and macOS servers.

Features

  • Automatic host IP detection
  • Web server log monitoring (Nginx, Apache)
  • Live packet sniffing for TCP/SYN floods
  • Automatic IP blocking (iptables on Linux/macOS, Windows firewall)
  • Cross-platform support
  • Minimal configuration required

Installation

pip install webnetwork

Usage

Fully Automatic

Automatically detects logs and interfaces:

import webnetwork

webnetwork.start()

Specify Logfile or Network Interface

import webnetwork

# Only monitor log file
webnetwork.start(logfile="/var/log/nginx/access.log")

# Only monitor network interface
webnetwork.start(iface="eth0")

# Monitor both
webnetwork.start(logfile="/var/log/nginx/access.log", iface="eth0")

Notes

  • Local blocking requires admin/root privileges.
  • Automatically tries to detect common log files (/var/log/nginx/access.log, /var/log/apache2/access.log, /var/log/httpd/access_log).
  • Live packet sniffing requires scapy and may need root/admin privileges.
  • Monitors traffic continuously and logs alerts to alerts.csv.

Configuration

Thresholds for detection can be tuned by modifying detector.py:

LOG_CHECK_INTERVAL = 1.0
WINDOW_SECONDS = 10
REQS_PER_IP_THRESHOLD = 50
TOTAL_RPS_THRESHOLD = 200
UNIQUE_IP_ENTROPY_THRESHOLD = 0.5
SYN_RATE_THRESHOLD = 100
SYN_TO_ACK_RATIO = 5.0

License

MIT License

Author

mrfidal – mrfidal@proton.me

Project details


Download files

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

Source Distribution

webnetwork-1.1.3.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

webnetwork-1.1.3-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file webnetwork-1.1.3.tar.gz.

File metadata

  • Download URL: webnetwork-1.1.3.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for webnetwork-1.1.3.tar.gz
Algorithm Hash digest
SHA256 1f779ba56820dfb28ce5872654653ebd8d9693c57fbeade148f93f736eae539c
MD5 cab100bf1cc5ad32002db31839834665
BLAKE2b-256 602e5b84e3b558759fed0e5a387b388a93bcc8dc3f474521962cecc25ea00506

See more details on using hashes here.

File details

Details for the file webnetwork-1.1.3-py3-none-any.whl.

File metadata

  • Download URL: webnetwork-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for webnetwork-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8acdc54fe5db7ed0fe53cb93492d8a0b9a07f540d094bce7e0192fd69baf8c60
MD5 0cac39c4e27e01298a517a5d6eeb9e0e
BLAKE2b-256 ec0ba6abb7d685c639bc7c4bcc7f0c2e1b7deaa3d0be3f8202638dfdddc75e22

See more details on using hashes here.

Supported by

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