Muddog-problemen oplossen

Controleer op Verbinding eerst of het probleem bij Mijn VPN of Mijn internetdeling zit. De oorzaak staat in de bijbehorende Verbindingsdetails of Foutdetails van de melding.

Probleem	Controleer
Kan niet met de service verbinden	Servicestatus en toegangsrechten
Lege landenlijst of mislukte verbinding	Land en verbindingspartner
Verbonden, maar hetzelfde IP of geen toegang	VPN-bereik en verkeer
Startknop niet beschikbaar of één app gebruikt geen VPN	VPN per app
Service ondersteunt een functie niet	App- en serviceversie
Alleen internetdeling faalt	Delen en logboekopslag

Kan niet met de service verbinden

De app leest de status van de achtergrondservice. Deze melding betekent dat de app de status niet kan vaststellen, niet dat VPN of delen zeker uitstaat.

Zodra de service herstelt, verbindt de app automatisch opnieuw. Controleer hieronder de status en rechten voor je systeem. Starten van de service start ook internetdeling.

Linux

1. Log na een nieuwe installatie uit en opnieuw in op de desktop en open de app.

2. Controleer de service in de terminal:

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

3. Staat de service uit en wil je VPN en delen weer gebruiken, start deze dan. Internetdeling wordt tegelijk hervat.

   sudo systemctl start muddog-engine.service

4. Draait de service maar kan de app niet verbinden, voer dan id -nG uit als de gebruiker die de app gebruikt en controleer of muddog in de groepen staat.

Ontbreekt de groep doordat een beheerder vanuit een ander account heeft geïnstalleerd, voer dan onderstaande opdracht uit in een terminal van de gewone gebruiker die de app gaat gebruiken. Log daarna uit en opnieuw in op de desktop.

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

Start de app niet als beheerder als vervanging hiervoor. Als de service zelf niet start, bekijk recente fouten met:

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

Windows

Controleer de servicestatus in PowerShell:

Get-Service -Name muddog-engine

Start een gestopte service in PowerShell als beheerder:

Start-Service -Name muddog-engine

Is de service uitgeschakeld, volg dan Automatisch starten weer inschakelen. Ontbreekt de service of ontbreken bestanden, installeer of herstel dan met de nieuwste MSI. Start de app als gewone gebruiker.

macOS

1. Controleer of je macOS 13 of nieuwer gebruikt en Muddog.app naar /Applications hebt gekopieerd.
2. Controleer of je met een beheerdersaccount bent ingelogd.
3. Kies Service → Enable Background Service om registratie aan te vragen.
4. Keur achtergrondactiviteit goed via Service → Background Service Settings… en wacht tot de app opnieuw verbindt.

Je kunt de geregistreerde service ook in de terminal controleren:

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

Vanuit een DMG of andere map kan de app de service niet registreren. Ontstond het probleem na vervanging van de app, volg dan de macOS-updateprocedure om de service te verwijderen en de app opnieuw te starten.

Blijft het misgaan, vermeld de servicefout in een probleemrapport.

De landenlijst is leeg of verbinden mislukt

1. Controleer of gewone internettoegang werkt.
2. Klik op Verbindingsland → Lijst vernieuwen.
3. Is het gekozen land verdwenen, kies dan Automatisch kiezen of een ander land.
4. Heb je de verbindingsserver gewijzigd, herstel en bewaar dan de standaardwaarden van de geavanceerde instellingen.
5. Bekijk Verbindingsdetails als het blijft mislukken.

P2P-verbindingen hangen af van deelnemers in het gekozen land en de netwerken aan beide kanten. Een land in de lijst garandeert geen verbinding. Probeer later opnieuw of kies een ander land als geen partner beschikbaar is. Vergelijk zo mogelijk met een andere internetverbinding om firewall- of routerbeperkingen te onderzoeken.

Tien pogingen is het maximum, geen garantie. De poging kan eerder stoppen als er geen partner is. Als een bestaande VPN wegvalt, moet je zelf opnieuw verbinden.

Verbonden, maar hetzelfde IP of geen toegang

1. Controleer Verbinding → Huidig verbindingsbereik. Alleen opslaan zonder opnieuw verbinden laat het oude bereik actief.
2. Controleer in IP-modus of het bestemmings-IP in de opname- of uitsluitingslijst staat. Domeinnamen mogen niet in die lijst.
3. Sluit in appmodus de app volledig en start deze opnieuw vanuit Muddog.
4. Controleer of de verbinding IPv6 gebruikt. Dat gaat niet via de VPN; Windows-appmodus blokkeert IPv6 van geselecteerde apps.
5. Vergelijk met andere VPN’s of netwerkbeheertools uitgeschakeld. Hun routes kunnen voorrang krijgen.

Als de controlebrowser of IP-controlepagina buiten het VPN-bereik valt, is het normaal dat je bestaande IP verschijnt. Ook DNS kan afhankelijk van modus en server-IP de bestaande verbinding gebruiken.

Blijft een website geografisch geblokkeerd, probeer dan een ander land of een andere partner. Muddog garandeert geen toegang tot een dienst of een bepaalde snelheid.

Verbreek op macOS de VPN en verbind opnieuw nadat je van netwerk, bijvoorbeeld wifi, bent gewisseld. Meldt IP-opnamemodus een conflict met een hostroute van een ander programma, controleer dan die verbinding en je ingestelde IP-bereiken.

VPN per app wordt niet toegepast

• macOS ondersteunt dit niet. Gebruik heel internet of IP-bereiken.
• Is Via VPN starten uitgeschakeld, controleer dan of appmodus is opgeslagen, de VPN in die modus verbonden is en een app is gekozen.
• Gebruik Lijst vernieuwen of Uitvoerbaar bestand zoeken als de app-lijst leeg is.
• Opent de browser alleen een bestaand venster, sluit dan ook de achtergrondprocessen af en start opnieuw.
• Apps die een aparte service of bestaande instantie gebruiken worden niet ondersteund. Controleer de installatiemethode en vereisten voor VPN per app.
• Snap en Flatpak worden op Linux niet ondersteund. Controleer bij fouten over systemd-gebruikerssessies, cgroup v2 of nftables je omgeving en voeg Foutdetails toe aan een probleemrapport.
• Kies op Windows het .exe-bestand. Na opnieuw verbinden moet je het programma volledig sluiten en vanuit Muddog opnieuw starten.
• Ontbreekt WinDivert op Windows of kan het niet worden geladen, herstel of herinstalleer dan via de MSI. Meld de foutdetails als dit niet helpt.

App- en serviceversie verschillen

Een oude service die een door de app gevraagde functie niet ondersteunt veroorzaakt een fout. Werk app en service samen bij met een nieuw pakket. Het ontbreken van appmodus op macOS is een verschil in ondersteuning, geen versiefout.

Blijft de fout na bijwerken bestaan, herstart dan de service. Dit verbreekt actieve persoonlijke VPN- en deelverbindingen.

Sluit op Linux de app, voer het volgende uit en open de app opnieuw:

sudo systemctl restart muddog-engine.service

Sluit op Windows de app, voer in PowerShell als beheerder het volgende uit en open opnieuw:

Restart-Service -Name muddog-engine

Kies op macOS Service → Remove Background Service and Quit, start Muddog opnieuw vanuit /Applications en voltooi de goedkeuring.

Verbind de VPN daarna opnieuw. Blijft de fout bestaan, meld dan appversie en foutdetails in plaats van steeds te herstarten.

Alleen internetdeling faalt of logboeken zijn onleesbaar

Bekijk eerst Mijn internetdeling → Verbindingsdetails. Onvoldoende schijfruimte, overschrijding van de opslaglimiet of schrijffouten stoppen het delen. Gegevens worden volgens de lokale bewaarregels opgeslagen.

Controleer schijfruimte en servicelogboeken. Heb je de bewaarde gegevens nodig, verwijder ze dan niet zomaar om de fout weg te krijgen. Vraag ondersteuning met de foutmelding.

Faalt alleen het bekijken van logboeken, controleer dan servicetoegang en versie. Zijn gegevens tijdens het zoeken gewijzigd door dagelijkse opruiming, kies datum en filters opnieuw en klik op Zoeken. Is de zoekopdracht geslaagd maar leeg, controleer dan UTC-datum, filters en Volgende vermeldingen.