Muddog Fehlerbehebung

Prüfen Sie zunächst unter Verbindung, ob das Problem Ihre VPN-Verbindung oder Meine Internetfreigabe betrifft. Die Ursache wird in den jeweiligen Verbindungsdetails oder unter Fehlerdetails der Fehlermeldung angezeigt.

Symptom	Prüfen
Keine Verbindung zum Dienst möglich	Dienststatus und Zugriffsrechte
Länderliste leer oder Verbindungsaufbau fehlgeschlagen	Land und Verbindungspartner
Status „Verbunden“, aber unveränderte IP-Adresse oder kein Zugriff	VPN-Geltungsbereich und Datenverkehr
App-Startschaltfläche nicht anklickbar oder VPN bei einzelnen Apps wirkungslos	VPN pro App
Fehlermeldung zu einer vom Dienst nicht unterstützten Funktion	App- und Dienstversion
Nur die eigene Internetfreigabe schlägt fehl	Freigabe und Protokollspeicherung

Keine Verbindung zum Dienst möglich

Die App liest den Status des Hintergrunddienstes und zeigt ihn an. Diese Meldung bedeutet, dass die App den Status nicht abrufen kann. Sie bedeutet nicht, dass VPN oder Freigabe sicher ausgeschaltet sind.

Sobald der Dienst wieder funktioniert, verbindet sich die App automatisch mit ihm. Prüfen Sie anhand der folgenden Schritte den Status und die Zugriffsrechte für Ihr Betriebssystem. Mit dem Start des Dienstes beginnt auch die Internetfreigabe.

Linux

1. Wenn Sie die App gerade installiert haben, melden Sie sich vom Desktop ab und wieder an. Öffnen Sie danach die App.

2. Prüfen Sie im Terminal den Dienststatus.

   systemctl status muddog-engine.service --no-pager

3. Wenn der Dienst gestoppt ist und Sie VPN und Freigabe wieder nutzen möchten, starten Sie ihn. Mit dem Start beginnt auch die Internetfreigabe erneut.

   sudo systemctl start muddog-engine.service

4. Wenn der Dienst läuft, die App aber keinen Zugriff erhält, führen Sie im Terminal des Benutzerkontos, mit dem Sie die App verwenden, id -nG aus. Prüfen Sie, ob die Gruppe muddog aufgeführt ist.

Fehlt die Gruppenmitgliedschaft, weil ein Administrator über ein anderes Konto installiert hat, führen Sie den folgenden Befehl in einem Terminal aus, in dem Sie als der normale Benutzer angemeldet sind, der die App verwenden soll. Melden Sie sich danach vom Desktop ab und wieder an.

sudo usermod -aG muddog "$(id -un)"

Starten Sie die App nicht ersatzweise mit Administratorrechten. Wenn der Dienst selbst nicht startet, können Sie mit folgendem Befehl die letzten Fehler prüfen:

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows

Prüfen Sie den Dienststatus in PowerShell:

Get-Service -Name muddog-engine

Wenn der Dienst gestoppt ist, starten Sie ihn in einer als Administrator gestarteten PowerShell:

Start-Service -Name muddog-engine

Wenn Sie den Dienst deaktiviert haben, folgen Sie der Anleitung zum erneuten Aktivieren des automatischen Starts. Fehlt der Dienst oder fehlen benötigte Dateien, installieren oder reparieren Sie ihn mit dem neuesten MSI-Paket. Starten Sie die App mit normalen Benutzerrechten.

macOS

1. Prüfen Sie, ob Sie macOS 13 oder neuer verwenden und Muddog.app nach /Applications kopiert haben.
2. Prüfen Sie, ob Sie mit einem macOS-Administratorkonto angemeldet sind.
3. Fordern Sie über Service → Enable Background Service die Registrierung des Dienstes an.
4. Genehmigen Sie unter Service → Background Service Settings… die Ausführung von Muddog im Hintergrund. Warten Sie danach, bis sich die App wieder mit dem Dienst verbindet.

Den Status des registrierten Dienstes können Sie auch im Terminal prüfen:

sudo launchctl print system/net.3rocks.muddog.engine

Wenn Sie die App aus dem DMG oder einem anderen Ordner starten, kann der Dienst nicht registriert werden. Falls nach dem Ersetzen der bisherigen App Probleme auftreten, entfernen Sie den Dienst gemäß der Update-Anleitung für macOS und starten die App erneut.

Wenn der Fehler trotz dieser Schritte bestehen bleibt, geben Sie die Dienstfehler im Problembericht an.

Länderliste leer oder Verbindungsaufbau fehlgeschlagen

1. Prüfen Sie, ob der normale Internetzugang funktioniert.
2. Klicken Sie auf Verbindungsland → Liste aktualisieren.
3. Falls das ausgewählte Land aus der Liste verschwunden ist, verwenden Sie Automatische Auswahl oder ein anderes Land.
4. Falls Sie den Verbindungsserver geändert haben, stellen Sie die Standardwerte der erweiterten Einstellungen wieder her und speichern Sie sie.
5. Wenn der Verbindungsaufbau weiterhin fehlschlägt, prüfen Sie die Verbindungsdetails.

P2P-Verbindungen hängen von den Teilnehmern im gewählten Land und den Netzwerkbedingungen auf beiden Seiten ab. Die Anzeige eines Landes garantiert keine Verbindung. Wenn kein Partner verfügbar ist, versuchen Sie es später erneut oder wählen Sie ein anderes Land. Um zu prüfen, ob Einschränkungen einer Firewall oder eines Routers die Ursache sind, können Sie den Verbindungsaufbau auch über einen anderen verfügbaren Internetanschluss vergleichen.

Die Höchstzahl von zehn bezeichnet das Limit der Verbindungsversuche. Wird kein Partner gefunden, kann der Vorgang früher enden. Nach dem Abbruch einer bereits bestehenden VPN-Verbindung müssen Sie sich selbst erneut verbinden.

Status „Verbunden“, aber unveränderte IP-Adresse oder kein Zugriff

1. Prüfen Sie unter Verbindung → Geltungsbereich der aktuellen Verbindung, ob der gewünschte Modus aktiv ist. Wenn Sie nur gespeichert, aber nicht erneut verbunden haben, gilt weiterhin der vorherige Bereich.
2. Prüfen Sie im IP-basierten Modus, ob die gewünschte Ziel-IP in der Liste enthalten beziehungsweise ausgeschlossen ist. Domainnamen können nicht in die Adressliste eingetragen werden.
3. Beenden Sie im App-Modus die betreffende App vollständig und starten Sie sie über Muddog neu.
4. Prüfen Sie, ob die betreffende Verbindung IPv6 verwendet. IPv6 läuft nicht durch das VPN. Im App-Modus unter Windows wird die IPv6-Kommunikation der ausgewählten Apps blockiert.
5. Wenn Sie parallel ein anderes VPN oder ein Werkzeug zur Netzwerkverwaltung verwenden, vergleichen Sie das Verhalten auch bei getrennter Verbindung dieses Werkzeugs. Von anderen Werkzeugen gesetzte Routen können Vorrang haben.

Wenn der Browser für die IP-Prüfung oder die Prüfseite selbst nicht vom VPN erfasst wird, ist die Anzeige der IP-Adresse Ihres bisherigen Anschlusses normal. Auch DNS kann je nach Modus und IP-Adresse des DNS-Servers den bisherigen Anschluss verwenden.

Wenn eine Website weiterhin Länderbeschränkungen anwendet, prüfen Sie ein anderes Land oder einen anderen Verbindungspartner. Muddog garantiert weder den Zugang zu einem bestimmten Dienst noch eine bestimmte Geschwindigkeit.

Wenn Sie unter macOS den verwendeten Anschluss, etwa WLAN, gewechselt haben, trennen Sie das VPN und verbinden sich erneut. Meldet der Modus zum Einschließen von IP-Adressen einen Konflikt mit einer von einem anderen Programm gesetzten Hostroute, prüfen Sie die Verbindung dieses Programms und die angegebenen IP-Adressen und Bereiche.

VPN pro App greift nicht

• macOS unterstützt VPN pro App nicht. Verwenden Sie VPN für das gesamte Internet oder nach IP-Adressen und Bereichen.
• Wenn Über VPN starten deaktiviert ist, prüfen Sie, ob Sie den App-Modus gespeichert haben, in diesem Modus mit dem VPN verbunden sind und eine App zum Starten ausgewählt haben.
• Wenn die App-Liste leer ist, verwenden Sie Liste aktualisieren oder Ausführbare Datei suchen.
• Wenn der Browser lediglich ein bestehendes Fenster öffnet, beenden Sie auch seine Hintergrundprozesse und starten ihn danach neu.
• Apps, die den Start an einen separaten Dienst übergeben oder eine bereits laufende Instanz wiederverwenden, werden nicht unterstützt. Prüfen Sie die Installationsart und die Voraussetzungen für VPN pro App.
• Unter Linux werden Snap- und Flatpak-Apps nicht unterstützt. Bei Fehlern zur systemd-Benutzersitzung, zu cgroup v2 oder nftables prüfen Sie die jeweilige Umgebung und nehmen die Fehlerdetails in den Problembericht auf.
• Unter Windows müssen Sie die .exe-Datei des zu startenden Programms auswählen. Nach einer erneuten VPN-Verbindung müssen Sie das Programm vollständig beenden und über Muddog neu starten.
• Wenn unter Windows eine Fehlermeldung auf fehlende oder nicht ladbare WinDivert-Komponenten hinweist, reparieren oder installieren Sie Muddog mit dem MSI-Paket erneut. Bleibt der Fehler bestehen, melden Sie die Fehlerdetails.

Unterschiedliche Versionen von App und Dienst

Wenn die App mit einem älteren Dienst verbunden ist, der die angeforderte Funktion nicht unterstützt, tritt ein Fehler auf. Aktualisieren Sie App und Dienst gemeinsam mit dem neuen Paket. Dass VPN pro App unter macOS nicht verfügbar ist, liegt am Funktionsumfang und ist kein Versionsfehler.

Wenn derselbe Fehler nach dem Update bestehen bleibt, starten Sie den Dienst mit dem für Ihr Betriebssystem beschriebenen Verfahren neu. Der Neustart unterbricht laufende persönliche VPN- und Freigabeverbindungen.

Unter Linux schließen Sie die App, führen den folgenden Befehl aus und öffnen die App anschließend erneut:

sudo systemctl restart muddog-engine.service

Unter Windows schließen Sie die App, führen den folgenden Befehl in einer als Administrator gestarteten PowerShell aus und öffnen die App anschließend erneut:

Restart-Service -Name muddog-engine

Unter macOS wählen Sie Service → Remove Background Service and Quit, starten Muddog aus /Applications erneut und erteilen die erforderlichen Dienstgenehmigungen.

Nach dem Dienstneustart müssen Sie das VPN erneut verbinden. Wenn der Fehler bleibt, melden Sie die App-Version und die Fehlerdetails, statt den Dienst wiederholt neu zu starten.

Nur die Internetfreigabe schlägt fehl oder Protokolle lassen sich nicht lesen

Prüfen Sie zuerst Meine Internetfreigabe → Verbindungsdetails. Bei zu wenig Speicherplatz für Protokolle, Überschreitung des Speicherlimits oder Dateischreibfehlern wird die Freigabe angehalten. Die Protokolle werden gemäß den lokalen Aufbewahrungsregeln gespeichert.

Prüfen Sie den freien Speicherplatz und die Dienstprotokolle. Wenn Sie die aufbewahrten Protokolle benötigen, löschen Sie sie nicht einfach zur Beseitigung des Fehlers, sondern wenden Sie sich mit der Fehlermeldung an den Support.

Wenn nur die Protokollabfrage fehlschlägt, prüfen Sie Dienstversion und Zugriffsrechte. Falls sich die Daten während der Abfrage durch die Bereinigung tagesbezogener Protokolle geändert haben, wählen Sie Datum und Kriterien erneut und klicken auf Abfragen. Ist die Abfrage erfolgreich, aber das Ergebnis leer, prüfen Sie UTC-Datum, Filter und Weitere Einträge.