رفتن به محتوای اصلی

راهنمای کاربر mudfish-exclude

اطلاعات

mudfish-exclude از Mudfish Cloud VPN v6.5.4 به بعد پشتیبانی می‌شود.

mudfish-exclude ابزاری برای اجرای برنامهٔ مشخص خارج از سیاست مسیریابی Mudfish در Linux است.

وقتی می‌خواهید Mudfish همچنان اجرا شود، اما برنامه‌هایی مانند مرورگر، پیام‌رسان، Launcher بازی یا به‌روزرسان از مسیر عادی اینترنت استفاده کنند، از آن استفاده کنید.

محیط پشتیبانی‌شده​

mudfish-exclude فقط برای Linux است.

موارد زیر در سیستم لازم‌اند:

  • Mudfish برای Linux
  • دسترسی sudo یا root
  • cgroup v2 متصل‌شده در /sys/fs/cgroup
  • فرمان ip
  • iptables
  • مسیر پیش‌فرض IPv4

این ابزار روی ترافیک IPv4 کار می‌کند. ترافیک IPv6 با mudfish-exclude از مسیر مستثنا نمی‌شود.

استفادهٔ پایه​

پیش از نام برنامه، mudfish-exclude را قرار دهید.

sudo mudfish-exclude firefox

آرگومان‌های برنامه را پس از نام آن بنویسید.

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

اگر آرگومان‌ها زیادند یا تفکیک صریح می‌خواهید، نام برنامه را پس از -- بگذارید.

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

حتی با اجرای sudo، برنامهٔ واقعی معمولاً با دسترسی کاربر فعلی اجرا می‌شود. بنابراین برنامهٔ گرافیکی می‌تواند به‌جای تنظیمات root، از پوشهٔ خانه، نشست دسکتاپ و فایل‌های تنظیمات عادی شما استفاده کند.

رفتار هنگام اجرا​

با شروع فرمان، mudfish-exclude سیاست شبکهٔ موقتی مخصوص همان فرمان می‌سازد. ترافیک آن علامت‌گذاری می‌شود و از مسیر پیش‌فرض عادی IPv4 سیستم خارج می‌شود.

پس از پایان فرمان، ابزار تا خالی شدن گروه فرایندهای مرتبط صبر می‌کند و سپس قواعد موقت را حذف می‌کند.

خود Mudfish خاموش نمی‌شود. سایر برنامه‌ها طبق تنظیمات قبلی Mudfish کار می‌کنند.

نمونه‌ها​

اجرای Firefox خارج از Mudfish:

sudo mudfish-exclude firefox

اجرای Discord خارج از Mudfish:

sudo mudfish-exclude discord

اجرای Steam خارج از Mudfish:

sudo mudfish-exclude steam

دانلود خط فرمان خارج از Mudfish:

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

تنظیم و پاک‌سازی دستی​

در استفادهٔ عادی لازم نیست؛ ابزار سیاست را خودکار تنظیم و پاک می‌کند.

اگر باید یک سیاست بسازید و چند برنامه را با آن اجرا کنید، به‌شکل زیر عمل کنید.

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

پس از استفاده از حالت دستی، حتماً --cleanup را اجرا کنید.

گزینه‌های پیشرفته​

بیشتر کاربران می‌توانند مقادیر پیش‌فرض را نگه دارند.

گزینهکاربردپیش‌فرض
--cgroup NAMEنام cgroup v2 برنامهٔ مستثناشدهmudfish-exclude
--mark VALUEمقدار mark فایروال0x6d660001
--priority VALUEاولویت قاعدهٔ IPv48252
--table VALUEشمارهٔ جدول مسیریابی IPv48252
--setupساخت سیاست و خروجخاموش
--cleanupحذف سیاست و خروجخاموش
--no-setupورود به سیاست موجود و اجرای فرمانخاموش

فقط اگر mark، اولویت یا جدول پیش‌فرض با ابزار شبکهٔ دیگری تداخل دارد یا پشتیبانی Mudfish توصیه کرده است، آن‌ها را تغییر دهید.

نمونه:

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

نکات برنامه‌های گرافیکی​

برخی برنامه‌های دسکتاپ فرایند موجود را دوباره استفاده می‌کنند. برای نمونه، اگر مرورگر باز باشد، اجرای sudo mudfish-exclude firefox ممکن است فقط درخواست پنجرهٔ جدید را به مرورگر قبلی بدهد. در این حالت، فرایند قبلی ممکن است مستثنا نشود.

روش پیشنهادی:

  • برنامه را کاملاً ببندید و با mudfish-exclude دوباره اجرا کنید.
  • اگر در مرورگر هم‌زمان به مسیر Mudfish و مسیر استثنا نیاز دارید، از نمایه‌های جداگانه استفاده کنید.
  • فرمان واقعی برنامه را اجرا کنید، نه فقط میان‌بر دسکتاپ را.

رفع مشکل​

network policy setup requires root​

فرمان را با sudo اجرا کنید.

sudo mudfish-exclude firefox

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

سیستم Linux از cgroup v2 در محل مورد انتظار استفاده نمی‌کند. تنظیمات سیستم را تغییر دهید یا از توزیعی استفاده کنید که cgroup v2 را به‌طور پیش‌فرض دارد.

failed to find the IPv4 default route​

مسیر پیش‌فرض IPv4 قابل استفاده در سیستم وجود ندارد. ابتدا سلامت اتصال عادی اینترنت را بررسی کنید.

برنامه ظاهراً هنوز از Mudfish استفاده می‌کند​

برنامه را کاملاً ببندید و از طریق mudfish-exclude دوباره اجرا کنید. این نکته برای مرورگر، Launcher بازی و پیام‌رسان‌هایی که فرایند پس‌زمینه نگه می‌دارند، اهمیت بیشتری دارد.

پس از خروج غیرعادی، قواعد شبکه باقی مانده‌اند​

دستی پاک‌سازی کنید.

sudo mudfish-exclude --cleanup

اگر --mark، --priority، --table یا --cgroup را تغییر داده‌اید، در --cleanup نیز همان مقادیر را وارد کنید.

خلاصهٔ سریع فرمان‌ها​

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