Användarguide för mudfish-exclude

info

mudfish-exclude stöds från Mudfish Cloud VPN v6.5.4.

mudfish-exclude startar ett angivet program utanför Mudfishs routningspolicy i Linux.

Använd det när Mudfish ska fortsätta köras, men vissa program, exempelvis en webbläsare, meddelandeapp, spellauncher eller uppdaterare, ska använda den vanliga internetvägen.

Systemkrav

mudfish-exclude finns endast för Linux.

Systemet behöver:

• Mudfish för Linux.
• sudo- eller root-behörighet.
• cgroup v2 monterat på /sys/fs/cgroup.
• Kommandot ip.
• iptables.
• En IPv4-standardrutt.

Verktyget arbetar med IPv4-trafik. IPv6-trafik leds inte förbi Mudfish med mudfish-exclude.

Grundläggande användning

Sätt mudfish-exclude framför programmet:

sudo mudfish-exclude firefox

Programmets argument anges som vanligt efter programnamnet:

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

Om det finns många argument eller du vill göra avgränsningen tydlig anger du programmet efter --:

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

Även när verktyget startas med sudo körs själva programmet normalt med den aktuella användarens behörighet. Grafiska program kan därför använda din vanliga hemkatalog, skrivbordssession och inställningsfiler i stället för roots inställningar.

Under körning

När kommandot startar skapar mudfish-exclude en tillfällig nätverkspolicy som gäller just det kommandot. Trafiken märks och skickas via systemets vanliga IPv4-standardrutt.

När kommandot avslutas väntar verktyget tills den tillhörande processgruppen är tom och tar sedan bort de tillfälliga reglerna.

Mudfish stängs inte av. Andra program fortsätter att följa de befintliga Mudfish-inställningarna.

Exempel

Starta Firefox utanför Mudfish:

sudo mudfish-exclude firefox

Starta Discord utanför Mudfish:

sudo mudfish-exclude discord

Starta Steam utanför Mudfish:

sudo mudfish-exclude steam

Hämta en fil från kommandoraden utanför Mudfish:

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

Manuell konfigurering och städning

Normalt behövs detta inte. mudfish-exclude konfigurerar och tar bort policyn automatiskt.

Om du vill skapa en policy en gång och använda den för flera program gör du så här:

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

Kör alltid --cleanup efter att ha använt manuell konfigurering.

Avancerade alternativ

De flesta användare kan behålla standardvärdena.

Alternativ	Syfte	Standard
--cgroup NAME	cgroup v2-namn för undantagna program	mudfish-exclude
--mark VALUE	Brandväggsmarkering	0x6d660001
--priority VALUE	Prioritet för IPv4-regeln	8252
--table VALUE	Nummer för IPv4-routningstabellen	8252
--setup	Skapa policyn och avsluta	Avstängt
--cleanup	Ta bort policyn och avsluta	Avstängt
--no-setup	Kör kommandot med den befintliga policyn	Avstängt

Ändra markering, prioritet och tabell endast om standardvärdena kolliderar med andra nätverksverktyg eller om Mudfishs support ber dig göra det.

Exempel:

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

Att tänka på för grafiska program

Vissa skrivbordsprogram återanvänder en redan startad process. Om webbläsaren redan är öppen kan sudo mudfish-exclude firefox exempelvis bara be den befintliga processen att öppna ett nytt fönster. Den befintliga processen kanske då inte omfattas av undantaget.

Rekommenderat tillvägagångssätt:

• Avsluta programmet helt och starta det igen med mudfish-exclude.
• Använd separata webbläsarprofiler om du behöver använda både Mudfish-rutten och den undantagna rutten samtidigt.
• Kör det faktiska programkommandot, inte bara en skrivbordsgenväg.

Felsökning

network policy setup requires root

Kör med sudo:

sudo mudfish-exclude firefox

cgroup v2 is required at /sys/fs/cgroup

Linux-systemet använder inte cgroup v2 på den förväntade platsen. Ändra systeminställningarna för att använda cgroup v2 eller använd en distribution som har det som standard.

failed to find the IPv4 default route

Systemet saknar en användbar IPv4-standardrutt. Kontrollera först att den vanliga internetanslutningen fungerar.

Programmet verkar fortfarande använda Mudfish

Avsluta programmet helt och starta det igen via mudfish-exclude. Det är särskilt viktigt för webbläsare, spellaunchers och meddelandeappar som behåller bakgrundsprocesser.

Nätverksregler finns kvar efter en onormal avslutning

Städa manuellt:

sudo mudfish-exclude --cleanup

Om du har ändrat --mark, --priority, --table eller --cgroup måste samma värden anges med --cleanup.

Snabb kommandoreferens

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