{"id":27088898,"url":"https://github.com/itisuniqueofficial/network-ddos","last_synced_at":"2025-04-06T06:36:21.732Z","repository":{"id":279541904,"uuid":"939154585","full_name":"itisuniqueofficial/network-ddos","owner":"itisuniqueofficial","description":"Network-DDoS is an advanced network testing tool developed by It Is Unique Official for educational purposes. ","archived":false,"fork":false,"pushed_at":"2025-02-26T04:52:58.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-26T05:29:28.780Z","etag":null,"topics":["ddos","educational","network","requirements"],"latest_commit_sha":null,"homepage":"https://itisuniqueofficial.github.io/network-ddos/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itisuniqueofficial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-26T04:38:47.000Z","updated_at":"2025-02-26T04:58:58.000Z","dependencies_parsed_at":"2025-02-26T05:39:34.741Z","dependency_job_id":null,"html_url":"https://github.com/itisuniqueofficial/network-ddos","commit_stats":null,"previous_names":["itisuniqueofficial/network-ddos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itisuniqueofficial%2Fnetwork-ddos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itisuniqueofficial%2Fnetwork-ddos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itisuniqueofficial%2Fnetwork-ddos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itisuniqueofficial%2Fnetwork-ddos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itisuniqueofficial","download_url":"https://codeload.github.com/itisuniqueofficial/network-ddos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445682,"owners_count":20939953,"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":["ddos","educational","network","requirements"],"created_at":"2025-04-06T06:36:19.630Z","updated_at":"2025-04-06T06:36:21.723Z","avatar_url":"https://github.com/itisuniqueofficial.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Network DDoS Simulator\n\nWelcome to the **Network DDoS Simulator**, a Python-based tool designed for educational purposes to simulate realistic web traffic and test network resilience. This repository contains the `ddos.py` script, which mimics user behavior with configurable options and a real-time dashboard.\n\n**GitHub Repository**: [itisuniqueofficial/network-ddos](https://github.com/itisuniqueofficial/network-ddos)\n\n## Features\n\n- **Realistic Traffic**: Simulates browser-like requests with randomized headers, page navigation, and delays.\n- **Real-Time Dashboard**: Displays live stats (requests, successes, errors, rate) using a rich CLI interface.\n- **CLI Control**: Fully configurable via command-line arguments (e.g., `--target`, `--threads`).\n- **Page Discovery**: Dynamically explores target site links for varied traffic patterns.\n- **Proxy Support**: Optional IP rotation with proxy list integration (manual setup required).\n\n## Prerequisites\n\n- Python 3.8 or higher\n- Git (optional, for cloning the repository)\n\n## Installation\n\n### Clone the Repository:\n```bash\ngit clone https://github.com/itisuniqueofficial/network-ddos.git\ncd network-ddos\n```\n\n### Install Dependencies:\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\nRun the `ddos.py` script with the required `--target` argument and optional parameters.\n\n### Basic Command:\n```bash\npython ddos.py --target https://example.com\n```\n\n### Custom Options:\n```bash\npython ddos.py --target https://example.com --threads 20 --max-requests 100 --delay 0.3\n```\n\n## Command-Line Arguments\n\n| Argument      | Description                         | Default |\n|--------------|-------------------------------------|---------|\n| `--target`   | Target URL (required)              | N/A     |\n| `--threads`  | Number of concurrent threads       | 10      |\n| `--delay`    | Base delay between requests (sec)  | 0.5     |\n| `--timeout`  | Request timeout (sec)              | 5       |\n| `--max-requests` | Max requests per thread         | 50      |\n\n## Example Output\n\n```\nStarting DDoS simulation on https://example.com...\nInitial pages: ['https://example.com/', 'https://example.com/about']\n\nDashboard:\nDDoS Simulation - Target: https://example.com    Threads: 10/10    Press Ctrl+C to stop\n┌─────────────── Real-Time Stats ───────────────┐\n│ Metric        │ Value                          │\n├───────────────┼───────────────────────────────┤\n│ Total Requests│ 45                             │\n│ Successes     │ 42                             │\n│ Errors        │ 3                              │\n│ Req/Min       │ 180.50                         │\n│ Queue Size    │ 5                              │\n└───────────────┴───────────────────────────────┘\n[SUCCESS] Thread 0 | Visited https://example.com/about | Status: 200\n```\n\n## Testing Locally\n\n### Setup a Local Server (e.g., Flask):\n```python\nfrom flask import Flask, request\napp = Flask(__name__)\n\n@app.route('/\u003cpath:path\u003e', methods=['GET'])\n@app.route('/', defaults={'path': ''})\ndef catch_all(path):\n    print(f\"Request: {request.path}\")\n    return \"\u003ca href='/page1'\u003eNext\u003c/a\u003e\"\n\nif __name__ == \"__main__\":\n    app.run(port=8000)\n```\n\n### Run the Simulation:\n```bash\npython ddos.py --target http://localhost:8000\n```\n\n## Proxy Support\n\nTo simulate traffic from multiple IPs:\n\n1. Add proxies to the `PROXY_LIST` variable in `ddos.py`:\n```python\nPROXY_LIST = [{'http': 'http://proxy_ip:port'}, ...]\n```\n\n2. Rerun the script.\n\n## Ethical Use\n\n**Important**: This tool is for educational and testing purposes only. Do not use it against websites or servers without explicit permission. Unauthorized DDoS attacks are illegal and unethical.\n\n## Contributing\n\nFeel free to fork this repository, submit issues, or create pull requests. Contributions are welcome!\n\n1. Fork the repo: `itisuniqueofficial/network-ddos`\n2. Create a branch: `git checkout -b feature-name`\n3. Commit changes: `git commit -m \"Add feature\"`\n4. Push: `git push origin feature-name`\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n\n## Contact\n\nFor questions or support, open an issue on GitHub or contact **itisuniqueofficial**.\n\n---\n\n## How to Use These Files\n\n1. **Add to Repository**:\n   - Place `requirements.txt` and `README.md` in the root of `itisuniqueofficial/network-ddos` alongside `ddos.py`.\n   - Commit and push:\n     ```bash\n     git add requirements.txt README.md ddos.py\n     git commit -m \"Add requirements and README\"\n     git push origin main\n     ```\n\n2. **Verify on GitHub**:\n   - Visit `https://github.com/itisuniqueofficial/network-ddos` to see the rendered `README.md` and files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitisuniqueofficial%2Fnetwork-ddos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitisuniqueofficial%2Fnetwork-ddos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitisuniqueofficial%2Fnetwork-ddos/lists"}