Technischer Support

1. Windows: Antivirus- oder EDR-Software blockiert die Installation des Agenten
2. Windows: weitere Probleme
3. macOS
4. Raspberry Pi und Linux
5. Verbindung, Panel und Konto
6. Nützliche Befehle

Windows: Antivirus- oder EDR-Software blockiert die Installation des Agenten

Symptome

• Die Schutzsoftware verschiebt die heruntergeladene Datei myremde-agent-….exe in die Quarantäne oder zeigt eine Meldung wie „Advanced Threat Control hat mit der Desinfektion eines als bösartig erkannten Prozesses begonnen… Bedrohungsname: ATC.SuspiciousBehavior…“ (Bitdefender GravityZone).
• Der Installer endet mit Blad: zapis konfiguracji: open C:\ProgramData\myRemDe\agent.json: Access is denied. oder Blad: instalacja zakonczona kodem 1, obwohl PowerShell als Administrator läuft.
• Nach einem Neustart startet der Dienst myremde-agent nicht, und die Datei C:\Program Files\myRemDe\myremde-agent.exe ist verschwunden.

Warum das passiert

Der BlueWato-Agent ist eine einzelne ausführbare Datei ohne klassischen Installer: Er wird von einem PowerShell-Skript heruntergeladen, registriert einen Systemdienst, nimmt den Bildschirm auf und steuert Maus und Tastatur. Genau so verhalten sich auch Fernzugriffswerkzeuge, die von Kriminellen eingesetzt werden, und EDR-Produkte (Bitdefender ATC/HyperDetect, ESET, Microsoft Defender for Endpoint, Sophos, CrowdStrike…) bewerten das Verhalten eines Programms, nicht seinen Inhalt. Eine unbekannte, unsignierte Datei aus einem temporären Ordner wird deshalb mitunter blockiert, bevor sie etwas schreiben kann. Die Agentendatei ist noch nicht mit einem Herausgeberzertifikat signiert (wir arbeiten daran); ihre Echtheit lässt sich per Prüfsumme kontrollieren — siehe unten.

Lösung Schritt für Schritt

1. Ausnahmen in der Schutzsoftware anlegen — vor der Installation. Schließe die Ordner C:\Program Files\myRemDe\ und C:\ProgramData\myRemDe\ sowie den Prozess C:\Program Files\myRemDe\myremde-agent.exe aus. Eine Ausnahme nur im Dateiscanner genügt nicht — trage sie auch in den Modulen zur Verhaltensanalyse ein:
   • Bitdefender GravityZone (Admin-Konsole): Policies → die dem Computer zugewiesene Richtlinie → Antimalware → Settings → Custom Exclusions: Einträge vom Typ Folder (beide Ordner) und Process (die .exe) mit den Modulen On-access, ATC/IDS (Advanced Threat Control), Ransomware Mitigation und — falls aktiv — HyperDetect. Richtlinie speichern und einige Minuten warten, bis der Computer sie erhält. Die Datei kann aus der Quarantäne wiederhergestellt werden, das ist aber nicht nötig.
   • Bitdefender für Privatanwender: Schutz → Virenschutz → Einstellungen → Ausnahmen verwalten.
   • Windows-Sicherheit (Microsoft Defender): Viren- & Bedrohungsschutz → Einstellungen verwalten → Ausschlüsse → Ausschluss hinzufügen (Ordner). Ist der Überwachte Ordnerzugriff aktiv, die Agentendatei zusätzlich als zugelassene App eintragen.
   • ESET: Erweiterte Einstellungen (F5) → Erkennungsroutine → Ausschlüsse. Andere Produkte: nach einem Abschnitt „Ausnahmen“ oder „Ausschlüsse“ suchen.
2. Neuen Kopplungscode im Panel erzeugen. Öffne die Installationsseite des Geräts und klicke auf Neuer Code. Der Code ist einmalig: Hat der vorige Versuch den Schritt „Parowanie z …“ erreicht, wurde er verbraucht, und ein weiterer Versuch mit dem alten Code scheitert mit „Code ungültig oder abgelaufen“. Seit Version 0.1.3 prüft der Agent vor der Kopplung, ob er seine Dateien schreiben kann — eine Schreibblockade verbraucht den Code nicht mehr.
3. Den Befehl aus dem Panel erneut ausführen — in PowerShell als Administrator. Der Installer speichert den Agenten direkt als C:\Program Files\myRemDe\myremde-agent.exe (nicht in einem temporären Ordner), sodass die Ausnahmen aus Schritt 1 auch die Installation selbst abdecken. Nach einem fehlgeschlagenen Versuch bleibt die Datei liegen — nach dem Eintragen der Ausnahmen genügt der Installationsbefehl allein:

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

4. Ohne Skript: myremde-agent-windows-amd64.exe (oder arm64) aus dem Panel herunterladen, als C:\Program Files\myRemDe\myremde-agent.exe speichern und den Befehl aus Schritt 3 ausführen. Beim manuellen Start kann SmartScreen „Der Computer wurde durch Windows geschützt“ anzeigen — Weitere Informationen → Trotzdem ausführen.
5. Ergebnis prüfen: Get-Service myremde-agent sollte Running melden, im Protokoll C:\ProgramData\myRemDe\agent.log erscheint die Verbindung zum Panel, und das Gerät im Panel wechselt auf online.

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

Windows: weitere Probleme

• Der Dienst startet nach dem Neustart nicht, das Gerät ist offline. Prüfe Get-Service myremde-agent. Fehlt C:\Program Files\myRemDe\myremde-agent.exe, hat der Virenschutz die Datei entfernt (Abschnitt oben). Läuft der Dienst, das Gerät bleibt aber offline, sieh ins Protokoll C:\ProgramData\myRemDe\agent.log und prüfe, ob der Computer https://panel.bluewato.com erreicht.
• Der Desktop ist schwarz, die Konsole funktioniert. Der Dienst hat den Arbeitsprozess in der Sitzung des angemeldeten Benutzers nicht gestartet. Suche im Protokoll nach „agent uruchomiony w sesji“; Restart-Service myremde-agent oder Ab- und erneutes Anmelden des Benutzers hilft.
• Strg+Alt+Entf aus dem Panel funktioniert nicht. Der Agent wurde mit einer älteren Version installiert, die die SAS-Richtlinie nicht gesetzt hat. Wiederhole die Installation (Befehl aus dem Panel oder myremde-agent install).
• Die Verbindung ist langsam oder läuft über das Relay. Der Installer legt eine Windows-Firewall-Regel für die Agentendatei an; wurde sie entfernt, wiederhole die Installation. Netzwerk-Firewalls, die UDP blockieren, erzwingen den Umweg über den TURN-Server — siehe „Verbindung“.

macOS

• „Kann nicht geöffnet werden, da es von einem nicht verifizierten Entwickler stammt“. Eine mit dem Browser geladene Datei erhält eine Quarantäne-Markierung. Der Befehl aus dem Panel entfernt sie automatisch; bei manuellem Download zuerst xattr -d com.apple.quarantine ~/Downloads/myremde-agent-darwin-arm64 ausführen.
• Der Desktop zeigt nur das Hintergrundbild. Die Berechtigung zur Bildschirmaufnahme fehlt: Systemeinstellungen → Datenschutz & Sicherheit → Bildschirm- & Systemaudioaufnahme → myremde-agent aktivieren. Nach einem Agenten-Update fragt das System eventuell erneut.
• Bild vorhanden, aber Maus und Tastatur reagieren nicht. Die Berechtigung Bedienungshilfen in denselben Einstellungen fehlt.
• Gerät nach dem Neustart des Mac offline. Der Agent läuft in der Sitzung des angemeldeten Benutzers. Melde dich am Mac an oder aktiviere die automatische Anmeldung (Benutzer & Gruppen).

Raspberry Pi und Linux

• Gerät offline. Dienst prüfen: sudo systemctl status myremde-agent, Protokoll: sudo journalctl -u myremde-agent -f. Stelle sicher, dass das Gerät das Panel erreicht (curl -sI https://panel.bluewato.com) und die richtige Zeit hat (timedatectl).
• Schwarzer Desktop oder „keine grafische Umgebung“. Auf dem Gerät läuft keine grafische Sitzung (z. B. headless) oder ein nicht unterstützter Compositor. Die Konsole funktioniert unabhängig vom Desktop; Geräte ohne Bildschirm mit der Option „nur Konsole“ (--no-screen) installieren.
• Maus und Tastatur reagieren nicht. Das Modul uinput fehlt: sudo modprobe uinput. Der Installer trägt das Modul in /etc/modules-load.d ein, sodass es nach dem Neustart automatisch geladen wird.
• Kopplungscode abgelehnt. Der Code ist einmalig und 60 Minuten gültig — im Panel einen neuen erzeugen und die Installation wiederholen.

Verbindung, Panel und Konto

• „unauthorized“ im Agenten-Protokoll, Gerät offline. Im Panel wurde für dieses Gerät ein neuer Kopplungscode erzeugt, wodurch das bisherige Token ungültig wurde. Installiere den Agenten mit dem neuen Code erneut.
• Die Sitzung kommt nicht zustande oder das Bild ist sehr langsam. Das Netzwerk auf einer Seite blockiert UDP, die Daten laufen daher über das TURN-Relay statt direkt. Erlaube ausgehendes UDP (mindestens zu Port 3478 von panel.bluewato.com) und prüfe, ob eine Firewall Browser oder Agent blockiert.
• „Ticket ungültig oder abgelaufen“. Die Uhr des Computers oder Geräts geht falsch. Ein Sitzungsticket ist zwei Minuten gültig — Zeitsynchronisierung einschalten und erneut versuchen.
• Ein Gerät im Bereitschaftsmodus wacht nicht auf. Klicke die Gerätekarte erneut an; das Aufwecken dauert meist bis zu einigen Sekunden. Bleibt das Gerät in Bereitschaft, prüfe seine Verbindung zum Panel.
• Der 2FA-Code kommt nicht an. Prüfe den Spam-Ordner; Absender ist info@bluewato.pl. Füge die Adresse den Kontakten hinzu, damit künftige Codes im Posteingang landen.
• „Zu viele Versuche“. Das Limit für Anmelde- oder Kopplungsversuche wurde erreicht. 15 Minuten warten und erneut versuchen.
• Die Sitzung endet nach 30 Minuten. Das ist das Limit pro Sitzung im Free-Plan (in der Startphase nicht aktiv). Du kannst dich sofort erneut verbinden oder den Plan im Panel wechseln.

Nützliche Befehle

Nach dem Entfernen des Agenten lösche das Gerät auch im Panel (Gerätemenü → Gerät löschen).

Letzte Aktualisierung: 2026-08-27 · Kontakt