> ## Documentation Index > Fetch the complete documentation index at: https://homelab.amylify.de/llms.txt > Use this file to discover all available pages before exploring further. # 1.0.2 Netzwerk (Virtuell) > Virtuelle Netzwerkinfrastruktur des Homelabs: Hyper-V-Switches, VM-Inventar, Adressvergabe und Konventionen. > [!NOTE] > > Entwurf Diese Seite befindet sich im Aufbau. Alle so gekennzeichneten Positionen sind geplant oder nicht verifiziert. Diese Seite dokumentiert die **virtuelle Ebene** des Homelabs Astrellium: alle virtuellen Switches, virtuellen Maschinen und deren Netzwerkkonfiguration. Physische Geräte und Verkabelung werden unter [1.0.1 Netzwerk (Physisch)](https://homelab.amylify.de/documentation/network/physical-network.md) geführt. > [!WARNING] > > Ein falsch zugewiesener virtueller Switch hebt die Trennung zwischen Labor- und Heimnetz vollständig auf, ohne dass am physischen Aufbau etwas sichtbar wird. Jede Änderung an der Switch-Zuordnung einer VM wird dokumentiert. *** ## Virtualisierungsplattform | Eigenschaft | Wert | | :- | :- | | Host | `NerdMachine` (`192.168.1.20`) | | Betriebssystem | Windows 11 Pro | | Hypervisor | Hyper-V | | CPU / RAM / Disk | 6 Kerne / 32 GB DDR4 / 500 GB NVMe | | Physischer Uplink | 1 × Gigabit Ethernet zur FRITZ!Box | > [!NOTE] > > Hyper-V weist keiner VM eine physische Netzwerkkarte zu. Stattdessen bildet der Hypervisor einen **virtuellen Switch** nach, an den die virtuellen Netzwerkkarten der VMs angeschlossen werden. Der Switch-Typ entscheidet, ob eine VM das physische Netz sieht, nur andere VMs oder gar nichts. *** ## Virtuelle Switches > [tab] External > > An eine physische Netzwerkkarte des Hosts gebunden. Angeschlossene VMs verhalten sich wie eigenständige Geräte im Heimnetz und erreichen das Internet. > > Einsatz: produktive Server-VMs. > [tab] Internal > > Kein physischer Uplink, aber der Host ist über eine virtuelle Netzwerkkarte mitverbunden. > > Einsatz: Segmente mit direktem Verwaltungszugriff vom Host. > [tab] Private > > Verbindet ausschließlich VMs untereinander. Weder Host noch physisches Netz sind erreichbar. Stärkste in Hyper-V verfügbare Isolationsstufe. > > Einsatz: Segmente mit absichtlich verwundbaren Zielsystemen. | Name | Typ | Uplink / Bindung | Segment | Zweck | Status | | :- | :- | :- | :- | :- | :- | | `vSwitch-LAN` | External | Physische NIC des Hosts | `192.168.1.0/24` | Anbindung produktiver VMs an das Heimnetz | Aktiv | | `vSwitch-LAB` | Private | keiner | `10.10.10.0/24` | Isolierte Angriffs- und Analyseumgebung | Entwurf | > [!NOTE] > > Ein zusätzlicher Internal-Switch für den Verwaltungszugriff auf das Labornetz wird bewusst **nicht** eingerichtet: Er würde dem Host einen Weg an OPNsense vorbei eröffnen und die Firewall als einzige Kontrollstelle aushebeln. Der Zugriff erfolgt ausschließlich über den von OPNsense gerouteten Weg aus dem Heimnetz. Vorhandene Switches und deren Zuordnung lassen sich auf dem Host auslesen: ```powershell theme={"dark"} Get-VMSwitch | Format-Table Name, SwitchType, NetAdapterInterfaceDescription Get-VMNetworkAdapter -VMName * | Format-Table VMName, SwitchName, IPAddresses ``` *** ## VM-Inventar | VM | Rolle | Betriebssystem | vSwitch | IP-Adresse | vCPU | RAM | Disk | Status | | :- | :- | :- | :- | :- | :- | :- | :- | :- | | **Ubuntu-Docker-Server** | Container-Plattform | Ubuntu 26.04 Server | `vSwitch-LAN` | `192.168.1.5` (statisch) | 2 | 4096 MB | 40 GB | Aktiv | | **Windows-JTL-Server** | Warenwirtschaft | Windows Server | `vSwitch-LAN` | `192.168.1.6` | – | – | – | Aktiv | | **OPNsense** | Firewall, Routing LAB | OPNsense | `vSwitch-LAN` (WAN) + `vSwitch-LAB` (LAN) | `10.10.10.1` | – | – | – | Entwurf | | **Kali** | Angriffs- und Analysesystem | Kali Linux | `vSwitch-LAB` | `10.10.10.10` | – | – | – | Entwurf | | **Security** | SIEM und Monitoring | – | `vSwitch-LAB` | `10.10.10.30` | – | – | – | Entwurf | | **Target** | Verwundbares Zielsystem | – | `vSwitch-LAB` | `10.10.10.50` | – | – | – | Entwurf | > [!WARNING] > > **Target** ist ein absichtlich verwundbares System. Es wird ausschließlich mit `vSwitch-LAB` verbunden und erhält zu keinem Zeitpunkt eine Netzwerkkarte an einem externen Switch. OPNsense ist die einzige VM mit zwei virtuellen Netzwerkkarten; jede weitere Doppelanbindung würde eine unkontrollierte Verbindung zwischen den Segmenten schaffen. ### Detailangaben > [accordion] Ubuntu-Docker-Server > > | Eigenschaft | Wert | > | :- | :- | > | Betriebssystem | Ubuntu 26.04 Server | > | IP-Adresse | `192.168.1.5` (statisch) | > | vCPU / RAM / Disk | 2 / 4096 MB / 40 GB | > | vSwitch | `vSwitch-LAN` (External) | > | Dienste | Docker Engine | > > Container und deren Portzuweisungen werden unter [3.x.x Dienste & Projekte](https://homelab.amylify.de/documentation/projects/projects-uebersicht.md) dokumentiert. > [accordion] Windows-JTL-Server > > | Eigenschaft | Wert | > | :- | :- | > | Betriebssystem | Windows Server | > | IP-Adresse | `192.168.1.6` | > | vSwitch | `vSwitch-LAN` (External) | > | Dienste | JTL-Wawi | > > Einziges produktives System mit Anwendungsdaten. Vor Änderungen an der Netzwerkkonfiguration wird ein Prüfpunkt erstellt. > [accordion] OPNsense > > Entwurf > > | Schnittstelle | vSwitch | Adresse | Funktion | > | :- | :- | :- | :- | > | WAN | `vSwitch-LAN` | aus `192.168.1.0/24` | Uplink Richtung Heimnetz und Internet | > | LAN | `vSwitch-LAB` | `10.10.10.1/24` | Gateway und DHCP für das Labornetz | > > Betriebsform: virtuelle Maschine auf dem Hypervisor-Host. Einziger zulässiger Übergang zwischen Labor- und Heimnetz. Die Regelwerke werden unter [2.x.x Security](https://homelab.amylify.de/documentation/security/security-uebersicht.md) gepflegt. > [accordion] Kali > > Entwurf > > | Eigenschaft | Wert | > | :- | :- | > | Betriebssystem | Kali Linux | > | IP-Adresse | `10.10.10.10` | > | vSwitch | `vSwitch-LAB` | > | Zweck | Enumeration, Schwachstellenanalyse, Exploitation | > > Tests werden ausschließlich gegen Systeme des Labornetzes durchgeführt. *** ## Adressvergabe im Labornetz | Bereich | Vergabeart | Verwendung | | :- | :- | :- | | `10.10.10.1` | statisch | Gateway (OPNsense LAN) | | `10.10.10.2` – `10.10.10.9` | statisch | Reserviert für Infrastruktur | | `10.10.10.10` – `10.10.10.49` | statisch | Analysesysteme | | `10.10.10.50` – `10.10.10.99` | statisch | Zielsysteme | | `10.10.10.100` – `10.10.10.199` | DHCP | Temporäre Systeme | > [!TIP] > > Statische Adressen erleichtern die Auswertung von Mitschnitten erheblich: Eine IP-Adresse bleibt über alle Sitzungen hinweg demselben System zugeordnet und ist in Logs eindeutig wiedererkennbar. *** ## Konventionen > [tab] VM-Namen > > VM-Namen folgen dem Schema `AST-`. Der Präfix kennzeichnet die Zugehörigkeit zum Homelab, die Rolle beschreibt die Funktion, nicht das Betriebssystem. > > | Name | Rolle | > | :- | :- | > | `AST-Docker` | Container-Plattform | > | `AST-JTL` | Warenwirtschaft | > | `AST-Firewall` | OPNsense | > | `AST-Kali` | Analysesystem | > | `AST-Target` | Zielsystem | > > > [!NOTE] > > > > Die bestehenden VMs tragen noch die Namen aus der Zeit vor dem Rebranding. Die Umbenennung erfolgt gesammelt. > [tab] Switch-Namen > > Virtuelle Switches werden nach dem Schema `vSwitch-` benannt. Der Name nennt das Segment, nicht den Typ, damit eine spätere Typänderung keine Umbenennung erzwingt. > [tab] Prüfpunkte > > Vor jeder wesentlichen Änderung wird ein Prüfpunkt mit Datum und Anlass erstellt: > > ```powershell theme={"dark"} > Checkpoint-VM -Name "AST-Kali" -SnapshotName "2026-09-13 vor Toolinstallation" > ``` > > Prüfpunkte produktiver VMs werden nach erfolgreicher Prüfung entfernt, da sie dauerhaft Speicherplatz belegen und die Datenträgerleistung reduzieren. > [!NOTE] > > Das Anlegen neuer VMs inklusive Isolationsprüfung ist als Schritt-für-Schritt-Anleitung unter [5.x.x How-Tos](https://homelab.amylify.de/documentation/references/references-uebersicht.md) beschrieben. *** ## Änderungshistorie > [accordion] Änderungshistorie > > **09/13/2026** > > ## Struktur gestrafft > > Handlungsanleitungen zum Anlegen neuer VMs nach Referenzen ausgelagert, Abschnitt "Offene Punkte" entfernt. Die Seite beschränkt sich auf den dokumentierten Ist-Stand und die geltenden Konventionen. > > **09/13/2026** > > ## Segmentierungsmodell festgelegt > > Die Trennung von Heim- und Labornetz erfolgt ausschließlich über den privaten Switch `vSwitch-LAB`. OPNsense wird als virtuelle Maschine mit zwei Netzwerkkarten betrieben und bildet den einzigen Übergang zwischen beiden Segmenten. Der ursprüngliche vorgesehene Internal-Switch erfällt bewusst. > > **09/13/2026** > > ## Ersterfassung > > Switch-Modell, VM-Inventar, Adressvergabe des Labornetzes und Konventionen angelegt. Produktive VMs als aktiv erfasst, Labor-VMs als Entwurfsposition aufgenommen. > > continue here > [!TIP] > > Diese Seite ist die einzige Quelle für virtuelle Switches und VM-Adressen. Außer Betrieb genommene VMs werden nicht entfernt, sondern mit Archiv gekennzeichnet. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.