🔥 DDoSSCAN

Advanced Network Availability & Stress Testing Framework

---

🚨 IMPORTANT LEGAL NOTICE

⚖️ For Authorized Testing Only

This tool is designed exclusively for:

• Security professionals conducting authorized penetration tests
• System administrators testing their own infrastructure
• Network engineers performing capacity planning
• Educational institutions in controlled lab environments

Unauthorized use against any system you do not own or have explicit written permission to test is:

• ❌ ILLEGAL under international cybercrime laws
• ❌ UNETHICAL and violates responsible disclosure practices
• ❌ PUNISHABLE by imprisonment, fines, and civil liability

The author assumes NO responsibility for any misuse. You are solely accountable for your actions.

---

📖 About

DDoSSCAN is an open-source network availability and stress testing tool written in Python. It is designed for security researchers, network engineers, and system administrators who need to test the resilience and availability of their own infrastructure.

Key highlights:

• Built-in Domain Safety Blocker — automatically blocks government, military, and critical infrastructure domains
• Multi-vector stress testing: TCP, HTTP, UDP, Slowloris, Mixed
• Smart parameter calculator based on your available bandwidth
• Real-time live statistics dashboard
• Session-based report generator (TXT + JSON)
• Clean VIP terminal interface with animated boot sequence
• Works on Linux, Windows, macOS, and Termux (Android)

✨ What Makes DDoSSCAN Different?

Feature	Description	Status
🛡️ Smart Domain Blocking	Automatic protection against government/military/critical infrastructure	✅ NEW
📊 Real-Time Dashboard	Live statistics with packet counters, success rates, and performance metrics	✅ NEW
🧠 Bandwidth Calculator	AI-powered parameter optimization based on your network capacity	✅ NEW
📝 Session Reports	Automatic report generation (JSON/TXT) with execution logs	✅ NEW
🎨 VIP Interface	Animated terminal UI with professional color scheme	✅ NEW
🔄 Multi-Vector Attacks	TCP, HTTP, UDP, Slowloris, and Mixed modes	✅ ENHANCED
📱 Cross-Platform	Linux, Windows, macOS, and Termux (Android) support	✅

---

🛡️ Domain Safety System

DDoSSCAN includes an automatic domain blocker that prevents testing against protected infrastructure:

Blocked Categories:

graph LR
    A[Domain Safety System] --> B[Government TLDs]
    A --> C[Military Keywords]
    A --> D[Critical Infrastructure]
    A --> E[Major CDNs]
    A --> F[International Orgs]
    
    B --> B1[.gov, .mil, .go.id, .gouv.fr...]
    C --> C1[army, navy, tni, nato, pentagon...]
    D --> D1[google, facebook, banks, media...]
    E --> E1[cloudflare, akamai, fastly...]
    F --> F1[un.org, who.int, redcross...]

Loading

Configurable Blocklist: config/blocked_domains.json

🎯 Use Cases & Permissions

✅ Permitted Use

✔️ Load testing servers you personally own

✔️ Stress testing your VPS/cloud instances

✔️ Internal network capacity testing

✔️ Security research with written authorization

✔️ CTF competitions & lab environments

✔️ Educational demonstrations

❌ Prohibited Use

✖️ Attacking any server without explicit written consent

✖️ Targeting government, military, or critical infrastructure

✖️ DDoS attacks against production systems

✖️ Any malicious or illegal activities

🚀 Quick Installation

📋 Prerequisites

Python 3.8+ | pip | git

💻 Installation Commands

🐧 Linux / macOS

git clone https://github.com/ruyynn/DDoSSCAN.git
cd DDoSSCAN
pip install colorama
python3 src/DDoSSCAN_v2.py

🪟 Windows

git clone https://github.com/ruyynn/DDoSSCAN.git
cd DDoSSCAN
pip install colorama
python src/DDoSSCAN_v2.py

📱 Termux (Android)

pkg update && pkg upgrade
pkg install python git
git clone https://github.com/ruyynn/DDoSSCAN.git
cd DDoSSCAN
pip install colorama
python DDoSSCAN_v2.py

🔧 Optional Dependencies

pip install requests scapy paramiko  # Enhanced functionality

🎮 Attack Methods

Method	OSI Layer	Technique	Best For
HTTP Flood	Layer 7	Exhausts HTTP connection pool	Web servers, applications
TCP Flood	Layer 4	SYN/ACK connection flood	Firewalls, stateful devices
UDP Flood	Layer 4	High-bandwidth packet flood	Network infrastructure
Slowloris	Layer 7	Holds connections open	Apache, threaded servers
Mixed Mode	L4 + L7	Rotating attack vectors	Comprehensive testing

📁 Project Structure

DDoSSCAN/
├── 📄 README.md                 # Documentation
├── 📜 LICENSE                   # license
├── ⚠️ DISCLAIMER.md            # Legal disclaimer
├── 📋 CHANGELOG.md              # Version history
├── 📁 src/
│   └── 🐍 DDoSSCAN_v2.py       # Main application
├── 📁 config/
│   └── 🛡️ blocked_domains.json # Safety blocklist
└── 📁 docs/
    ├── 📘 usage-guide.md       # Detailed usage
    └── ❓ faq.md               # Frequently asked questions

---

🔐 Safety Features

✅ Automatic domain blocking - No accidental targeting of protected sites

✅ Bandwidth throttling - Prevents network saturation

✅ Graceful termination - Ctrl+C safely stops all operations

✅ Session logging - Complete audit trail of all activities

✅ Error handling - Robust exception management

---

🤝 Contributing

We welcome contributions! Please:

Fork the repository

Create a feature branch (git checkout -b feature/AmazingFeature)

Commit your changes (git commit -m 'Add AmazingFeature)

Push to branch (git push origin feature/AmazingFeature)

Open a Pull Request

---

💖 Support Development

If DDoSSCAN has helped you in your security research or network testing, consider supporting future development:

Every contribution helps maintain and improve the tool

---

📜 License

This project is licensed under the GNU General Public License v3.0.

You are free to:

✅ Use the software

✅ Study and modify the source code

✅ Share and redistribute the software

✅ Create derivative works under the same GPL v3 license

Additional project terms apply, including attribution and project name protection. See ADDITIONAL_TERMS.md for details.

---

📞 Contact & Support

Platform	Link	Action
💻 GitHub	@ruyynn
📘 Facebook	@ruyynn
📧 Email	ruyynn25@gmail.com

Use Responsibly. Test Ethically. Secure Proactively.

DDoSSCAN v2.0 — Made with 🔥 by ruyynn

⬆ Back to Top