🌐 DDoS Tool - Network Stress Testing Framework

A lightweight network stress testing tool for security research and education

---

⚠️ DISCLAIMER

FOR EDUCATIONAL PURPOSES ONLY

• Unauthorized use is ILLEGAL
• Only use on systems you OWN or have EXPLICIT PERMISSION to test
• The user assumes ALL RESPONSIBILITY for any misuse
• The author disclaims ALL LIABILITY

---

✨ Features

• 🔄 3 Attack Methods: TCP, UDP, HTTP floods
• 🧵 Multi-threading: Configurable thread count (default: 50)
• ⏱️ Time Control: Set duration in seconds or run unlimited
• 📊 Request Limiting: Exact number of requests
• 📈 Real-time Stats: Live monitoring with success rates
• 🎯 Progress Tracking: Percentage completion
• 🚀 No Dependencies: Uses only Python standard library

---

📦 Requirements

• Python 3.6+
• No external dependencies

# Verify Python version
python --version

# Verify all modules available
python -c "import socket, threading, time, sys, random, string, argparse; print('✅ Ready')"

---

🚀 Installation

# clone repository
git clone https://github.com/TranMinhCuong-Tech/ddos.git
cd ddos

# Make executable (Linux/macOS)
chmod +x ddos.py

---

💻 Usage

Command Syntax

python ddos_tool.py -u <TARGET> -p <PORT> [OPTIONS]

Arguments

Argument	Description	Default
-u, --url	Target URL or IP	Required
-p, --port	Target port	Required
-t, --threads	Number of threads	50
-d, --duration	Attack duration (seconds)	Unlimited (-1)
-r, --request	Number of requests	0 (Unlimited)
-m, --method	Attack method	tcp
-h, --help	Show help	-

Attack Methods

Method	Protocol	Best For
tcp	TCP	Web servers, databases
udp	UDP	DNS, gaming servers
http	HTTP	Web applications, APIs

---

📝 Examples

Basic Attacks

# TCP attack with 100 threads for 30 seconds
python ddos_tool.py -u 192.168.1.1 -p 80 -t 100 -d 30 -m tcp

# UDP attack (unlimited)
python ddos_tool.py -u 192.168.1.1 -p 53 -t 50 -m udp

# HTTP attack with 5000 requests
python ddos_tool.py -u example.com -p 80 -t 20 -r 5000 -m http

Advanced Scenarios

# Combined time and request limits
python ddos_tool.py -u 192.168.1.1 -p 80 -d 60 -r 5000 -m tcp

# High-thread continuous attack
python ddos_tool.py -u 192.168.1.1 -p 80 -t 200 -m http

# Precision testing with exact count
python ddos_tool.py -u example.com -p 443 -t 10 -r 1000 -m http

---

📊 Output Example

Real-time Statistics

Time: 15.3s | Sent: 245/s | Failed: 5/s | Total Success: 3670 | Total Failed: 75 | Success Rate: 98.0% | Progress: 36.7%

Final Statistics

======================================================================
FINAL STATISTICS
======================================================================
Target Requests: 10000
Run Time: 45.2 seconds
Total Requests Sent: 10000
Total Requests Failed: 127
Success Rate: 98.7%
Average Speed: 221.2 requests/second
======================================================================

Output Fields

Field	Description
Time	Elapsed attack duration
Sent/s	Current requests per second
Failed/s	Current failures per second
Total Success	Cumulative successful requests
Total Failed	Cumulative failed requests
Success Rate	Percentage of successful requests
Progress	Completion percentage (with -r)

---

⚙️ How It Works

Architecture Flow

1. Parse Arguments → 2. Initialize Stats → 3. Start Monitor Thread
4. Spawn Attack Threads → 5. Execute Attacks → 6. Update Stats
7. Stop Conditions Met → 8. Display Final Report

Attack Mechanics

TCP Flood:

Create Socket → Connect to Target → Send Data → Close Connection → Repeat

UDP Flood:

Create Socket → Send Datagram (no connection) → Repeat

HTTP Flood:

Create Socket → Connect to Target → Send HTTP GET → Close Connection → Repeat

---

🛡️ Safety Guidelines

✅ DO's

• ✓ Get written permission before testing
• ✓ Test on your own systems first
• ✓ Start with low thread counts (10-20)
• ✓ Use request limits for controlled testing
• ✓ Monitor system resources during testing

❌ DON'Ts

• ✗ Never test without authorization
• ✗ Don't attack production systems
• ✗ Don't use for malicious purposes
• ✗ Don't exceed test scope boundaries

Emergency Stop

# Press Ctrl+C to immediately stop all threads
Ctrl+C

---

🔧 Troubleshooting

Issue	Solution
Connection Refused	Verify target IP and port are correct
High Failure Rate	Reduce thread count or check target availability
System Slow Down	Stop attack immediately, reduce threads
Permission Denied	Run with administrative/root privileges
No Response	Check network connectivity to target

---

⚖️ Legal Notice

WARNING: This tool is for security research and educational purposes only.

• Using this tool against systems without authorization is illegal
• Violators may face criminal prosecution
• Users must comply with all applicable laws
• The author assumes no responsibility for misuse

---

📄 License

MIT License - See LICENSE file for details

---

📞 Support

• 🐛 Report issues on GitHub
• 💡 Suggest improvements via Pull Requests
• 📚 Read documentation for more details

---

Remember: Use responsibly and ethically. With great power comes great responsibility! 🔒