Gebruikershandleiding voor mudfish-exclude

info

mudfish-exclude wordt ondersteund vanaf Mudfish Cloud VPN v6.5.4.

mudfish-exclude start een opgegeven programma op Linux buiten het routeringsbeleid van Mudfish.

Gebruik het als Mudfish actief moet blijven, maar bepaalde programma's, zoals browsers, chatprogramma's, gamelaunchers of updaters, de gewone internetroute moeten gebruiken.

Ondersteunde omgeving

mudfish-exclude is alleen voor Linux.

Het systeem moet beschikken over:

• Mudfish voor Linux.
• sudo- of root-rechten.
• cgroup v2, gekoppeld op /sys/fs/cgroup.
• Het commando ip.
• iptables.
• Een IPv4-standaardroute.

Het hulpmiddel werkt op IPv4-verkeer. IPv6-verkeer wordt niet door mudfish-exclude omgeleid.

Basisgebruik

Zet mudfish-exclude vóór het programma:

sudo mudfish-exclude firefox

Voeg programmaargumenten gewoon achter de programmanaam toe:

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

Bij veel argumenten of voor een duidelijke scheiding kun je het programma achter -- zetten:

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

Ook bij gebruik van sudo wordt het eigenlijke programma meestal teruggezet naar de rechten van de huidige gebruiker. GUI-programma's gebruiken daardoor je normale thuismap, bureaubladsessie en configuratiebestanden in plaats van die van root.

Gedrag tijdens het uitvoeren

Bij het starten maakt mudfish-exclude tijdelijk netwerkbeleid voor dat commando. Het verkeer wordt gemarkeerd en verlaat het systeem via de gewone IPv4-standaardroute.

Na het stoppen wacht het hulpmiddel totdat de bijbehorende procesgroep leeg is en verwijdert het de tijdelijke regels.

Mudfish zelf wordt niet uitgeschakeld. Andere programma's blijven de bestaande Mudfish-instellingen volgen.

Voorbeelden

Firefox buiten Mudfish starten:

sudo mudfish-exclude firefox

Discord buiten Mudfish starten:

sudo mudfish-exclude discord

Steam buiten Mudfish starten:

sudo mudfish-exclude steam

Een download via de opdrachtregel buiten Mudfish uitvoeren:

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

Handmatig instellen en opruimen

Bij normaal gebruik is dit niet nodig: mudfish-exclude stelt het beleid automatisch in en ruimt het op.

Wil je één beleid maken en voor meerdere programma's hergebruiken, doe dan het volgende:

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

Voer na handmatig instellen altijd --cleanup uit.

Geavanceerde opties

De meeste gebruikers kunnen de standaardwaarden behouden.

Optie	Doel	Standaard
--cgroup NAME	De naam van de cgroup v2 voor uitgesloten programma's	mudfish-exclude
--mark VALUE	De firewallmarkering	0x6d660001
--priority VALUE	De prioriteit van de IPv4-regel	8252
--table VALUE	Het nummer van de IPv4-routeringstabel	8252
--setup	Het beleid aanmaken en stoppen	Uit
--cleanup	Het beleid verwijderen en stoppen	Uit
--no-setup	Het commando met bestaand beleid uitvoeren	Uit

Wijzig de standaardmarkering, prioriteit of tabel alleen bij een conflict met andere netwerkhulpmiddelen of op advies van Mudfish-ondersteuning.

Voorbeeld:

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

Aandachtspunten voor GUI-programma's

Sommige bureaubladprogramma's hergebruiken een bestaand proces. Als de browser al openstaat, kan sudo mudfish-exclude firefox alleen een nieuw venster bij die browser aanvragen. Het bestaande browserproces valt dan mogelijk niet onder de uitsluiting.

Aanbevolen werkwijze:

• Sluit het programma volledig af en start het opnieuw met mudfish-exclude.
• Gebruik een apart browserprofiel als je tegelijk een Mudfish-route en een uitgesloten route nodig hebt.
• Voer het daadwerkelijke programmacommando uit, niet alleen een bureaubladsnelkoppeling.

Problemen oplossen

network policy setup requires root

Voeg sudo toe:

sudo mudfish-exclude firefox

cgroup v2 is required at /sys/fs/cgroup

Het Linux-systeem gebruikt cgroup v2 niet op de verwachte locatie. Schakel cgroup v2 in de systeeminstellingen in of gebruik een Linux-distributie die dit standaard ondersteunt.

failed to find the IPv4 default route

Er is geen bruikbare IPv4-standaardroute. Controleer eerst of je gewone internetverbinding werkt.

De app lijkt nog steeds Mudfish te gebruiken

Sluit de app volledig af en start deze opnieuw via mudfish-exclude. Dit is vooral belangrijk bij browsers, gamelaunchers en chatprogramma's die achtergrondprocessen actief houden.

Netwerkregels blijven achter na onverwacht afsluiten

Ruim handmatig op:

sudo mudfish-exclude --cleanup

Heb je zelf waarden voor --mark, --priority, --table of --cgroup ingesteld, geef dan bij --cleanup dezelfde waarden op.

Beknopt commando-overzicht

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