Pomoc techniczna

1. Windows: program antywirusowy lub EDR blokuje instalację agenta
2. Windows: inne problemy
3. macOS
4. Raspberry Pi i Linux
5. Połączenie, panel i konto
6. Przydatne polecenia

Windows: program antywirusowy lub EDR blokuje instalację agenta

Objawy

• Program ochronny przenosi pobrany plik myremde-agent-….exe do kwarantanny albo pokazuje komunikat w rodzaju: „Zaawansowana Kontrola Zagrożeń zaczęła dezynfekcję procesu uznanego jako złośliwy… Nazwa zagrożenia: ATC.SuspiciousBehavior…” (Bitdefender GravityZone).
• Instalator kończy się błędem Blad: zapis konfiguracji: open C:\ProgramData\myRemDe\agent.json: Access is denied. albo Blad: instalacja zakonczona kodem 1, mimo że PowerShell działa jako administrator.
• Po restarcie usługa myremde-agent nie startuje, a plik C:\Program Files\myRemDe\myremde-agent.exe zniknął.

Dlaczego tak się dzieje

Agent BlueWato to pojedynczy plik wykonywalny bez klasycznego instalatora: jest pobierany skryptem PowerShell, rejestruje usługę systemową, przechwytuje obraz ekranu i steruje myszą oraz klawiaturą. Dokładnie tak zachowują się również narzędzia zdalnego dostępu wykorzystywane przez przestępców, a systemy klasy EDR (Bitdefender ATC/HyperDetect, ESET, Microsoft Defender for Endpoint, Sophos, CrowdStrike…) oceniają zachowanie programu, nie jego treść. Nieznany, niepodpisany plik uruchomiony z katalogu tymczasowego bywa więc blokowany, zanim zdąży cokolwiek zapisać. Plik agenta nie jest jeszcze podpisany certyfikatem wydawcy (pracujemy nad tym); jego autentyczność możesz sprawdzić sumą kontrolną — patrz niżej.

Rozwiązanie krok po kroku

1. Dodaj wykluczenia w programie ochronnym — przed instalacją. Wyklucz foldery C:\Program Files\myRemDe\ i C:\ProgramData\myRemDe\ oraz proces C:\Program Files\myRemDe\myremde-agent.exe. Samo wykluczenie w skanerze plików nie wystarczy — dodaj je także w modułach analizujących zachowanie:
   • Bitdefender GravityZone (konsola administratora): Policies → polityka przypisana do komputera → Antimalware → Settings → Custom Exclusions: dodaj wpisy typu Folder (oba katalogi) i Process (plik .exe) z zaznaczonymi modułami On-access, ATC/IDS (Advanced Threat Control), Ransomware Mitigation oraz — jeśli włączony — HyperDetect. Zapisz politykę i odczekaj kilka minut, aż komputer ją pobierze. Plik z kwarantanny możesz przywrócić w Quarantine, ale nie jest to konieczne.
   • Bitdefender dla użytkowników domowych: Ochrona → Antywirus → Ustawienia → Zarządzaj wyjątkami.
   • Zabezpieczenia Windows (Microsoft Defender): Ochrona przed wirusami i zagrożeniami → Zarządzaj ustawieniami → Wykluczenia → Dodaj wykluczenie (folder). Jeśli włączono Kontrolowany dostęp do folderów, dodaj też plik agenta do dozwolonych aplikacji.
   • ESET: Ustawienia zaawansowane (F5) → Silnik detekcji → Wykluczenia. Inne programy: szukaj sekcji „Wykluczenia” lub „Wyjątki”.
2. Wygeneruj w panelu nowy kod parowania. Otwórz stronę instalacji urządzenia i kliknij Nowy kod. Kod jest jednorazowy: jeśli poprzednia próba doszła do etapu „Parowanie z …”, panel zużył go i kolejna próba ze starym kodem skończy się błędem o nieprawidłowym lub wygasłym kodzie. Agent od wersji 0.1.3 sprawdza możliwość zapisu przed parowaniem, więc blokada zapisu nie marnuje już kodu.
3. Uruchom ponownie polecenie z panelu w PowerShellu jako administrator. Instalator zapisuje agenta od razu w C:\Program Files\myRemDe\myremde-agent.exe (nie w katalogu tymczasowym), więc wykluczenia z punktu 1 obejmują także sam proces instalacji. Po nieudanej próbie plik zostaje na miejscu — po dodaniu wykluczeń wystarczy samo polecenie instalacji:

   & "C:\Program Files\myRemDe\myremde-agent.exe" install --code NOWY_KOD --server https://panel.bluewato.com

4. Bez skryptu: pobierz z panelu plik myremde-agent-windows-amd64.exe (albo arm64), zapisz go jako C:\Program Files\myRemDe\myremde-agent.exe i wykonaj polecenie z punktu 3. Przy ręcznym uruchomieniu SmartScreen może pokazać „System Windows ochronił ten komputer” — kliknij Więcej informacji → Uruchom mimo to.
5. Sprawdź wynik: Get-Service myremde-agent powinno pokazać stan Running, w dzienniku C:\ProgramData\myRemDe\agent.log pojawia się połączenie z panelem, a urządzenie w panelu zmienia stan na online.

Get-FileHash "C:\Program Files\myRemDe\myremde-agent.exe" -Algorithm SHA256

Windows: inne problemy

• Usługa nie startuje po restarcie, urządzenie jest offline. Sprawdź Get-Service myremde-agent. Jeśli pliku C:\Program Files\myRemDe\myremde-agent.exe nie ma — usunął go program antywirusowy (sekcja wyżej). Jeśli usługa działa, a urządzenie nadal jest offline, zajrzyj do dziennika C:\ProgramData\myRemDe\agent.log i sprawdź, czy komputer ma dostęp do https://panel.bluewato.com.
• Pulpit jest czarny, konsola działa. Usługa nie uruchomiła procesu roboczego w sesji zalogowanego użytkownika. W dzienniku szukaj wpisu „agent uruchomiony w sesji”; pomaga Restart-Service myremde-agent albo wylogowanie i ponowne zalogowanie użytkownika.
• Ctrl+Alt+Del z panelu nie działa. Agent został zainstalowany starszą wersją, która nie ustawiała polityki SAS. Powtórz instalację (polecenie z panelu lub myremde-agent install) — nowe parowanie nie jest potrzebne, jeśli użyjesz aktualnego kodu z panelu.
• Połączenie jest wolne albo przechodzi przez przekaźnik. Instalator zakłada regułę zapory Windows dla pliku agenta; jeśli została usunięta, powtórz instalację. Zapory sieciowe blokujące UDP wymuszają objazd przez serwer TURN — patrz sekcja „Połączenie”.

macOS

• „Nie można otworzyć, ponieważ pochodzi od niezidentyfikowanego dewelopera”. Plik pobrany przeglądarką dostaje znacznik kwarantanny. Polecenie z panelu usuwa go samo; przy pobraniu ręcznym wykonaj xattr -d com.apple.quarantine ~/Downloads/myremde-agent-darwin-arm64 przed uruchomieniem.
• Pulpit pokazuje samą tapetę. Brak zgody na nagrywanie ekranu: Ustawienia systemowe → Prywatność i ochrona → Nagrywanie ekranu i dźwięku systemowego → włącz myremde-agent. Po aktualizacji agenta system może poprosić o zgodę ponownie.
• Obraz jest, ale mysz i klawiatura nie reagują. Brak zgody Dostępność w tym samym miejscu ustawień.
• Urządzenie offline po restarcie Maca. Agent działa w sesji zalogowanego użytkownika. Zaloguj się na Macu albo włącz automatyczne logowanie (Użytkownicy i grupy).

Raspberry Pi i Linux

• Urządzenie offline. Sprawdź stan usługi: sudo systemctl status myremde-agent, dziennik: sudo journalctl -u myremde-agent -f. Upewnij się, że urządzenie dociera do panelu (curl -sI https://panel.bluewato.com) i ma poprawny czas (timedatectl).
• Pulpit czarny albo komunikat o braku środowiska graficznego. Na urządzeniu nie działa sesja graficzna (np. system bez ekranu) albo używa nieobsługiwanego kompozytora. Konsola działa niezależnie od pulpitu; urządzenie bez ekranu instaluj z opcją „tylko konsola” (--no-screen).
• Mysz i klawiatura nie reagują. Brak modułu uinput: sudo modprobe uinput. Instalator dopisuje moduł do /etc/modules-load.d, więc po restarcie ładuje się sam.
• Kod parowania odrzucony. Kod jest jednorazowy i ważny 60 minut — wygeneruj nowy w panelu i powtórz instalację.

Połączenie, panel i konto

• W dzienniku agenta „unauthorized”, urządzenie offline. W panelu wygenerowano nowy kod parowania dla tego urządzenia, co unieważniło dotychczasowy token. Zainstaluj agenta ponownie z nowym kodem.
• Sesja nie zestawia się albo obraz jest bardzo wolny. Sieć po jednej ze stron blokuje UDP, więc dane idą przez przekaźnik TURN zamiast bezpośrednio. Zezwól na ruch wychodzący UDP (co najmniej do portu 3478 serwera panel.bluewato.com) i sprawdź, czy zapora nie blokuje przeglądarki lub agenta.
• „Bilet nieprawidłowy lub wygasł”. Zegar komputera lub urządzenia jest przestawiony. Bilet sesji ważny jest dwie minuty, więc włącz synchronizację czasu i spróbuj ponownie.
• Urządzenie w trybie czuwania nie budzi się. Kliknij kartę urządzenia jeszcze raz; wybudzenie trwa zwykle do kilkunastu sekund. Jeśli urządzenie pozostaje w czuwaniu, sprawdź jego połączenie z panelem.
• Kod 2FA nie dochodzi. Sprawdź folder spamu; nadawcą jest info@bluewato.pl. Dodaj ten adres do kontaktów, aby kolejne kody trafiały do skrzynki odbiorczej.
• „Zbyt wiele prób”. Zadziałał limit prób logowania lub parowania. Odczekaj 15 minut i spróbuj ponownie.
• Sesja kończy się po 30 minutach. To limit pojedynczej sesji w planie Free (nie obowiązuje w okresie startowym). Możesz połączyć się od razu ponownie albo zmienić plan w panelu.

Przydatne polecenia

Po usunięciu agenta skasuj urządzenie także w panelu (menu urządzenia → Usuń urządzenie).

Ostatnia aktualizacja: 2026-08-27 · Kontakt