explaingit

yusuf-husayn/dos-ddos-lab

Analysis updated 2026-05-18

8PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

TLDR

An educational lab walking through common DoS and DDoS attack types against an isolated virtual machine, with traffic analysis and defense notes.

Mindmap

mindmap
  root((dos-ddos-lab))
    What it does
      Demonstrates flood attacks
      Analyzes traffic
      Documents mitigation
    Tech stack
      Python scripts
      Bash scripts
      Wireshark
    Use cases
      Cybersecurity education
      Home lab practice
      Defense study
    Audience
      Security students
      Home lab hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Learn how ICMP, SYN, HTTP, and TCP flood attacks work in a safe, isolated lab.

USE CASE 2

Practice reading network traffic captures in Wireshark before and during an attack.

USE CASE 3

Study defensive mitigation techniques for common denial of service attack types.

USE CASE 4

Use as a reference walkthrough for a personal cybersecurity home lab setup.

What is it built with?

PythonBashWiresharkhping3

How does it compare?

yusuf-husayn/dos-ddos-lab100/awesome-machine-learningadam-s/car-diagnosis
Stars888
LanguagePythonPythonPython
Last pushed2024-08-07
MaintenanceStale
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires setting up two virtual machines with isolated networking in VMware or VirtualBox.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This project is a documented cybersecurity training lab, not a tool you install and run against a real target. It walks through how Denial of Service and Distributed Denial of Service attacks work, using two virtual machines that only talk to each other on a private, isolated network built with VMware. One virtual machine, running Kali Linux, plays the attacker. The other, running Metasploitable2, a virtual machine intentionally built with security weaknesses for practice, plays the victim. The author walks through several attack types, including ICMP floods, SYN floods, HTTP floods, TCP floods, and a technique called Ping of Death, each aimed at overwhelming the target machine so its web service becomes unresponsive to normal requests. A distributed version of each attack is simulated by running several flood processes at once from the same attacking machine using tmux, a terminal tool that manages multiple sessions at once, rather than using genuinely separate physical machines. The author is upfront that this is a scope limitation of the lab, not a claim of a true distributed attack. Every stage of the lab is captured and analyzed with Wireshark, a network traffic analysis tool, and compared against a baseline capture taken before any attack traffic was sent, so the effect of each attack on network traffic patterns can be clearly seen. The repository includes the Bash and Python scripts used to automate the flood processes, screenshots of each stage, and a discussion of mitigation techniques, meaning ways a real system administrator could defend against these attacks. The author states clearly that everything here was run inside an isolated lab network for educational and defensive security purposes, and that no attacks were carried out against public or third party systems. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up an isolated Kali Linux and Metasploitable2 lab in VMware like this project describes.
Prompt 2
Explain the difference between the single source DoS stages and the simulated DDoS stages in this lab.
Prompt 3
Walk me through reading a baseline Wireshark capture compared to an attack capture.
Prompt 4
Summarize the mitigation techniques this lab discusses for each attack type.

Frequently asked questions

What is dos-ddos-lab?

An educational lab walking through common DoS and DDoS attack types against an isolated virtual machine, with traffic analysis and defense notes.

What language is dos-ddos-lab written in?

Mainly Python. The stack also includes Python, Bash, Wireshark.

What license does dos-ddos-lab use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is dos-ddos-lab to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is dos-ddos-lab for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.