BEACON is a Python3 layer-4 (D)DoS network monitor script with automatic attack vector detection, informative pcap json exports, highly-customizable Discord notifications, and more!
- Real-time network traffic monitoring
- Automatic DDoS attack detection
- Detailed attack statistics and analysis
- Discord notifications with rich embeds
- PCAP export and analysis
-
Clone repository
git clone https://github.com/AnabolicsAnonymous/BEACON cd BEACON -
Install Dependencies
pip install -r requirements.txt
-
Configure
- Copy
core/config.py.exampletocore/config.py - Update your Discord webhook URL
- Customize detection thresholds
- Copy
-
Run
python main.py
BEACON is highly customizable with Discord webhook payloads being drag and drop from Dischook with dynamic values easily customizable.
BEACON monitors for:
- High packet rates (PPS)
- Bandwidth spikes (Mbps)
- Common DDoS attack vectors
Receive rich notifications with:
- Attack vector details
- Source/destination IPs
- Packet statistics
- Timestamp and duration
- System metrics
- Python 3.8+
- scapy
- psutil
- requests
- Add post-attack external command execution
- Use a Discord bot instead of webhooks
- Make Discord attack notifications edit instead of reposting
- Rewrite monitor to constantly update instead of pausing then restarting
Licensed under the Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.
All issues and contributions are welcome, feel free to fix anything big or small or report issues or uncaught errors with a console log.
If you find this project useful, consider supporting it:
- Bitcoin:
bc1q7nxt23ahfluesy2kxgjdkqhh7qcc3gda6wmla5 - Ethereum:
0x24D898b1BA57BC8F5B510A841EeE8c75dcD8397d - USDC:
0x24D898b1BA57BC8F5B510A841EeE8c75dcD8397d - Litecoin:
LL2pHmU4tYvKUCcBem3ehdrFeeuQuGbWNX