Установка и обновление Muddog

Поддерживаемые системы

Проверьте операционную систему и версию на странице загрузки, затем скачайте установочный файл.

Операционная система	Формат и инструкции
Linux x86_64	Пакеты .deb и .rpm. Требуется среда рабочего стола с systemd.
Windows 10/11 x64	Установочный файл .msi. Текущий пакет для Windows поддерживает только x64.
macOS 13 Ventura и новее	Установочный файл .dmg. Пакет Universal поддерживает Intel и Apple Silicon. Для управления приложением нужна учётная запись администратора macOS.

В Linux менеджер пакетов устанавливает необходимые для приложения библиотеки и зависимости. Для VPN для приложений в Linux также требуются пользовательский сеанс systemd и cgroup v2. Пакет nftables включён в зависимости. Windows также поддерживает VPN для приложений, а macOS — VPN для всего интернета и отдельных IP-адресов и подсетей.

Это руководство относится к версии 2.x. Если на странице загрузки ещё нет файла 2.x для вашей операционной системы, сначала проверьте, выпущен ли он. Для файла .exe версии 1.0.7 для Windows следуйте руководству по предыдущей версии.

При запуске службы включается и общий доступ

В Linux и Windows общий доступ к интернету включается автоматически после установки, а в macOS — после первого запуска и разрешения на работу фоновой службы. Затем служба запускается и при загрузке системы, поэтому другие пользователи могут использовать ваше интернет-соединение, даже если окно приложения не открыто. Перед установкой прочитайте раздел Управление общим доступом к интернету.

Установка в Linux

В командах ниже приведены примеры имён файлов версии 2.0.0. В терминале перейдите в каталог со скачанным файлом и замените имя файла на имя скачанного пакета. Для установки нужны права администратора.

Debian / Ubuntu

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora

sudo dnf install ./muddog-2.0.0-1.x86_64.rpm

Первый запуск после установки

1. После установки выйдите из сеанса рабочего стола и войдите снова.
2. Запустите Muddog из меню приложений.
3. Убедитесь, что на экране Подключение отображается состояние VPN и раздела Общий доступ к моему интернету.
4. Выберите страну и подключитесь по инструкции Подключение к VPN.

При установке через sudo из обычной учётной записи пользователь добавляется в группу muddog. Чтобы приложение получило эти права, нужно войти в сеанс заново. Запускайте приложение от обычного пользователя. Для использования VPN не нужно вводить ID Mudfish или пароль.

Если администратор установил программу из другой учётной записи или управлять приложением должны несколько пользователей, см. Проверка доступа к службе.

Установка в Windows

1. Если Muddog уже установлен с помощью прежнего установщика .exe, сначала удалите его через Параметры → Приложения в Windows. Если установщик просит удалить прежнюю версию, завершите удаление, затем повторите установку MSI.
2. Запустите скачанный файл .msi и подтвердите запрос прав администратора.
3. Следуйте инструкциям установщика. Если WebView2 Runtime отсутствует, помощник установки скачает его из интернета, поэтому потребуется подключение к интернету.
4. Запустите muddog из меню «Пуск» или с рабочего стола с правами обычного пользователя.
5. Проверьте состояние службы на экране Подключение и следуйте инструкции Подключение к VPN.

По умолчанию программа устанавливается в %ProgramFiles%\muddog. Установщик регистрирует и автоматически запускает службу muddog-engine, а также добавляет необходимое движку правило брандмауэра для входящего UDP-трафика. Компоненты для VPN и VPN для приложений входят в пакет. Запускать приложение с правами администратора при каждом использовании не требуется.

Установка в macOS

1. Откройте скачанный файл .dmg.
2. Скопируйте Muddog.app в папку «Программы» (/Applications). При запуске прямо из DMG зарегистрировать фоновую службу невозможно.
3. Запустите скопированное приложение Muddog, войдя в macOS под учётной записью администратора.
4. Разрешите фоновую работу Muddog в разделе Системные настройки → Основные → Объекты входа и расширения. Названия пунктов могут различаться в зависимости от версии macOS.
5. Когда приложение снова подключится к службе, следуйте инструкции Подключение к VPN.

Чтобы снова открыть экран разрешений, выберите в строке меню macOS Service → Background Service Settings…. Если нужно зарегистрировать службу, выберите Service → Enable Background Service. Эти пункты меню отображаются на английском языке. Само приложение запускайте без sudo.

Обновление

Если VPN используется, нажмите Отключиться и скачайте новый установочный файл для своей операционной системы со страницы загрузки.

• Linux: закройте приложение и установите пакет указанной выше командой, подставив имя нового файла .deb или .rpm.
• Windows: закройте приложение и запустите новый файл .msi. При обновлении прежняя версия, установленная через MSI, будет заменена.
• macOS: сначала выберите Service → Remove Background Service and Quit, чтобы удалить службу и закрыть приложение. Замените приложение в /Applications на Muddog.app из нового DMG, затем запустите его снова и предоставьте необходимые разрешения для службы.

При обновлении текущие VPN-соединения и соединения общего доступа разрываются. После обновления откройте приложение заново и проверьте состояние подключения и общего доступа. Если появляется ошибка о несовпадении версий приложения и службы, см. Устранение неполадок.

При переходе с предыдущей версии 1.0.7 для Linux закройте старое приложение и установите новый пакет. Если зарегистрирована прежняя служба muddog_srv.service, установщик остановит её и отключит автоматический запуск. После этого запускайте Muddog из меню приложений.

Удаление

Linux

В Debian / Ubuntu используйте команду:

sudo apt remove muddog

В Fedora используйте команду:

sudo dnf remove muddog

При удалении пакета служба и VPN завершают работу, а добавленные Muddog сетевые маршруты удаляются. В Debian / Ubuntu для удаления также выделенной учётной записи службы и группы можно использовать sudo apt purge muddog вместо обычного удаления.

Windows

В разделе Параметры → Приложения в Windows выберите muddog и удалите его. При удалении служба и VPN завершают работу, маршруты VPN удаляются, затем удаляются служба и добавленное при установке правило брандмауэра. Пользовательские настройки и журнал подключений и передачи трафика сохраняются.

macOS

1. В приложении выберите Service → Remove Background Service and Quit.
2. Дождитесь удаления службы и закрытия приложения, затем переместите Muddog.app из /Applications в Корзину.

Если сначала удалить только файл приложения, удаление фоновых объектов может задержаться. Пользовательские настройки и журнал подключений и передачи трафика сохраняются.

Оставшиеся записи и остановка общего доступа

Удаление пакета и удаление журнала подключений и передачи трафика — отдельные действия. Расположение оставшихся локальных записей и правила их хранения описаны в разделе Журнал подключений и передачи трафика. Чтобы сохранить программу, но прекратить общий доступ, можно остановить службу. Пока служба остановлена, ваш собственный VPN также недоступен.