# dracular5616/metasploit-lab-guide architecture

> Architecture diagram of the GitHub repository dracular5616/metasploit-lab-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dracular5616/metasploit-lab-guide
- Repository: https://github.com/dracular5616/metasploit-lab-guide

## Overview

This repository is a hands-on guide for building and safely using an isolated Metasploit penetration-testing lab, rather than executable lab-management software. Its main workflow is to configure a host-only virtual network, set up Kali and a vulnerable target, scan the target, and practice exploitation; the README also covers post-exploitation, cleanup, exercises, optional targets, and safety. The only available evidence is the README, so the graph reflects documented relationships and does not imply inspection of implementation source.

Main entry points: [`README.md`](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md) (Kali attacker VM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lab_setup["Lab setup"]
  node_hypervisor["Virtualization platform<br/>[README.md]"]
  node_isolated_network["Host-only network<br/>[README.md]"]
  node_kali_vm["Kali attacker VM<br/>[README.md]"]
  node_vulnerable_target["Vulnerable target VM<br/>[README.md]"]
  node_optional_targets["Optional targets<br/>[README.md]"]
end

subgraph group_testing["Testing workflow"]
  node_nmap_scan["Port scanning<br/>[README.md]"]
  node_metasploit["Metasploit console<br/>[README.md]"]
  node_postgresql[("PostgreSQL database<br/>[README.md]")]
  node_exploitation["Exploit exercise<br/>[README.md]"]
  node_post_exploitation["Post-exploitation<br/>[README.md]"]
end

subgraph group_guidance["Safety and practice"]
  node_cleanup["Lab cleanup<br/>[README.md]"]
  node_beginner_exercises["Beginner exercises<br/>[README.md]"]
  node_safety_guidance["Safety and legal<br/>[README.md]"]
end

node_lab_builder(("Lab builder"))

node_lab_builder -->|"sets up"| node_hypervisor
node_hypervisor -->|"hosts"| node_kali_vm
node_hypervisor -->|"hosts"| node_vulnerable_target
node_lab_builder -->|"configures"| node_isolated_network
node_isolated_network -->|"connects"| node_kali_vm
node_isolated_network -->|"connects"| node_vulnerable_target
node_lab_builder -.->|"may add"| node_optional_targets
node_kali_vm -->|"runs"| node_nmap_scan
node_nmap_scan -->|"scans"| node_vulnerable_target
node_kali_vm -->|"starts"| node_metasploit
node_metasploit -->|"initializes"| node_postgresql
node_metasploit -->|"runs"| node_exploitation
node_exploitation -->|"targets"| node_vulnerable_target
node_exploitation -.->|"continues to"| node_post_exploitation
node_lab_builder -->|"performs"| node_cleanup
node_lab_builder -->|"practices"| node_beginner_exercises
node_lab_builder -->|"follows"| node_safety_guidance

click node_hypervisor "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_isolated_network "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_kali_vm "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_vulnerable_target "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_optional_targets "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_nmap_scan "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_metasploit "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_postgresql "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_exploitation "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_post_exploitation "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_cleanup "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_beginner_exercises "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"
click node_safety_guidance "https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_hypervisor,node_isolated_network,node_kali_vm,node_vulnerable_target,node_optional_targets toneBlue
class node_nmap_scan,node_metasploit,node_postgresql,node_exploitation,node_post_exploitation toneAmber
class node_cleanup,node_beginner_exercises,node_safety_guidance toneMint
class node_lab_builder toneIndigo
```

## Components

### Lab setup

- [Virtualization platform](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Host-only network](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Kali attacker VM](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Vulnerable target VM](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Optional targets](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`

### Testing workflow

- [Port scanning](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Metasploit console](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [PostgreSQL database](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Exploit exercise](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Post-exploitation](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`

### Safety and practice

- [Lab cleanup](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Beginner exercises](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`
- [Safety and legal](https://github.com/dracular5616/metasploit-lab-guide/blob/main/README.md): `README.md`

### Other components

- **Lab builder**

## Connections

- Lab builder → Virtualization platform: sets up (evidence: `README.md`)
- Virtualization platform → Kali attacker VM: hosts (evidence: `README.md`)
- Virtualization platform → Vulnerable target VM: hosts (evidence: `README.md`)
- Lab builder → Host-only network: configures (evidence: `README.md`)
- Host-only network → Kali attacker VM: connects (evidence: `README.md`)
- Host-only network → Vulnerable target VM: connects (evidence: `README.md`)
- Lab builder → Optional targets: may add (evidence: `README.md`)
- Kali attacker VM → Port scanning: runs (evidence: `README.md`)
- Port scanning → Vulnerable target VM: scans (evidence: `README.md`)
- Kali attacker VM → Metasploit console: starts (evidence: `README.md`)
- Metasploit console → PostgreSQL database: initializes (evidence: `README.md`)
- Metasploit console → Exploit exercise: runs (evidence: `README.md`)
- Exploit exercise → Vulnerable target VM: targets (evidence: `README.md`)
- Exploit exercise → Post-exploitation: continues to (evidence: `README.md`)
- Lab builder → Lab cleanup: performs (evidence: `README.md`)
- Lab builder → Beginner exercises: practices (evidence: `README.md`)
- Lab builder → Safety and legal: follows (evidence: `README.md`)
