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

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.4.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.4-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webnetwork-1.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 8861f757a1101710fcef749e6c7ba5af89855ab5eedc43469a159b7700b11baa
MD5 37a3c7df377557c97b3cd3dda64a9828
BLAKE2b-256 31ed06301e7d9892ae03e6ef731332a404bf6b835832c37d946c5518b3757510

See more details on using hashes here.

File details

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

File metadata

  • Download URL: webnetwork-1.1.4-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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a9d605b3966e2e5e46e0e3174568ebdadcc0cdca9a7adc3fd5c942dfc929cc06
MD5 20e0a95f1badc7497e18a1cc637815d5
BLAKE2b-256 a0e4509044cae4c01d9ffa3f1ba0d5197ae5b25ca10d7636821b5cfb568ed1ed

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