Посібник користувача mudfish-exclude

Інформація

mudfish-exclude підтримується з Mudfish Cloud VPN v6.5.4.

mudfish-exclude запускає вибрані програми в Linux поза політикою маршрутизації Mudfish.

Використовуйте його, коли Mudfish має залишатися активним, але браузер, месенджер, ігровий запускач або програма оновлення повинні користуватися звичайним інтернет-маршрутом.

Підтримуване середовище

mudfish-exclude призначений лише для Linux.

Потрібні:

• Mudfish для Linux.
• sudo або права root.
• cgroup v2, змонтована в /sys/fs/cgroup.
• Команда ip.
• iptables.
• Маршрут IPv4 за замовчуванням.

Інструмент обробляє IPv4-трафік. IPv6-трафік не обходить Mudfish через 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 програма зазвичай повертається до прав поточного користувача. Тому GUI-програма може використовувати звичний домашній каталог, сеанс робочого столу й конфігураційні файли, а не налаштування 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

Ручне налаштування та очищення

Зазвичай це не потрібно: mudfish-exclude автоматично створює й видаляє політику.

Якщо потрібно створити одну політику для кількох програм, використовуйте:

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	Позначка брандмауера	0x6d660001
--priority VALUE	Пріоритет правила IPv4	8252
--table VALUE	Номер таблиці маршрутизації IPv4	8252
--setup	Створити політику й завершитися	Вимкнено
--cleanup	Видалити політику й завершитися	Вимкнено
--no-setup	Увійти до наявної політики та виконати команду	Вимкнено

Змінюйте стандартні позначку, пріоритет і таблицю лише за конфлікту з іншими мережевими інструментами або за вказівкою підтримки Mudfish.

Приклад:

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

Зауваження щодо GUI-програм

Деякі настільні програми повторно використовують уже запущений процес. Наприклад, якщо браузер відкритий, 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 в очікуваному місці. Увімкніть її в системі або використайте дистрибутив, де вона доступна за замовчуванням.

failed to find the IPv4 default route

У системі немає доступного IPv4-маршруту за замовчуванням. Спершу перевірте звичайний доступ до інтернету.

Застосунок, здається, усе ще використовує Mudfish

Повністю закрийте його й запустіть знову через mudfish-exclude. Це особливо важливо для браузерів, ігрових запускачів і месенджерів, які залишають фонові процеси.

Після аварійного завершення залишилися мережеві правила

Виконайте ручне очищення:

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