Dépannage de Muddog

Dans Connexion, déterminez d’abord si le problème concerne votre VPN ou Mon partage Internet. La cause apparaît dans les Détails de connexion correspondants ou les Détails de l’erreur de la notification.

Symptôme	À vérifier
Impossible de joindre le service	État et droits du service
Liste de pays vide ou échec de connexion	Pays et correspondants
Connecté, mais IP inchangée ou accès impossible	Portée et trafic
Bouton de lancement inaccessible ou application non couverte	VPN par application
Fonction non prise en charge par le service	Versions de l’application et du service
Seul le partage échoue	Partage et stockage des journaux

Impossible de joindre le service

L’application lit l’état du service en arrière-plan pour l’afficher. Ce message signifie qu’elle ne peut pas vérifier l’état, et non que le VPN ou le partage est nécessairement arrêté.

Elle se reconnecte automatiquement lorsque le service redevient disponible. Vérifiez son état et vos droits selon votre système. Démarrer le service démarre également le partage Internet.

Linux

1. Juste après l’installation, déconnectez puis reconnectez votre session de bureau avant d’ouvrir l’application.

2. Vérifiez le service dans le terminal.

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

3. S’il est arrêté et que vous souhaitez reprendre le VPN et le partage, démarrez-le. Le partage reprend immédiatement.

   sudo systemctl start muddog-engine.service

4. S’il fonctionne mais reste inaccessible à l’application, exécutez id -nG dans un terminal du compte utilisant l’application et vérifiez la présence de muddog.

Si le groupe manque parce que l’administrateur a installé depuis un autre compte, exécutez la commande suivante dans un terminal connecté comme l’utilisateur ordinaire qui utilisera l’application, puis déconnectez et reconnectez la session de bureau.

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

Ne remplacez pas cette procédure par un lancement de l’application en administrateur. Si le service lui-même ne démarre pas, consultez les erreurs récentes :

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

Windows

Vérifiez le service dans PowerShell :

Get-Service -Name muddog-engine

S’il est arrêté, démarrez-le dans PowerShell exécuté en tant qu’administrateur :

Start-Service -Name muddog-engine

S’il est désactivé, réactivez le démarrage automatique. Si le service ou des fichiers requis manquent, installez ou réparez avec le dernier MSI. Lancez l’application avec les droits ordinaires.

macOS

1. Vérifiez macOS 13 ou ultérieur et la copie de Muddog.app dans /Applications.
2. Vérifiez que le compte actuel est administrateur macOS.
3. Demandez l’enregistrement avec Service → Enable Background Service.
4. Autorisez l’arrière-plan dans Service → Background Service Settings…, puis attendez la reconnexion de l’application au service.

Vous pouvez aussi vérifier le service enregistré dans le terminal :

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

Le service ne peut pas être enregistré depuis le DMG ou un autre dossier. Si le problème suit le remplacement de l’application, retirez le service puis relancez l’application selon la procédure de mise à jour macOS.

Si ces étapes échouent, joignez les erreurs du service à un rapport de problème.

Liste de pays vide ou échec de connexion

1. Vérifiez votre accès Internet ordinaire.
2. Cliquez sur Pays de connexion → Actualiser la liste.
3. Si le pays sélectionné a disparu, utilisez Sélection automatique ou un autre pays.
4. Si vous avez modifié le serveur de connexion, restaurez et enregistrez les valeurs avancées par défaut.
5. En cas d’échec persistant, consultez les Détails de connexion.

La connexion P2P dépend des participants du pays choisi et des réseaux aux deux extrémités. La présence d’un pays ne garantit pas une connexion. Si aucun correspondant n’est disponible, réessayez plus tard ou choisissez un autre pays. Pour déterminer si un pare-feu ou routeur limite les communications, comparez avec une autre connexion Internet disponible.

Le maximum de 10 correspond au nombre de tentatives. Elles peuvent s’arrêter plus tôt si aucun correspondant n’est trouvé. Après la coupure d’un VPN établi, vous devez vous reconnecter manuellement.

Connecté, mais IP inchangée ou accès impossible

1. Vérifiez Connexion → Portée actuelle. Si vous avez enregistré sans reconnecter, l’ancienne portée reste appliquée.
2. En mode IP/plages, vérifiez l’inclusion ou l’exclusion de l’IP de destination souhaitée. Les noms de domaine ne sont pas acceptés dans la liste.
3. En mode par application, fermez complètement l’application puis relancez-la depuis Muddog.
4. Vérifiez si la connexion testée utilise IPv6. Il ne passe pas par le VPN ; le mode par application Windows le bloque pour les applications sélectionnées.
5. Si un autre VPN ou outil réseau est actif, comparez après l’avoir déconnecté. Ses routes peuvent avoir priorité.

Si le navigateur de vérification ou la page testée n’est pas couvert par le VPN, l’affichage de l’IP d’origine est normal. Le DNS peut également utiliser la connexion d’origine selon le mode et l’IP du serveur DNS.

Si une restriction géographique persiste sur un site, essayez un autre pays ou correspondant. Muddog ne garantit ni l’autorisation d’accès à ce service ni un débit particulier.

Sous macOS, après un changement de connexion, par exemple de Wi-Fi, déconnectez et reconnectez le VPN. Si le mode d’inclusion signale un conflit avec une route d’hôte créée par un autre programme, vérifiez cette connexion et les IP/plages définies.

VPN par application non appliqué

• macOS ne prend pas en charge ce mode. Utilisez tout Internet ou les IP/plages.
• Si Exécuter via le VPN est désactivé, vérifiez que le mode par application est enregistré, que le VPN est connecté dans ce mode et qu’une application est sélectionnée.
• Si la liste est vide, utilisez Actualiser la liste ou Rechercher un exécutable.
• Si le navigateur rouvre seulement une fenêtre existante, fermez aussi ses processus en arrière-plan avant de le lancer.
• Les applications déléguant à un service distinct ou réutilisant une instance existante ne sont pas prises en charge. Vérifiez l’installation et les conditions d’utilisation.
• Sous Linux, Snap et Flatpak ne sont pas pris en charge. Pour une erreur de session systemd, cgroup v2 ou nftables, vérifiez l’environnement et joignez les Détails de l’erreur au rapport.
• Sous Windows, choisissez le .exe à lancer. Après reconnexion VPN, fermez complètement le programme et relancez-le depuis Muddog.
• Si WinDivert manque ou ne se charge pas sous Windows, réparez ou réinstallez avec le MSI. Si l’erreur persiste, transmettez ses détails.

Versions différentes de l’application et du service

Une erreur apparaît si l’application se connecte à un ancien service ne prenant pas en charge la fonction demandée. Mettez les deux à jour avec le nouveau paquet. L’absence du VPN par application sous macOS est une différence de compatibilité, pas une erreur de version.

Si l’erreur persiste après mise à jour, redémarrez le service selon votre système. Ce redémarrage coupe les connexions VPN personnelles et de partage en cours.

Sous Linux, fermez l’application, exécutez puis rouvrez-la :

sudo systemctl restart muddog-engine.service

Sous Windows, fermez l’application, exécutez dans PowerShell administrateur puis rouvrez-la :

Restart-Service -Name muddog-engine

Sous macOS, choisissez Service → Remove Background Service and Quit, relancez Muddog depuis /Applications et accordez les autorisations nécessaires.

Reconnectez le VPN après le redémarrage du service. Si l’erreur persiste, rapportez la version et les détails plutôt que de répéter les redémarrages.

Échec du partage uniquement ou lecture des journaux impossible

Consultez d’abord Mon partage Internet → Détails de connexion. Le partage s’arrête en cas d’espace insuffisant, de limite de stockage atteinte ou d’erreur d’écriture. Les journaux suivent la politique de conservation locale.

Vérifiez l’espace disque et les journaux du service. Si les enregistrements conservés sont nécessaires, ne les supprimez pas au hasard pour faire disparaître l’erreur : demandez de l’aide en joignant le message.

Si seule la consultation échoue, vérifiez les droits et la version du service. Si les journaux d’une date ont été nettoyés pendant la consultation, sélectionnez de nouveau la date et les critères puis cliquez sur Rechercher. Si la recherche réussit mais reste vide, vérifiez la date UTC, les filtres et Enregistrements suivants.