Rozwiązywanie problemów Muddog

Najpierw na ekranie Połączenie ustal, czy problem dotyczy połączenia VPN, czy udostępniania mojego Internetu. Przyczyna jest pokazana w odpowiednich Szczegółach połączenia lub Szczegółach błędu w powiadomieniu.

Objaw	Co sprawdzić
Nie można połączyć się z usługą	Stan i uprawnienia usługi
Lista krajów jest pusta lub połączenie nie działa	Kraj i połączenie z uczestnikiem
Stan to połączono, ale IP się nie zmienia lub brak dostępu	Zakres VPN i ruch
Nie można uruchomić aplikacji lub VPN nie obejmuje wybranej aplikacji	VPN dla aplikacji
Błąd braku obsługi funkcji przez usługę	Wersje aplikacji i usługi
Nie działa tylko udostępnianie mojego Internetu	Udostępnianie i zapis dziennika

Nie można połączyć się z usługą

Aplikacja odczytuje stan usługi w tle i pokazuje go na ekranie. Komunikat oznacza, że aplikacja nie może sprawdzić stanu, a nie że VPN lub udostępnianie na pewno zostały wyłączone.

Gdy usługa wróci do prawidłowego stanu, aplikacja automatycznie połączy się ponownie. Sprawdź stan i uprawnienia odpowiednie dla systemu. Uruchomienie usługi rozpoczyna również udostępnianie Internetu.

Linux

1. Jeśli właśnie zainstalowano program, wyloguj się z pulpitu, zaloguj ponownie i otwórz aplikację.

2. Sprawdź stan usługi w terminalu.

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

3. Jeśli usługa jest zatrzymana i chcesz ponownie używać VPN oraz udostępniania, uruchom ją. Spowoduje to także wznowienie udostępniania Internetu.

   sudo systemctl start muddog-engine.service

4. Jeśli usługa działa, ale aplikacja nie ma dostępu, uruchom id -nG w terminalu konta używającego aplikacji i sprawdź obecność grupy muddog.

Jeśli administrator instalował z innego konta i brakuje grupy, wykonaj poniższe polecenie w terminalu zalogowanym jako zwykły użytkownik, który będzie korzystać z aplikacji. Następnie wyloguj się z pulpitu i zaloguj ponownie.

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

Nie zastępuj tego uruchamianiem aplikacji jako administrator. Jeśli sama usługa nie startuje, poniższe polecenie pokazuje ostatnie błędy.

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

Windows

Sprawdź stan usługi w PowerShell.

Get-Service -Name muddog-engine

Jeśli jest zatrzymana, uruchom ją w PowerShell z uprawnieniami administratora.

Start-Service -Name muddog-engine

Jeśli ustawiono usługę jako wyłączoną, włącz ponownie automatyczny start. Jeśli usługi nie ma lub brakuje wymaganych plików, zainstaluj albo napraw program najnowszym MSI. Aplikację uruchamiaj jako zwykły użytkownik.

macOS

1. Sprawdź, czy używasz macOS 13 lub nowszego i czy Muddog.app skopiowano do /Applications.
2. Sprawdź, czy bieżące konto jest administratorem macOS.
3. Wybierz Service → Enable Background Service, aby zgłosić rejestrację usługi.
4. W Service → Background Service Settings… zatwierdź działanie Muddog w tle. Poczekaj, aż aplikacja połączy się z usługą.

Stan zarejestrowanej usługi można też sprawdzić w terminalu.

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

Uruchomienie aplikacji z DMG lub innego folderu uniemożliwia rejestrację usługi. Jeśli problem pojawił się po zastąpieniu aplikacji, usuń usługę i uruchom aplikację ponownie zgodnie z procedurą aktualizacji macOS.

Jeśli nadal się nie udaje, dołącz treść błędu usługi do raportu o problemie.

Pusta lista krajów lub nieudane połączenie

1. Sprawdź zwykły dostęp do Internetu.
2. Naciśnij Kraj połączenia → Odśwież listę.
3. Jeśli wybrany kraj zniknął, użyj wyboru automatycznego lub innego kraju.
4. Jeśli zmieniano serwer połączenia, przywróć domyślne ustawienia zaawansowane i zapisz.
5. Jeśli problem trwa, sprawdź Szczegóły połączenia.

Połączenie P2P zależy od uczestników wybranego kraju i stanu obu sieci. Obecność kraju na liście nie gwarantuje połączenia. Jeśli brak dostępnego uczestnika, spróbuj później lub wybierz inny kraj. Aby sprawdzić ograniczenia zapory lub routera, możesz porównać działanie na innym dostępnym łączu.

Maksymalnie 10 prób to limit prób połączenia. Jeśli nie uda się znaleźć uczestnika, proces może skończyć się wcześniej. Po zerwaniu już nawiązanego VPN trzeba ręcznie połączyć się ponownie.

Stan to połączono, ale IP się nie zmienia lub brak dostępu

1. Sprawdź, czy Połączenie → Bieżący zakres połączenia odpowiada zamierzonemu trybowi. Sam zapis bez ponownego połączenia pozostawia poprzedni zakres.
2. W trybie adresów IP i zakresów sprawdź, czy docelowy IP jest uwzględniony lub wykluczony. Lista nie przyjmuje nazw domen.
3. W trybie aplikacji całkowicie zamknij aplikację i uruchom ją ponownie z Muddog.
4. Sprawdź, czy badane połączenie używa IPv6. IPv6 nie przechodzi przez VPN, a tryb aplikacji w Windows blokuje IPv6 wybranej aplikacji.
5. Jeśli używasz równocześnie innego VPN lub narzędzia zarządzania siecią, porównaj działanie po jego rozłączeniu. Trasy ustawione przez inne narzędzie mogą mieć pierwszeństwo.

Jeśli przeglądarka lub strona sprawdzająca IP nie należy do zakresu VPN, wyświetlanie IP zwykłego łącza jest normalne. DNS również może korzystać ze zwykłego łącza zależnie od trybu i adresu IP serwera DNS.

Jeśli witryna nadal stosuje ograniczenie kraju, sprawdź inny kraj lub innego uczestnika. Muddog nie gwarantuje dostępu do danej usługi ani określonej szybkości.

W macOS po zmianie używanego łącza, na przykład Wi-Fi, rozłącz VPN i połącz ponownie. Jeśli w trybie uwzględniania IP wystąpi konflikt z trasą hosta ustawioną przez inny program, sprawdź połączenie tego programu i wskazane adresy IP oraz zakresy.

VPN dla aplikacji nie działa

• macOS nie obsługuje VPN dla aplikacji. Użyj całego Internetu lub trybu IP i zakresów.
• Jeśli Uruchom przez VPN jest nieaktywne, sprawdź zapisanie trybu aplikacji, połączenie VPN w tym trybie i wybranie aplikacji do uruchomienia.
• Jeśli lista aplikacji jest pusta, użyj Odśwież listę lub Znajdź plik wykonywalny.
• Jeśli przeglądarka otwiera tylko istniejące okno, zakończ również procesy w tle i uruchom ją ponownie.
• Aplikacje przekazujące uruchomienie osobnej usłudze lub używające istniejącej instancji nie są obsługiwane. Sprawdź sposób instalacji i wymagania VPN dla aplikacji.
• W Linux aplikacje Snap i Flatpak nie są obsługiwane. Przy błędzie sesji użytkownika systemd, cgroup v2 lub nftables sprawdź środowisko i dołącz Szczegóły błędu do raportu.
• W Windows trzeba wybrać plik .exe. Po ponownym połączeniu VPN całkowicie zamknij program i uruchom go ponownie z Muddog.
• Jeśli Windows zgłasza brak składnika WinDivert lub niemożność jego załadowania, napraw albo zainstaluj ponownie przez MSI. Jeśli problem trwa, zgłoś Szczegóły błędu.

Różne wersje aplikacji i usługi

Połączenie aplikacji ze starszą usługą nieobsługującą żądanej funkcji powoduje błąd. Zaktualizuj aplikację i usługę razem za pomocą nowego pakietu. Brak VPN dla aplikacji w macOS wynika z zakresu obsługi, a nie błędu wersji.

Jeśli po aktualizacji błąd pozostaje, uruchom usługę ponownie metodą odpowiednią dla systemu. Ponowne uruchomienie przerywa osobisty VPN i połączenia udostępniania.

W Linux zamknij aplikację, wykonaj polecenie i otwórz ją ponownie.

sudo systemctl restart muddog-engine.service

W Windows zamknij aplikację, wykonaj polecenie w administracyjnym PowerShell i otwórz ją ponownie.

Restart-Service -Name muddog-engine

W macOS wybierz Service → Remove Background Service and Quit, uruchom ponownie Muddog z /Applications i zatwierdź wymagane uprawnienia usługi.

Po restarcie usługi trzeba ponownie połączyć VPN. Jeśli błąd trwa, zamiast wielokrotnie restartować, zgłoś wersję aplikacji i szczegóły błędu.

Nie działa tylko udostępnianie lub nie można odczytać dziennika

Najpierw sprawdź Udostępnianie mojego Internetu → Szczegóły połączenia. Brak miejsca, przekroczenie limitu dziennika lub błąd zapisu pliku zatrzymuje udostępnianie. Wpisy są zapisywane zgodnie z zasadami lokalnego przechowywania.

Sprawdź wolne miejsce i dzienniki usługi. Jeśli przechowywane wpisy są potrzebne, nie usuwaj ich bez zastanowienia tylko po to, by pozbyć się błędu. Poproś o pomoc, podając komunikat.

Jeśli nie działa tylko przeglądanie dziennika, sprawdź uprawnienia dostępu do usługi i jej wersję. Jeśli porządkowanie dzienników dziennych zmieniło zawartość podczas wyszukiwania, ponownie wybierz datę i warunki, a następnie naciśnij Wyszukaj. Jeśli wyszukiwanie się powiodło, ale wynik jest pusty, sprawdź datę UTC, filtry i Następne wpisy.