{"id":26107123,"url":"https://github.com/oliverwebdev/modos","last_synced_at":"2026-05-20T16:40:11.078Z","repository":{"id":281260886,"uuid":"944729942","full_name":"Oliverwebdev/MODOS","owner":"Oliverwebdev","description":"Advanced DoS Testing Framework for authorized security assessments and network resilience testing. Multiple attack methods available. For educational and authorized use only.","archived":false,"fork":false,"pushed_at":"2025-03-07T21:59:37.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T22:28:44.301Z","etag":null,"topics":["cybersecurity","dos-testing","ethical-hacking","network-resilience","network-security","penetration-testing","python3","security-research","security-testing","security-tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Oliverwebdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T21:35:38.000Z","updated_at":"2025-03-07T22:00:00.000Z","dependencies_parsed_at":"2025-03-07T22:38:54.088Z","dependency_job_id":null,"html_url":"https://github.com/Oliverwebdev/MODOS","commit_stats":null,"previous_names":["oliverwebdev/modos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oliverwebdev%2FMODOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oliverwebdev%2FMODOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oliverwebdev%2FMODOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oliverwebdev%2FMODOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Oliverwebdev","download_url":"https://codeload.github.com/Oliverwebdev/MODOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242762738,"owners_count":20181266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","dos-testing","ethical-hacking","network-resilience","network-security","penetration-testing","python3","security-research","security-testing","security-tools"],"created_at":"2025-03-09T22:43:21.752Z","updated_at":"2026-05-20T16:40:11.010Z","avatar_url":"https://github.com/Oliverwebdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DoS-Test-Framework\n\nAn advanced DoS Testing Framework for authorized security assessments and research. This tool provides various attack methods to conduct penetration tests and verify the resilience of network infrastructures against denial-of-service attacks.\n\n## ⚠️ Important Notice\n\n**This tool may only be used for the following purposes:**\n- Authorized security testing\n- Research and education\n- Tests on your own networks\n\n**Unauthorized use of this tool against non-authorized targets is illegal and may have criminal consequences.**\n\n## 📋 Features\n\nThe framework offers various attack methods:\n\n| Attack Type | Description |\n|-------------|------------|\n| `syn_flood` | TCP SYN flood attack |\n| `udp_flood` | UDP packet flood |\n| `http_flood` | HTTP request flood |\n| `icmp_flood` | ICMP/Ping flood |\n| `slowloris` | Slowloris connection exhaustion |\n| `dns_amplification` | DNS amplification attack |\n| `ntp_amplification` | NTP amplification attack |\n| `dns_water_torture` | DNS water torture attack with random subdomains |\n| `tcp_reset` | TCP reset packet flood |\n\n## 🔧 Installation\n\n### Prerequisites\n\n- Python 3.8 or higher\n- pip (Python package manager)\n- Root/Administrator privileges (for some attack methods)\n\n### Installing Dependencies\n\n```bash\n# Clone the repository\ngit clone https://github.com/username/dos-framework.git\ncd dos-framework\n\n# Install dependencies\npip install -r requirements.txt\n\n# Optional: Install the package in development mode\npip install -e .\n```\n\n## 🚀 Usage\n\n### Basic Usage\n\nWe recommend using the provided wrapper script `run_attack.py`:\n\n```bash\n# Make the script executable\nchmod +x run_attack.py\n\n# Run an attack\n./run_attack.py --attack \u003cattack_type\u003e --target \u003ctarget\u003e --duration \u003cduration_in_seconds\u003e\n```\n\n### Available Parameters\n\n| Parameter | Description | Default Value |\n|-----------|------------|--------------|\n| `--attack` | Attack type (required) | - |\n| `--target` | Target address (IP or domain, required) | - |\n| `--port` | Target port | 80 |\n| `--duration` | Attack duration in seconds | 30 |\n| `--threads` | Number of threads to use | 10 |\n| `--timeout` | Connection timeout in seconds | 5.0 |\n\n### Examples\n\n```bash\n# SYN flood against a web server\n./run_attack.py --attack syn_flood --target example.com --duration 20\n\n# UDP flood with more threads\n./run_attack.py --attack udp_flood --target 192.168.1.1 --threads 50 --duration 15\n\n# DNS amplification attack\n./run_attack.py --attack dns_amplification --target example.com --duration 10\n\n# Slowloris attack against a non-standard port\n./run_attack.py --attack slowloris --target example.com --port 8080 --duration 30\n```\n\n## 🔍 How the Attack Methods Work\n\n### SYN Flood\nSends a large number of TCP SYN packets to the target without completing the handshake, filling up the connection queue.\n\n### UDP Flood\nFloods the target with UDP packets, potentially leading to bandwidth exhaustion.\n\n### HTTP Flood\nSends numerous HTTP GET or POST requests to a web server to overload it.\n\n### Slowloris\nKeeps HTTP connections open by sending incomplete requests that are slowly completed.\n\n### DNS Amplification\nUses public DNS servers to forward amplified DNS requests to the target, with spoofed source IP.\n\n### NTP Amplification\nUses NTP servers for amplified responses through the MONLIST command, with spoofed source IP.\n\n### DNS Water Torture\nSends requests for non-existent subdomains to overload DNS resolvers.\n\n### ICMP Flood\nSends a large number of ICMP echo requests (ping) to exhaust network bandwidth.\n\n### TCP Reset\nSends TCP reset packets to interrupt existing connections.\n\n## ⚙️ Advanced Configuration\n\nThe framework offers advanced configuration options by customizing the `config.py` file:\n\n- IP spoofing settings\n- Packet size variations\n- Custom HTTP headers and user agents\n- DNS server lists for amplification attacks\n- TTL variations for packet manipulation\n- And much more...\n\n## 📊 Statistics and Monitoring\n\nThe framework includes a built-in statistics function that displays information during the attack:\n\n- Packets per second (PPS)\n- Transferred data (MB/s)\n- Connection success rate\n- Detected protection measures (WAF, rate limiting)\n\n## 📂 Project Structure\n\n```\ndos-framework/\n├── src/\n│   ├── attacks/         # Attack methods\n│   ├── core/            # Core functionality\n│   ├── utils/           # Helper functions\n│   ├── web/             # Web UI (optional)\n│   ├── config.py        # Configuration file\n│   └── main.py          # Main entry point\n├── requirements.txt     # Dependencies\n├── setup.py             # Installation script\n└── run_attack.py        # Wrapper script for easy use\n```\n\n## 🛡️ Defense Against DoS Attacks\n\nHere are some measures to defend against DoS attacks:\n\n- Implementing rate limiting\n- Using load balancers\n- Configuring firewall rules\n- Deploying specialized anti-DDoS services\n- Configuring SYN cookies\n- Monitoring and filtering network traffic\n\n## 🔄 Future Development\n\nPossible extensions for future versions:\n\n- Web-based user interface for easier control\n- Automatic target analysis and adaptation of attack methods\n- Enhanced reporting and logging\n- Integration with monitoring tools\n\n## 📜 License\n\nThis project is released under the terms of the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n**Disclaimer:** The authors assume no responsibility for damages or legal consequences arising from the use of this tool. Use at your own risk and responsibility.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foliverwebdev%2Fmodos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foliverwebdev%2Fmodos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foliverwebdev%2Fmodos/lists"}