Lewati ke konten utama

Panduan pengguna mudfish-exclude

info

mudfish-exclude didukung mulai Mudfish Cloud VPN v6.5.4 atau lebih baru.

mudfish-exclude adalah alat Linux untuk menjalankan program tertentu di luar kebijakan routing Mudfish.

Gunakan ketika ingin Mudfish tetap berjalan, tetapi program tertentu seperti browser, aplikasi pesan, launcher gim, atau pembaru menggunakan rute internet biasa.

Lingkungan yang didukung​

mudfish-exclude hanya tersedia untuk Linux.

Sistem memerlukan:

  • Mudfish untuk Linux
  • sudo atau hak root
  • cgroup v2 terpasang pada /sys/fs/cgroup
  • Perintah ip
  • iptables
  • Rute default IPv4

Alat ini menangani lalu lintas IPv4. Lalu lintas IPv6 tidak dialihkan oleh mudfish-exclude.

Penggunaan dasar​

Awali perintah program dengan mudfish-exclude.

sudo mudfish-exclude firefox

Tambahkan argumen program setelah nama program seperti biasa.

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

Jika argumen banyak atau ingin memperjelas pemisahnya, tulis program setelah --.

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

Meskipun diluncurkan melalui sudo, program yang dijalankan biasanya kembali ke hak pengguna saat ini. Dengan demikian, program GUI dapat menggunakan direktori home, sesi desktop, dan berkas pengaturan yang biasa dipakai, bukan pengaturan root.

Perilaku saat berjalan​

Saat perintah dimulai, mudfish-exclude membuat kebijakan jaringan sementara yang hanya berlaku pada perintah tersebut. Lalu lintasnya diberi mark dan keluar melalui rute default IPv4 biasa pada sistem.

Setelah perintah berakhir, alat menunggu kelompok proses terkait kosong, lalu menghapus aturan sementara.

Mudfish sendiri tidak dimatikan. Program lain tetap mengikuti pengaturan Mudfish yang ada.

Contoh penggunaan​

Menjalankan Firefox di luar Mudfish:

sudo mudfish-exclude firefox

Menjalankan Discord di luar Mudfish:

sudo mudfish-exclude discord

Menjalankan Steam di luar Mudfish:

sudo mudfish-exclude steam

Menjalankan unduhan baris perintah di luar Mudfish:

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

Pengaturan dan pembersihan manual​

Tidak diperlukan dalam penggunaan biasa. mudfish-exclude mengatur dan membersihkan kebijakan secara otomatis.

Jika perlu membuat kebijakan sekali lalu menjalankan beberapa program dengan kebijakan yang sama, gunakan:

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

Setelah menggunakan mode pengaturan manual, pastikan menjalankan --cleanup.

Opsi lanjutan​

Sebagian besar pengguna dapat menggunakan nilai default.

OpsiKegunaanDefault
--cgroup NAMENama cgroup v2 untuk program yang dikecualikanmudfish-exclude
--mark VALUENilai mark firewall0x6d660001
--priority VALUEPrioritas aturan IPv48252
--table VALUENomor tabel routing IPv48252
--setupMembuat kebijakan lalu keluarNonaktif
--cleanupMenghapus kebijakan lalu keluarNonaktif
--no-setupMenjalankan perintah dalam kebijakan yang sudah dibuatNonaktif

Ubah mark, prioritas, atau tabel default hanya jika bertabrakan dengan alat jaringan lain atau atas petunjuk tim dukungan Mudfish.

Contoh:

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

Hal yang perlu diperhatikan untuk program GUI​

Sebagian program desktop memakai ulang proses yang sudah berjalan. Misalnya, jika browser sudah terbuka, sudo mudfish-exclude firefox mungkin hanya meminta browser lama membuka jendela baru. Dalam keadaan ini, proses browser lama mungkin tidak dikecualikan.

Cara yang disarankan:

  • Tutup program sepenuhnya lalu jalankan kembali melalui mudfish-exclude.
  • Gunakan profil terpisah jika browser harus memakai rute Mudfish dan rute pengecualian secara bersamaan.
  • Jalankan perintah program sebenarnya, bukan hanya pintasan desktop.

Pemecahan masalah​

network policy setup requires root​

Jalankan dengan sudo.

sudo mudfish-exclude firefox

cgroup v2 is required at /sys/fs/cgroup​

Sistem Linux tidak menggunakan cgroup v2 pada lokasi yang diharapkan. Ubah pengaturan sistem agar memakai cgroup v2 atau gunakan distribusi Linux yang menyediakannya secara default.

failed to find the IPv4 default route​

Tidak ada rute default IPv4 yang dapat digunakan. Pastikan koneksi internet biasa berfungsi terlebih dahulu.

Aplikasi masih terlihat menggunakan Mudfish​

Tutup aplikasi sepenuhnya lalu jalankan kembali melalui mudfish-exclude. Ini terutama penting untuk browser, launcher gim, atau aplikasi pesan yang mempertahankan proses latar belakang.

Aturan jaringan tertinggal setelah penghentian tidak normal​

Bersihkan secara manual.

sudo mudfish-exclude --cleanup

Jika menggunakan nilai kustom --mark, --priority, --table, atau --cgroup, tentukan nilai yang sama pada --cleanup.

Ringkasan perintah cepat​

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