Guide de mudfish-exclude

info

mudfish-exclude est pris en charge à partir de Mudfish Cloud VPN v6.5.4.

mudfish-exclude lance un programme sous Linux en dehors de la politique de routage Mudfish.

Utilisez-le pour laisser Mudfish actif tout en faisant passer certains programmes, tels qu’un navigateur, une messagerie, un lanceur de jeu ou un programme de mise à jour, par la connexion Internet ordinaire.

Environnement pris en charge

mudfish-exclude est réservé à Linux. Le système doit disposer de :

• Mudfish pour Linux.
• Droits sudo ou root.
• cgroup v2 monté sur /sys/fs/cgroup.
• La commande ip.
• iptables.
• Une route IPv4 par défaut.

L’outil agit sur IPv4. Il ne fait pas contourner Mudfish au trafic IPv6.

Utilisation de base

Placez mudfish-exclude devant le programme :

sudo mudfish-exclude firefox

Ajoutez normalement les arguments après le nom du programme.

sudo mudfish-exclude firefox --private-window
sudo mudfish-exclude curl https://mudfish.net

Pour séparer explicitement les arguments, notamment s’ils sont nombreux, placez le programme après --.

sudo mudfish-exclude -- firefox --private-window

Même avec sudo, le programme lancé retrouve généralement les droits de l’utilisateur courant. Une application graphique utilise ainsi votre dossier personnel, votre session et vos fichiers de configuration habituels, plutôt que ceux de root.

Pendant l’exécution

Au démarrage, mudfish-exclude crée une politique réseau temporaire propre à la commande. Son trafic est marqué puis envoyé sur la route IPv4 par défaut ordinaire du système.

Lorsque la commande se termine, l’outil attend que le groupe de processus associé soit vide, puis supprime les règles temporaires.

Mudfish reste actif. Les autres programmes continuent à suivre leur configuration Mudfish habituelle.

Exemples

Lancer Firefox en dehors de Mudfish :

sudo mudfish-exclude firefox

Lancer Discord en dehors de Mudfish :

sudo mudfish-exclude discord

Lancer Steam en dehors de Mudfish :

sudo mudfish-exclude steam

Télécharger en ligne de commande en dehors de Mudfish :

sudo mudfish-exclude wget https://example.com/file.zip

Configuration et nettoyage manuels

Ils ne sont pas nécessaires dans l’usage habituel : mudfish-exclude configure et nettoie automatiquement la politique.

Pour créer une politique une seule fois puis l’utiliser avec plusieurs programmes :

sudo mudfish-exclude --setup
sudo mudfish-exclude --no-setup firefox
sudo mudfish-exclude --no-setup discord
sudo mudfish-exclude --cleanup

Après le mode de configuration manuel, exécutez impérativement --cleanup.

Options avancées

La plupart des utilisateurs peuvent conserver les valeurs par défaut.

Option	Fonction	Valeur par défaut
--cgroup NAME	Nom du cgroup v2 des programmes exclus	mudfish-exclude
--mark VALUE	Marque de pare-feu	0x6d660001
--priority VALUE	Priorité de la règle IPv4	8252
--table VALUE	Numéro de table de routage IPv4	8252
--setup	Créer la politique puis quitter	Désactivé
--cleanup	Supprimer la politique puis quitter	Désactivé
--no-setup	Entrer dans la politique existante et exécuter la commande	Désactivé

Ne changez la marque, la priorité et la table que si leurs valeurs entrent en conflit avec un autre outil réseau ou sur instruction de l’assistance Mudfish.

Exemple :

sudo mudfish-exclude --table 9000 --priority 9000 firefox

Précautions pour les applications graphiques

Certaines applications réutilisent un processus existant. Si Firefox est déjà ouvert, sudo mudfish-exclude firefox peut simplement lui demander une nouvelle fenêtre. Le processus existant peut alors ne pas être exclu.

Recommandations :

• Fermez complètement le programme avant de le relancer avec mudfish-exclude.
• Pour utiliser simultanément un chemin Mudfish et un chemin exclu dans un navigateur, utilisez des profils distincts.
• Exécutez la véritable commande du programme, plutôt qu’un simple raccourci du bureau.

Dépannage

network policy setup requires root

Ajoutez sudo :

sudo mudfish-exclude firefox

cgroup v2 is required at /sys/fs/cgroup

Le système Linux n’utilise pas cgroup v2 à l’emplacement attendu. Activez-le dans la configuration du système ou utilisez une distribution qui le fournit par défaut.

failed to find the IPv4 default route

Aucune route IPv4 par défaut utilisable n’est disponible. Vérifiez d’abord la connexion Internet ordinaire.

L’application semble toujours utiliser Mudfish

Fermez-la complètement et relancez-la avec mudfish-exclude. C’est particulièrement important pour les navigateurs, lanceurs de jeu et messageries qui conservent des processus en arrière-plan.

Des règles réseau subsistent après un arrêt anormal

Nettoyez-les manuellement :

sudo mudfish-exclude --cleanup

Si vous aviez modifié --mark, --priority, --table ou --cgroup, utilisez les mêmes valeurs avec --cleanup.

Récapitulatif des commandes

sudo mudfish-exclude COMMAND [ARGS...]
sudo mudfish-exclude --setup
sudo mudfish-exclude --no-setup COMMAND [ARGS...]
sudo mudfish-exclude --cleanup