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.2.tar.gz (4.5 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.2-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webnetwork-1.1.2.tar.gz
  • Upload date:
  • Size: 4.5 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.2.tar.gz
Algorithm Hash digest
SHA256 e7b28f14ca4c95a60f46401599a55d8dbab8246b271e9f1a3bad68988dfac5c8
MD5 075409aab401cce4b9c6b1f4f521ed99
BLAKE2b-256 c807c9798f91c18ca962d220044fde12f78119677f1f3187a1deb39a270533ce

See more details on using hashes here.

File details

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

File metadata

  • Download URL: webnetwork-1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 5.3 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3de4bc877d0b8c09ebd43320cab610918d901526ee8b06e2170c48ebcc077bed
MD5 b7314247679e3649e04bfb893a832c2b
BLAKE2b-256 c00383cc63290ad622c029d92cc16db7f747b02d9e9f5b859e26d5148fa8946e

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