Installer et mettre à jour Muddog

Configuration requise

Vérifiez le système et la version sur la page de téléchargement, puis téléchargez l’installateur.

Système	Distribution et conditions
Linux x86_64	Paquets .deb et .rpm. Nécessite un environnement de bureau utilisant systemd.
Windows 10/11 x64	Installateur .msi. Le paquet Windows prend actuellement en charge x64 uniquement.
macOS 13 Ventura ou ultérieur	Installateur .dmg. Le paquet Universal prend en charge Intel et Apple Silicon. Un compte administrateur macOS est nécessaire pour contrôler l’application.

Le gestionnaire d’installation Linux installe les bibliothèques et dépendances nécessaires. Le VPN par application Linux nécessite aussi une session utilisateur systemd et cgroup v2 ; nftables figure parmi les dépendances du paquet. Windows prend également en charge le VPN par application. macOS propose le VPN pour tout Internet ou par IP/plage.

Ce guide concerne 2.x. Si aucun fichier 2.x n’apparaît encore pour votre système sur la page de téléchargement, vérifiez d’abord sa disponibilité. Pour l’installateur Windows 1.0.7 .exe, suivez le guide de l’ancienne version.

Le partage démarre avec le service

Sous Linux et Windows, le partage Internet commence automatiquement à la fin de l’installation ; sous macOS, après le premier lancement et l’autorisation du service en arrière-plan. Le service démarre ensuite au démarrage de l’ordinateur : d’autres utilisateurs peuvent employer votre connexion sans que la fenêtre soit ouverte. Consultez Gestion du partage Internet avant l’installation.

Installation sous Linux

Les commandes ci-dessous utilisent des noms de fichiers 2.0.0 à titre d’exemple. Ouvrez un terminal dans le dossier du téléchargement et remplacez le nom par celui du paquet réellement téléchargé. L’installation nécessite les droits administrateur.

Debian / Ubuntu

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora

sudo dnf install ./muddog-2.0.0-1.x86_64.rpm

Premier lancement après installation

1. Déconnectez puis reconnectez votre session de bureau après l’installation.
2. Lancez Muddog depuis le menu des applications.
3. Vérifiez que l’écran Connexion affiche l’état du VPN et de Mon partage Internet.
4. Choisissez un pays et connectez-vous selon Connecter le VPN.

Une installation avec sudo depuis un compte ordinaire ajoute cet utilisateur au groupe muddog. La reconnexion de session applique ces droits à l’application. Lancez l’application comme utilisateur ordinaire ; aucun identifiant ni mot de passe Mudfish n’est demandé pour le VPN.

Si un administrateur a installé depuis un autre compte, ou si plusieurs utilisateurs doivent contrôler l’application, consultez Droits d’accès au service.

Installation sous Windows

1. Si Muddog a été installé avec l’ancien .exe, désinstallez-le d’abord dans Paramètres → Applications de Windows. Si l’installateur demande de retirer l’ancienne version, faites-le puis relancez le MSI.
2. Exécutez le .msi téléchargé et acceptez la demande de droits administrateur.
3. Suivez l’assistant. Si WebView2 Runtime manque, l’assistant le télécharge ; une connexion Internet est donc nécessaire.
4. Lancez muddog depuis le menu Démarrer ou le bureau avec vos droits ordinaires.
5. Vérifiez l’état du service sur l’écran Connexion, puis suivez Connecter le VPN.

Le dossier par défaut est %ProgramFiles%\muddog. L’installateur enregistre et démarre automatiquement le service muddog-engine, et ajoute les règles de pare-feu UDP entrant nécessaires au moteur. Le paquet contient les composants du VPN et du VPN par application. Il n’est pas nécessaire de lancer l’application en tant qu’administrateur à chaque utilisation.

Installation sous macOS

1. Ouvrez le .dmg téléchargé.
2. Copiez Muddog.app dans Applications (/Applications). Le service en arrière-plan ne peut pas être enregistré depuis le DMG.
3. Depuis un compte administrateur macOS, lancez la copie de Muddog.
4. Autorisez son exécution en arrière-plan dans Réglages système → Général → Ouverture et extensions. Les noms peuvent varier selon macOS.
5. Lorsque l’application se reconnecte au service, suivez Connecter le VPN.

Pour rouvrir l’écran d’autorisation, choisissez Service → Background Service Settings… dans la barre de menus macOS. Pour enregistrer le service, choisissez Service → Enable Background Service. Ces menus sont affichés en anglais. Lancez l’application sans sudo.

Mise à jour

Si le VPN est actif, cliquez sur Déconnecter, puis téléchargez le nouvel installateur adapté à votre système.

• Linux : fermez l’application et utilisez les commandes précédentes avec le nouveau .deb ou .rpm.
• Windows : fermez l’application et exécutez le nouveau .msi. L’ancienne installation MSI est remplacée pendant la mise à jour.
• macOS : choisissez d’abord Service → Remove Background Service and Quit pour retirer le service et quitter. Remplacez l’application dans /Applications par Muddog.app du nouveau DMG, relancez-la et accordez les autorisations nécessaires.

La mise à jour coupe les connexions VPN et de partage en cours. Rouvrez ensuite l’application et vérifiez leurs états. Si une erreur signale des versions différentes de l’application et du service, consultez Dépannage.

Pour remplacer Linux 1.0.7, fermez l’ancienne application et installez le nouveau paquet. L’installateur arrête et désactive le démarrage automatique de muddog_srv.service s’il est enregistré. Utilisez ensuite Muddog dans le menu des applications.

Désinstallation

Linux

Sous Debian / Ubuntu :

sudo apt remove muddog

Sous Fedora :

sudo dnf remove muddog

La suppression du paquet arrête le service et le VPN, puis nettoie les routes ajoutées par Muddog. Sous Debian / Ubuntu, utilisez sudo apt purge muddog à la place pour supprimer aussi le compte et le groupe de service dédiés.

Windows

Sélectionnez muddog dans Paramètres → Applications et désinstallez-le. La procédure arrête le service et le VPN, nettoie les routes VPN, puis supprime le service et les règles de pare-feu ajoutées à l’installation. Les paramètres utilisateur et les journaux de connexion/relais sont conservés.

macOS

1. Choisissez Service → Remove Background Service and Quit.
2. Une fois le service retiré et l’application fermée, placez Muddog.app de /Applications dans la corbeille.

Supprimer d’abord l’application peut retarder le nettoyage des éléments en arrière-plan. Les paramètres utilisateur et les journaux sont conservés.

Journaux restants et arrêt du partage

La désinstallation et la suppression des journaux sont deux opérations distinctes. Consultez Journaux de connexion et de relais pour leur emplacement et leur conservation. Pour garder le programme tout en arrêtant le partage, vous pouvez arrêter le service, mais votre VPN sera également indisponible tant qu’il est arrêté.