Устранение неполадок Muddog

Сначала на экране Подключение определите, где возникла проблема: в разделе Подключение к VPN или Общий доступ к моему интернету. Причина отображается в соответствующем разделе Сведения о подключении либо в пункте Подробности ошибки в уведомлении об ошибке.

Симптом	Что проверить
Не удаётся подключиться к службе	Состояние службы и права доступа
Список стран пуст или подключение не удаётся	Страны и подключение к участнику
Состояние «Подключено», но IP не изменился или доступа нет	Область действия VPN и трафик
Кнопка запуска приложения недоступна или VPN не применяется к отдельному приложению	VPN для приложений
Ошибка о том, что служба не поддерживает функцию	Версии приложения и службы
Не работает только общий доступ к моему интернету	Общий доступ и хранение журнала

Не удаётся подключиться к службе

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

Когда служба восстановит работу, приложение автоматически подключится к ней. Ниже проверьте состояние и права доступа для своей операционной системы. При запуске службы включается и общий доступ к интернету.

Linux

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

2. Проверьте состояние службы в терминале.

   systemctl status muddog-engine.service --no-pager

3. Если служба остановлена и вы хотите снова использовать VPN и общий доступ, запустите её. Вместе со службой возобновится и общий доступ к интернету.

   sudo systemctl start muddog-engine.service

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

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

sudo usermod -aG muddog "$(id -un)"

Не заменяйте эту настройку запуском приложения с правами администратора. Если сама служба не запускается, последние ошибки можно посмотреть командой:

sudo journalctl -u muddog-engine.service -n 100 --no-pager

Windows

Проверьте состояние службы в PowerShell.

Get-Service -Name muddog-engine

Если служба остановлена, запустите её в PowerShell от имени администратора.

Start-Service -Name muddog-engine

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

macOS

1. Убедитесь, что установлена macOS 13 или новее и Muddog.app скопирован в /Applications.
2. Проверьте, что текущая учётная запись имеет права администратора macOS.
3. Запросите регистрацию службы через Service → Enable Background Service.
4. Разрешите фоновую работу Muddog через Service → Background Service Settings…. После предоставления разрешения дождитесь, пока приложение снова подключится к службе.

Состояние зарегистрированной службы можно также проверить в терминале.

sudo launchctl print system/net.3rocks.muddog.engine

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

Если после этих действий проблема сохраняется, добавьте сведения об ошибке службы в сообщение о проблеме.

Список стран пуст или подключение не удаётся

1. Проверьте, работает ли обычный доступ к интернету.
2. Нажмите Страна подключения → Обновить список.
3. Если выбранная страна исчезла из списка, используйте Автоматический выбор или подключитесь через другую страну.
4. Если вы меняли сервер подключения, восстановите значения по умолчанию в дополнительных настройках и сохраните их.
5. Если подключение по-прежнему не удаётся, проверьте Сведения о подключении.

P2P-подключение зависит от участников в выбранной стране и состояния сети с обеих сторон. Наличие страны в списке не гарантирует подключение. Если доступного участника нет, повторите попытку позже или выберите другую страну. Чтобы проверить, связана ли проблема с ограничениями брандмауэра или маршрутизатора, можно сравнить работу через другое доступное интернет-соединение.

10 попыток — это верхний предел числа попыток подключения. Если найти участника не удаётся, процесс может завершиться раньше. После обрыва уже установленного VPN нужно подключиться заново вручную.

Состояние «Подключено», но IP не изменился или доступа нет

1. Убедитесь, что в разделе Подключение → Область действия текущего подключения указан нужный режим. Если настройки только сохранены, но переподключение не выполнено, продолжает действовать прежняя область.
2. В режиме IP-адресов и подсетей проверьте, включён ли нужный IP назначения в список или исключён из него. Доменные имена в список адресов добавить нельзя.
3. В режиме для приложений полностью закройте приложение и запустите его снова из Muddog.
4. Проверьте, не используется ли IPv6 для проверяемого подключения. IPv6 не проходит через VPN; в Windows режим для приложений блокирует IPv6-трафик выбранных приложений.
5. Если одновременно используются другой VPN или средства управления сетью, сравните работу при отключённом другом соединении. Маршруты, заданные другой программой, могут иметь приоритет.

Если браузер или страница проверки IP не входят в область действия VPN, отображение IP обычного соединения нормально. DNS также может использовать обычное соединение в зависимости от режима и IP-адреса DNS-сервера.

Если ограничение по стране на определённом сайте сохраняется, проверьте другую страну или другого участника соединения. Muddog не гарантирует разрешение доступа со стороны этого сервиса или определённую скорость.

Если в macOS вы сменили используемое соединение, например Wi-Fi, отключите VPN и подключитесь снова. Если в режиме включения IP-адресов возникает ошибка конфликта с маршрутом к хосту, заданным другой программой, проверьте соединение этой программы и указанные IP-адреса и подсети.

VPN для приложений не применяется

• В macOS VPN для приложений не поддерживается. Используйте режим всего интернета или IP-адресов и подсетей.
• Если кнопка Запустить через VPN недоступна, проверьте, сохранён ли режим для приложений, подключён ли VPN именно в этом режиме и выбрано ли приложение для запуска.
• Если список приложений пуст, используйте Обновить список или Найти исполняемый файл.
• Если браузер лишь открывает существующее окно, завершите также его фоновые процессы и запустите заново.
• Приложения, передающие запуск отдельной службе или использующие уже работающий экземпляр, не поддерживаются. Проверьте способ установки и условия использования VPN для приложений.
• В Linux приложения Snap и Flatpak не поддерживаются. При ошибках, связанных с пользовательским сеансом systemd, cgroup v2 или nftables, проверьте соответствующие компоненты и добавьте Подробности ошибки в сообщение о проблеме.
• В Windows нужно выбрать файл .exe для запуска. После переподключения VPN полностью закройте программу и запустите её заново из Muddog.
• Если в Windows возникает ошибка об отсутствии компонентов WinDivert или невозможности их загрузить, выполните восстановление или переустановку через MSI. Если ошибка сохраняется, отправьте Подробности ошибки.

Версии приложения и службы различаются

При подключении к старой службе, не поддерживающей запрошенную приложением функцию, возникает ошибка. Обновите приложение и службу вместе, установив новый пакет. Отсутствие VPN для приложений в macOS связано с набором поддерживаемых функций, а не с ошибкой версии.

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

В Linux закройте приложение, выполните следующую команду и снова откройте приложение.

sudo systemctl restart muddog-engine.service

В Windows закройте приложение, выполните следующую команду в PowerShell от имени администратора и снова откройте приложение.

Restart-Service -Name muddog-engine

В macOS выберите Service → Remove Background Service and Quit, затем запустите Muddog из /Applications и предоставьте необходимые разрешения для службы.

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

Не работает только общий доступ или не удаётся прочитать журнал

Сначала проверьте Общий доступ к моему интернету → Сведения о подключении. При нехватке места для журнала, превышении лимита хранения или ошибке записи файлов общий доступ прекращается. Записи сохраняются по правилам локального хранения.

Проверьте свободное место на диске и журнал службы. Если хранящиеся записи нужны, не удаляйте их без разбора ради устранения ошибки; обратитесь в поддержку и приложите сообщение об ошибке.

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