Problembehandlung

Der Bildschirm ist schwarz

Ein schwarzer Remote-Desktop bedeutet fast immer eine fehlende Berechtigung auf dem Host (dem gesteuerten Rechner). Die vollständige Liste finden Sie unter Berechtigungen.

Schnellcheckliste:

• macOS: Bildschirmaufnahme-Berechtigung erteilen und den Wihaister-Dienst neu starten
• Windows: Prüfen, ob der Tunnel-Dienst läuft — sein Symbol sollte im System-Tray sichtbar sein
• Beide Rechner sind online und verbunden

Das Kamerabild fehlt

Kamera-Streaming erfordert Kamerazugriff auf der Workstation:

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Kamera (macOS).
2. Aktivieren Sie Wihaister und starten Sie den Dienst neu.

Stellen Sie außerdem sicher, dass keine andere Anwendung die Kamera exklusiv nutzt — die meisten Kameras können nur von einer Anwendung gleichzeitig geöffnet werden.

Probleme mit dem Verbindungscode

Verbindungscodes sind einmalig verwendbar und 48 Stunden ab dem Zeitpunkt ihrer Erstellung gültig.

• Wird ein Code abgelehnt, erzeugen Sie auf dem Host einen neuen und versuchen Sie es erneut — der alte Code kann nicht wiederverwendet werden
• Geben Sie den Code exakt wie angezeigt ein, einschließlich der Bindestriche (Format: XXXX-XXXX-XXXX)
• Codes verfallen automatisch nach 48 Stunden, auch wenn sie nie verwendet wurden

Die Verbindung ist langsam

Wihaister passt die Stream-Qualität automatisch an Ihre Netzwerkbedingungen an. Wenn das Bild träge wirkt:

• Näher an den WLAN-Zugangspunkt gehen oder eine Kabelverbindung nutzen
• Bandbreitenhungrige Anwendungen auf beiden Rechnern schließen
• Bedenken Sie: Beide Endpunkte zählen — das langsamste Glied in der Kette begrenzt die gesamte Sitzung
• Sitzungen über das Relay-Fallback haben eine höhere Latenz als direkte Verbindungen

Warum läuft meine Sitzung über ein Relay

Wihaister versucht immer zuerst eine direkte Peer-to-Peer-Verbindung zwischen Ihren Geräten herzustellen und durchstößt dabei NATs und Firewalls automatisch. In manchen Netzwerkumgebungen lässt sich ein direkter Pfad schlicht nicht aufbauen — restriktive Firewalls oder Carrier-Grade-NAT sind häufige Ursachen.

In diesem Fall fällt die Sitzung so lange auf einen Relay-Server zurück, wie es nötig ist. Ihr Datenverkehr bleibt Ende-zu-Ende-verschlüsselt: Das Relay leitet nur verschlüsselte Bytes weiter und kann Ihre Daten nicht lesen. Funktional verhalten sich Relay-Sitzungen wie direkte — sie können lediglich eine etwas höhere Latenz haben.

Ob eine Sitzung direkt oder über Relay läuft, lässt sich innerhalb des Produkts nicht erkennen — die Verbindung verhält sich in beiden Fällen identisch.

Verbindungsabbrüche

• Prüfen, ob beide Rechner online sind und Wihaister auf beiden läuft
• Der Client verbindet automatisch neu — kurz warten, bevor Sie manuell eingreifen
• Geben Sie den Verbindungscode erneut ein, wenn die Sitzung nicht fortgesetzt werden kann; Codes sind einmalig, teilen Sie also einen frischen Code vom Host
• Reagiert der Tunnel-Dienst nicht, starten Sie ihn auf dem Host neu und verbinden Sie erneut

Diagnosedaten sammeln

Wenn Sie Hilfe vom Team benötigen, beschleunigen ein paar Details die Fehlersuche:

• Welche Plattformen beide Rechner nutzen (und ihre Betriebssystemversionen)
• Was Sie gerade taten, als das Problem auftrat
• Ob das Problem bei jeder Verbindung oder nur in bestimmten Netzwerken auftritt
• Der genaue Wortlaut jeder Fehlermeldung

Für fortgeschrittene Diagnosen kann der Desktop-Client mit ausführlichem Logging gestartet werden, indem Sie die Umgebungsvariable RUST_LOG vor dem Start in einem Terminal auf debug setzen.

Immer noch festgefahren

Wihaister befindet sich im Early Access. Wenn sich ein Problem mit den obigen Schritten nicht lösen lässt, wenden Sie sich über den Kanal aus Ihrer Early-Access-Einladung an uns — idealerweise mit den Diagnosedaten aus dem vorherigen Abschnitt.