SILAB Dokumentation

Loslegen

Installation

SILAB installiert alles, was es braucht — QEMU, das RouterOS-Image, nginx und seine eigenen Dienste — mit einem einzigen Befehl. Es ist unabhängig: Es installiert sich auf einem sauberen Ubuntu-Server und stellt sich neben alles andere, was bereits auf dem Host läuft, ohne es zu berühren.

Jede Installation wird verifiziert: Der Bootstrap prüft die Signatur des Release-Manifests gegen SILABs Release-Key und den SHA256-Wert des Pakets, bevor irgendetwas ausgeführt wird, und bittet Sie anschließend, MikroTiks Lizenz zu akzeptieren.

Wählen Sie Ihre Plattform:

• L Linux (ein Befehl) Ubuntu 22.04 / 24.04 / 26.04, amd64 oder arm64. Kein VT-x erforderlich.
• W Windows (WSL2) Windows 10 (2004+) oder 11 — eigene WSL2-Instanz und ein Desktop-Menü.
• i Voraussetzungen & Optionen Hardware-Dimensionierung, was der Installer einrichtet, Umgebungsvariablen-Overrides.

Installation

Linux (ein Befehl)

Führen Sie unter Ubuntu 22.04, 24.04 oder 26.04 (amd64 oder arm64) als root aus:

curl -fsSL https://silab.securytik.com/install.sh | sudo bash

Der Installer lädt von unserem Download-Bucket herunter und selbstständig von SILABs GitHub-Release, wenn der Bucket nicht erreichbar ist — es gibt nichts auszuwählen.

Was passiert

1. Der Bootstrap holt das neueste Release-Manifest, prüft dessen Signatur und Ablaufdatum, lädt das Paket herunter und prüft dessen SHA256. Bei einer Abweichung wird die Installation gestoppt, bevor irgendetwas ausgeführt wird.
2. Er bittet Sie, MikroTiks Lizenz für RouterOS CHR zu akzeptieren, lädt dann das neueste stabile CHR-Image von MikroTik herunter und verifiziert dessen SHA256. Das Image wird von SILAB niemals weiterverbreitet.
3. Er installiert QEMU, nginx und SILABs Dienste und veröffentlicht die Web-UI auf Port 80 — oder 8088, wenn Port 80 bereits belegt ist, zum Beispiel von SAMM.

Erste Anmeldung

Öffnen Sie den Server in einem Browser und melden Sie sich an:

Ändern Sie das Passwort sofort unter System → Profile. SILAB zeigt eine Warnung an, solange das Standardpasswort verwendet wird.

Installation

Windows (WSL2)

SILAB läuft unter Windows 10 (Version 2004 oder neuer) und Windows 11 in einer eigenen WSL2-Instanz, eingerichtet von einem einzigen Installer. Öffnen Sie PowerShell — nicht die Eingabeaufforderung (cmd) — und führen Sie die Zeile unten aus. Wenn PowerShell nicht als Administrator läuft, fragt Windows nach Erlaubnis: Klicken Sie auf Ja, und die Installation wird in einem neuen Administratorfenster fortgesetzt.

irm https://silab.securytik.com/install.ps1 | iex

Er lädt von unserem Download-Bucket herunter und selbstständig von SILABs GitHub-Release, wenn der Bucket nicht erreichbar ist.

Der Bootstrap lädt den vollständigen Installer nach %ProgramData%\SILAB\silab-windows.ps1 herunter und führt ihn von dort aus, damit er sich selbst erhöhen kann und nach einem Neustart fortfahren kann.

Was passiert

1. Er aktiviert WSL2. Beim ersten Mal ist dafür ein Neustart von Windows erforderlich; die Einrichtung setzt sich anschließend selbst fort.
2. Er importiert eine eigene Ubuntu-24.04-Instanz namens SILAB (Checksummen-verifiziert). Ihre anderen WSL-Distributionen bleiben unberührt.
3. Er installiert SILAB innerhalb dieser Instanz mit dem Linux-Installer.
4. Er fügt ein SILAB-Symbol zum Desktop und zum Startmenü hinzu: ein kleines Menü zum Starten, Stoppen, Anzeigen des Status, Öffnen im Browser und Freigeben im LAN, damit andere PCs — und deren WinBox — das Lab erreichen können.

Installation aus einer heruntergeladenen Datei

Der vollständige Installer kann auch direkt ausgeführt werden, zum Beispiel von einer Kopie auf einem USB-Stick:

powershell -ExecutionPolicy Bypass -File silab-windows.ps1

Deinstallation

-Uninstall entfernt die SILAB-Instanz, die Verknüpfung und die LAN-Freigaberegeln:

powershell -ExecutionPolicy Bypass -File "$env:ProgramData\SILAB\silab-windows.ps1" -Uninstall

Installation

Voraussetzungen & Optionen

Anforderungen

• Linux: Ubuntu 22.04, 24.04 oder 26.04, amd64 oder arm64, mit root-/sudo- Zugriff. KVM wird automatisch verwendet, wenn /dev/kvm nutzbar ist; ohne es läuft SILAB unter Software-Emulation — kein VT-x erforderlich.
• Windows: Windows 10 Version 2004 (Build 19041) oder neuer, oder Windows 11, mit für WSL2 eingeschalteter Hardware-Virtualisierung (VT-x / AMD-V).
• Größe: 2 Kerne und 4 GB RAM betreiben eine Handvoll Router; planen Sie etwa 200–300 MB RAM pro Router.
• RouterOS: CHR 7.15 oder neuer, heruntergeladen von MikroTik.

Was das Installationsprogramm einrichtet

Umgebungsvariablen-Overrides

Setzen Sie diese vor den Installationsbefehl, z. B. curl -fsSL https://silab.securytik.com/install.sh | sudo SILAB_HTTP_PORT=8080 bash.

Loslegen

Ihr erstes Lab

Zwei Router und ein Kabel, von einer leeren Zeichenfläche bis zu einem Ping über die Verbindung.

1. Melden Sie sich als admin / admin an und ändern Sie das Passwort unter System → Profile.
2. Erstellen Sie ein Lab und öffnen Sie dann Lab → Topology.
3. Klicken Sie auf + Node und fügen Sie zwei Router (CHR)-Knoten hinzu — R1 und R2 in diesem Beispiel.
4. Klicken Sie auf + Connect, klicken Sie auf R1 und dann auf R2, und wählen Sie die Ports — zum Beispiel ether1 bei beiden.
5. Drücken Sie Start lab. Unter Software-Emulation ist ein frisches Zwei-Router-Lab in etwa einer halben Minute hochgefahren und eingerichtet.
6. Doppelklicken Sie auf R1, um seine Konsole zu öffnen, geben Sie ether1 auf jedem Router eine Adresse, und verwenden Sie Ping — klicken Sie auf R1, dann auf R2 — um das Kabel zu testen.

Die Lab-Datei

Ein Lab ist ein kleines YAML-Diagramm. Als .silab-Datei exportiert, enthält es das Diagramm plus ein .rsc pro Router — meist wenige KB. Das SILAB des Empfängers baut das Lab aus seinem eigenen RouterOS-Image neu auf, und importierte Dateien werden streng validiert: keine Host-Pfade, keine rohen QEMU-Argumente.

silab: 1
name: OSPF basics
routeros: "7.24.4"
nodes:
  - {id: 1, name: R1, kind: router, x: 100, y: 100, config: R1.rsc}
  - {id: 2, name: R2, kind: router, x: 400, y: 100}
  - {id: 3, name: LAN, kind: hub,    x: 250, y: 300}
  - {id: 4, name: PC1, kind: pc,     x: 250, y: 450}
links:
  - {a: {node: 1, port: 1}, b: {node: 2, port: 1}, delay_ms: 20}
  - {a: {node: 2, port: 2}, b: {node: 3}}
  - {a: {node: 4}, b: {node: 3}}

Ein Lab legt seine RouterOS-Version fest, sodass sich ein geteiltes Lab überall gleich verhält.

Labs erstellen

Knoten & Kabel

Fügen Sie Knoten mit + Node hinzu und verkabeln Sie sie Port zu Port mit + Connect — während das Lab läuft, ohne Neustart.

Knotentypen

Benennen Sie einen Router auf der Zeichenfläche um, und seine RouterOS-Identität folgt live. Jeder Router kann eine Startkonfiguration (.rsc) tragen, die beim ersten Start angewendet wird.

Kabel

• Punkt-zu-Punkt-Kabel leiten jeden Frame durch: STP, LACP, LLDP, MNDP und VLAN-Tags.
• Ziehen Sie ein Kabel ab und stecken Sie es wieder ein, oder beeinträchtigen Sie es absichtlich: Verzögerung, Jitter, Verlust, Bandbreite.
• Mehrere Kabel zwischen denselben zwei Knoten werden nebeneinander gezeichnet, jedes mit eigenen Beschriftungen.
• Klicken Sie mit der rechten Maustaste auf ein Kabel, um es live in Wireshark aufzuzeichnen.

Strom

Klicken Sie mit der rechten Maustaste auf einen Router für ein Strommenü im VMware-Stil:

Labs erstellen

Einen Router erreichen

Doppelklicken Sie auf einen Router für seine Konsole im Browser. Sie funktioniert über den seriellen Port des Routers, sodass sie auch dann funktioniert, wenn der Student jede IP-Adresse gelöscht hat. Jeder Router erhält außerdem feste Ports auf dem SILAB-Host, erreichbar vom LAN oder dem Internet.

So antwortet Router 1 auf WinBox unter 20010, SSH unter 20011 und WebFig unter 20012; Router 2 unter 20020, 20021 und 20022. Router melden sich als admin / admin an.

ssh -p 20011 admin@<silab-host>

WinBox mit einem Klick

Klicken Sie mit der rechten Maustaste auf einen Router → WinBox, und WinBox öffnet sich bereits verbunden, mit Adresse, Benutzer und Passwort ausgefüllt. Eine Webseite kann von sich aus kein Programm auf Ihrem PC starten, daher braucht es den WinBox-Helper, einmal pro PC installiert unter System → Helpers:

• Windows — laden Sie den Helper herunter, Rechtsklick darauf → Mit PowerShell ausführen. Wenn er WinBox nicht finden kann, fragt er, wo WinBox.exe liegt. Starten Sie den Browser einmal neu.
• Linux — laden Sie den Helper herunter und führen Sie sh silab-winbox-linux.sh aus (nicht als root). Er findet WinBox, oder fragt nach dem Pfad der WinBox-Binärdatei.
• macOS — solange es keinen Helper gibt, kopiert ein Rechtsklick auf einen Router → Links → WinBox die Adresse.

Der Helper benötigt keine Administratorrechte. Sie brauchen zuerst WinBox selbst, von mikrotik.com/download.

Der Management-Port

SILAB erreicht jeden Router über einen Management-Port, der in seiner eigenen VRF gehalten wird, vrf-mgmt: außerhalb der Routing-Tabelle des Studenten und außerhalb von OSPF und BGP. Die Ports des Studenten bleiben ether1..N, genau wie gezeichnet.

Labs erstellen

Virtuelle PCs

Ein PC-Knoten ist ein schlanker Client ohne VM dahinter. Legen Sie seine IP über die Zeichenfläche fest — DHCP-Client, Statisch, PPPoE-Client (optional nur den Server, der einen bestimmten Dienstnamen anbietet) oder Keine Adresse — oder über seine Konsole. Die Konsole hat keine Host-Shell dahinter; dies sind ihre Befehle:

Ping zwischen zwei beliebigen Geräten

Neben + Connect auf der Topologie testet Ping die Erreichbarkeit, ohne eine Konsole zu öffnen: Klicken Sie auf zwei Geräte, fünf Pings laufen im Hintergrund, und das Ergebnis öffnet sich in einem Pop-up. SILAB pingt die Adresse im Subnetz, das sich beide teilen, sonst die erste Adresse des Ziels; ein Internet- Knoten als Ziel pingt 8.8.8.8.

Labs erstellen

Aufzeichnung in Wireshark

Klicken Sie mit der rechten Maustaste auf ein Kabel → Capture in Wireshark: Wireshark öffnet sich auf Ihrem PC und zeigt den Traffic dieses Kabels live, in beide Richtungen, bis Sie es schließen.

Den Wireshark-Helper einmal installieren

Wie bei WinBox braucht dies einen kleinen Helper pro PC, von System → Helpers. Er benötigt keine Administratorrechte.

• Windows — laden Sie den Helper herunter, Rechtsklick darauf → Mit PowerShell ausführen. Wenn er Wireshark nicht finden kann, fragt er, wo Wireshark.exe liegt. Starten Sie den Browser einmal neu: Capture-Links öffnen dann Wireshark, ohne zu fragen.
• Linux — laden Sie den Helper herunter und führen Sie sh silab-wireshark-linux.sh aus (nicht als root). Er findet Wireshark, oder fragt nach dem Pfad der wireshark-Binärdatei. Er benötigt curl.

Sie brauchen zuerst Wireshark selbst, von wireshark.org.

Labs erstellen

Massenaktionen

Lab → Bulk actions nimmt eine Änderung an jedem Router des Labs vor — oder an den ausgewählten — und zeigt das Ergebnis pro Router.

System

Updates

System → Updates zeigt die installierte Version, das neueste Release und Was ist neu. Ein täglicher Timer prüft auf neue Releases.

1. Apply update lädt das signierte Release herunter und prüft es.
2. Es sichert die Installation nach /var/backups/silab, tauscht die neuen Dateien ein und startet die Engine und das Web neu. Laufende Router laufen weiter.
3. Wenn etwas fehlschlägt, wird die vorherige Version automatisch wiederhergestellt.

Nach einem Ubuntu-Release-Upgrade (22.04 → 24.04 → 26.04) bauen die Dienste SILABs Python- Umgebung bei ihrem nächsten Start selbst neu auf; den Installer erneut auszuführen funktioniert ebenfalls.

RouterOS-Versionen

Mehrere RouterOS-Versionen können nebeneinander installiert werden, und SILAB sagt Ihnen, wenn eine neuere RouterOS-Version erscheint. Nichts aktualisiert sich von selbst: Ein Lab legt seine Version fest. Fügen Sie eine über die Befehlszeile hinzu:

silab image latest
silab image pull 7.24.4
silab image list

System

Sichern & wiederherstellen

System → Backup & restore erstellt, lädt herunter, lädt hoch und stellt Sicherungen wieder her.

• Jede Sicherung enthält jedes Lab mit seinen Startkonfigurationen, die Konten und die Einstellungen.
• Aktivieren Sie Include the routers' disks, um auch ihren vollständigen Zustand zu behalten — die Datei wird größer.
• RouterOS-Images sind nicht enthalten; sie werden erneut von MikroTik heruntergeladen.
• Eine automatische Sicherung läuft jeden Tag um 04:00 Uhr (Serverzeit). Wählen Sie, wie viele automatische Kopien aufbewahrt werden sollen; Sicherungen, die Sie selbst erstellt oder hochgeladen haben, werden niemals gelöscht.
• Uploads müssen eine von SILAB erstellte .tar.gz-Datei sein; alles andere wird abgelehnt.

Über die Befehlszeile:

silab backup create --disks
silab backup list

System

Befehlszeile

Alles auf der Zeichenfläche kann auch über die Shell des Servers mit silab erledigt werden:

silab lab load ospf-basics.silab
silab up
silab link impair R1:1 --delay 50 --loss 2
silab console R1

Referenz

FAQ & Fehlerbehebung

Brauchen Sie weitere Hilfe?

Senden Sie eine E-Mail an [email protected], um einen Fehler zu melden oder eine Funktion anzufordern.