Für fortgeschrittene Kurse, die lokale Embedded-Hardware (z. B. Arduino) oder eine isolierte Ubuntu Lab-VM erfordern, stellt der Lokale Agent (xkat-cli) eine sichere Verbindung zwischen Browser und Ihrem Computer her.
Sicherheitshinweis: Der lokale Agent öffnet keine Ports zum öffentlichen Internet. Er kommuniziert ausschließlich lokal auf Ihrem Computer (
localhost:127.0.0.1). Befehle werden nur nach Ihrer Freigabe ausgeführt.1. Schnellstart (Quick Start)
Öffnen Sie das Terminal Ihres Computers (PowerShell, Terminal oder Bash) und führen Sie diesen Befehl aus:2. Betriebssystem-Leitfaden
- Windows
- macOS
- Linux
Windows-Einrichtung
- Terminal: Öffnen Sie PowerShell, Windows Terminal oder die Eingabeaufforderung (CMD).
- Befehl:
- Für Lab-VM-Übungen:
- Windows 10/11 64-Bit empfohlen.
- Öffnen Sie den Task-Manager (Strg+Umschalt+Esc) → Tab [Leistung] und prüfen Sie, ob Virtualisierung: Aktiviert angezeigt wird.
3. Fehlerbehebung & FAQ (Troubleshooting)
Falls Verbindungsprobleme auftreten, prüfen Sie die folgenden Punkte:1. Befehl 'npx' oder 'node' wurde nicht gefunden
1. Befehl 'npx' oder 'node' wurde nicht gefunden
Die Node.js-Laufzeitumgebung ist auf Ihrem System noch nicht installiert.
- Windows: Laden Sie die LTS-Version von nodejs.org herunter oder nutzen Sie PowerShell:
- macOS: Von nodejs.org installieren oder per Homebrew:
- Linux (Ubuntu/Debian):
npx -y xkat-cli@latest up ausführen.2. Browser verharrt auf 'Warten auf Verbindung' oder schlägt fehl
2. Browser verharrt auf 'Warten auf Verbindung' oder schlägt fehl
- Terminal geöffnet lassen: Das Terminalfenster mit dem aktiven Agenten darf nicht geschlossen werden.
- Port freigeben und neu starten: Falls Port 38000–38050 durch eine alte Sitzung blockiert ist:
- Firewall/Antivirus: Sicherstellen, dass Sicherheitssoftware interne Loopback-Verbindungen auf
127.0.0.1nicht blockiert.
3. Fehler beim Erstellen oder Starten der Lab-VM (Ubuntu VM)
3. Fehler beim Erstellen oder Starten der Lab-VM (Ubuntu VM)
- Windows-Virtualisierung prüfen:
- Falls Virtualisierung im Task-Manager deaktiviert ist, aktivieren Sie Intel VT-x oder AMD SVM in den BIOS/UEFI-Einstellungen Ihres PCs.
- Vollständiger VM-Reset:
- Setzen Sie die virtuelle Maschine mit folgendem Befehl sauber zurück:
- Setzen Sie die virtuelle Maschine mit folgendem Befehl sauber zurück:
4. Agent nach Übungsende beenden
4. Agent nach Übungsende beenden
Führen Sie diesen Befehl im Terminal aus, um Hintergrundprozesse sauber zu beenden: