Rozwiązywanie problemów

Czarny ekran

Czarny zdalny pulpit niemal zawsze oznacza brakujące uprawnienie na hoście (kontrolowanej maszynie). Pełną listę znajdziesz na stronie Uprawnienia.

Szybka lista kontrolna:

• macOS: przyznaj uprawnienie do nagrywania ekranu i uruchom ponownie usługę Wihaister
• Windows: sprawdź, czy usługa tunelowania działa — jej ikona powinna być widoczna w zasobniku systemowym
• Oba komputery online i połączone

Brak obrazu z kamery

Strumieniowanie kamery wymaga dostępu do kamery na stacji roboczej:

1. Otwórz Ustawienia systemowe → Prywatność i bezpieczeństwo → Kamera (macOS).
2. Włącz Wihaister i uruchom usługę ponownie.

Upewnij się też, że żadna inna aplikacja nie używa kamery wyłącznie — większość kamer może być otwarta tylko przez jedną aplikację naraz.

Problemy z kodem połączenia

Kody połączenia są jednorazowe i ważne 48 godzin od momentu wygenerowania.

• Jeśli kod zostanie odrzucony, wygeneruj nowy na hoście i spróbuj ponownie — stary kod nie może zostać użyty ponownie
• Wpisz kod dokładnie tak, jak jest wyświetlany, razem z myślnikami (format: XXXX-XXXX-XXXX)
• Kody wygasają automatycznie po 48 godzinach, nawet jeśli nigdy nie zostały użyte

Wolne połączenie

Wihaister automatycznie dostosowuje jakość obrazu do warunków sieciowych. Jeśli obraz działa ospale:

• Zbliż się do punktu dostępowego Wi-Fi lub użyj połączenia przewodowego
• Zamknij aplikacje obciążające łącze na obu komputerach
• Pamiętaj, że liczą się oba końce: najwolniejszy odcinek trasy ogranicza całą sesję
• Sesje korzystające z przekaźnika awaryjnego mają wyższe opóźnienia niż połączenia bezpośrednie

Dlaczego moja sesja korzysta z przekaźnika

Wihaister zawsze najpierw próbuje zestawić bezpośrednie połączenie peer-to-peer między Twoimi urządzeniami, automatycznie przebijając się przez NAT-y i zapory sieciowe. W niektórych środowiskach sieciowych bezpośrednia ścieżka po prostu nie może zostać ustanowiona — restrykcyjne zapory lub NAT operatorski to częste przyczyny.

W takim przypadku sesja korzysta z serwera przekaźnikowego tak długo, jak to konieczne. Twój ruch jest nadal szyfrowany od końca do końca: przekaźnik przekazuje wyłącznie zaszyfrowane bajty i nie może odczytać Twoich danych. Funkcjonalnie sesje przez przekaźnik zachowują się tak samo jak bezpośrednie — mogą mieć jedynie nieco wyższe opóźnienia.

Nie da się sprawdzić wewnątrz produktu, czy sesja jest bezpośrednia czy przez przekaźnik — połączenie zachowuje się identycznie w obu przypadkach.

Zrywanie połączenia

• Sprawdź, czy oba komputery są online i czy Wihaister działa na obu
• Klient łączy się ponownie automatycznie — poczekaj chwilę, zanim spróbujesz ręcznie
• Wpisz kod połączenia ponownie, jeśli sesji nie można wznowić; kody są jednorazowe, więc wyślij świeży kod z hosta
• Jeśli usługa tunelowania nie odpowiada, uruchom ją ponownie na hoście i połącz się ponownie

Zbieranie danych diagnostycznych

Jeśli potrzebujesz pomocy zespołu, kilka szczegółów przyspieszy diagnozę:

• Jakie platformy działają na obu komputerach (i wersje systemów)
• Co robiłeś, gdy pojawił się problem
• Czy problem występuje przy każdym połączeniu, czy tylko w określonych sieciach
• Dokładna treść każdego komunikatu o błędzie

Do zaawansowanej diagnostyki klienta desktopowego można uruchomić z pełnym logowaniem, ustawiając zmienną środowiskową RUST_LOG na debug przed uruchomieniem w terminalu.

Nadal nie działa

Wihaister jest we wczesnym dostępie. Jeśli powyższe kroki nie rozwiążą problemu, skontaktuj się z nami przez kanał podany w zaproszeniu do wczesnego dostępu — najlepiej wraz z danymi diagnostycznymi z poprzedniej sekcji.