Przejdź do głównej zawartości

Instalacja i aktualizacja Muddog

Wymagania​

Na stronie pobierania sprawdź system i wersję, a następnie pobierz instalator.

SystemPakiet i wymagania
Linux x86_64Pakiety .deb i .rpm. Wymagane jest środowisko graficzne używające systemd.
Windows 10/11 x64Instalator .msi. Obecny pakiet Windows obsługuje tylko x64.
macOS 13 Ventura lub nowszyInstalator .dmg. Pakiet Universal obsługuje Intel i Apple Silicon. Sterowanie aplikacją wymaga konta administratora macOS.

Menedżer pakietów Linuksa instaluje biblioteki i zależności potrzebne do uruchamiania aplikacji. VPN dla aplikacji w Linuksie wymaga dodatkowo sesji użytkownika systemd i cgroup v2; nftables znajduje się w zależnościach pakietu. Windows również obsługuje VPN dla aplikacji, a macOS obsługuje VPN dla całego internetu oraz wskazanych IP i zakresów.

Instrukcja dotyczy wersji 2.x. Jeśli strona pobierania nie pokazuje jeszcze pliku 2.x dla Twojego systemu, najpierw sprawdź dostępność wydania. Plik .exe wersji 1.0.7 dla Windows opisano w instrukcji starszej wersji.

Uruchomienie usługi włącza udostępnianie

W Linuksie i Windows udostępnianie internetu zaczyna się automatycznie po instalacji, a w macOS po pierwszym uruchomieniu i zatwierdzeniu usługi w tle. Usługa uruchamia się również przy starcie systemu, więc inni użytkownicy mogą korzystać z Twojego łącza bez otwierania okna aplikacji. Przed instalacją przeczytaj zarządzanie udostępnianiem internetu.

Instalacja w Linuksie​

Poniższe polecenia używają przykładowych nazw plików 2.0.0. W terminalu przejdź do katalogu pobranego pliku i zastąp nazwę rzeczywistą nazwą pakietu. Instalacja wymaga uprawnień administratora.

Debian / Ubuntu​

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora​

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

Pierwsze uruchomienie po instalacji​

  1. Po instalacji wyloguj się z sesji graficznej i zaloguj ponownie.
  2. Uruchom Muddog z menu aplikacji.
  3. Na ekranie Połączenie sprawdź, czy widoczny jest stan VPN i Udostępnianie mojego internetu.
  4. Wybierz kraj i połącz się zgodnie z instrukcją łączenia VPN.

Instalacja przez sudo ze zwykłego konta dodaje tego użytkownika do grupy muddog. Uprawnienie zacznie obowiązywać po ponownym zalogowaniu. Uruchamiaj aplikację jako zwykły użytkownik; VPN nie wymaga identyfikatora ani hasła Mudfish.

Jeśli administrator instalował z innego konta lub aplikacją ma sterować wielu użytkowników, zobacz sprawdzanie uprawnień dostępu do usługi.

Instalacja w Windows​

  1. Jeśli masz Muddog zainstalowany starszym instalatorem .exe, najpierw usuń go przez Ustawienia → Aplikacje. Jeśli pojawi się prośba o usunięcie poprzedniej instalacji, zakończ usuwanie i ponownie uruchom instalację MSI.
  2. Uruchom pobrany .msi i zatwierdź uprawnienia administratora.
  3. Postępuj zgodnie z kreatorem. Jeśli brakuje WebView2 Runtime, instalator pobierze go z internetu, więc potrzebne jest połączenie.
  4. Uruchom muddog z menu Start lub pulpitu jako zwykły użytkownik.
  5. Sprawdź stan usługi na ekranie Połączenie i przejdź do łączenia VPN.

Domyślna lokalizacja to %ProgramFiles%\muddog. Instalator rejestruje i automatycznie uruchamia usługę muddog-engine oraz dodaje regułę zapory dla przychodzącego UDP wymaganego przez silnik. Pakiet zawiera składniki potrzebne do VPN i VPN dla aplikacji. Nie trzeba uruchamiać aplikacji jako administrator przy każdym użyciu.

Instalacja w macOS​

  1. Otwórz pobrany .dmg.
  2. Skopiuj Muddog.app do folderu Aplikacje (/Applications). Uruchomienie bezpośrednio z DMG nie pozwala zarejestrować usługi w tle.
  3. Na koncie administratora macOS uruchom skopiowany Muddog.
  4. W Ustawienia systemowe → Ogólne → Rzeczy otwierane i rozszerzenia zezwól Muddog na działanie w tle. Nazwy opcji mogą różnić się zależnie od wersji macOS.
  5. Gdy aplikacja ponownie połączy się z usługą, przejdź do łączenia VPN.

Aby ponownie otworzyć ekran zezwoleń, wybierz z paska menu macOS Service → Background Service Settings…. Jeśli trzeba zarejestrować usługę, wybierz Service → Enable Background Service. Nazwy tych opcji są wyświetlane po angielsku. Samą aplikację uruchamiaj bez sudo.

Aktualizacja​

Jeśli używasz VPN, naciśnij Rozłącz, a następnie pobierz nowy instalator dla swojego systemu.

  • Linux: zamknij aplikację i zainstaluj nowy .deb lub .rpm powyższym poleceniem z nową nazwą pliku.
  • Windows: zamknij aplikację i uruchom nowy .msi. Dotychczasowa instalacja MSI zostanie zastąpiona podczas aktualizacji.
  • macOS: najpierw wybierz Service → Remove Background Service and Quit, aby usunąć usługę i zamknąć aplikację. Zastąp aplikację w /Applications nowym Muddog.app z DMG, uruchom ją i zatwierdź wymagane uprawnienia usługi.

Aktualizacja przerywa trwające połączenia VPN i udostępniania. Po niej otwórz aplikację i sprawdź stan obu funkcji. Jeśli pojawi się błąd różnych wersji aplikacji i usługi, zobacz rozwiązywanie problemów.

Przy przejściu z wersji 1.0.7 w Linuksie zamknij starą aplikację i zainstaluj nowy pakiet. Instalator zatrzyma i wyłączy automatyczne uruchamianie muddog_srv.service, jeśli jest zarejestrowana. Od tej pory uruchamiaj Muddog z menu aplikacji.

Usuwanie​

Linux​

Debian / Ubuntu:

sudo apt remove muddog

Fedora:

sudo dnf remove muddog

Usunięcie pakietu zatrzymuje usługę i VPN oraz usuwa trasy sieciowe dodane przez Muddog. W Debianie/Ubuntu, aby usunąć także dedykowane konto i grupę usługi, zamiast zwykłego usuwania możesz użyć sudo apt purge muddog.

Windows​

W Ustawienia → Aplikacje wybierz muddog i usuń program. Deinstalacja zatrzymuje usługę i VPN, porządkuje trasy VPN, a następnie usuwa usługę i reguły zapory dodane podczas instalacji. Ustawienia użytkownika oraz rejestry połączeń i przekazywania są zachowywane.

macOS​

  1. W aplikacji wybierz Service → Remove Background Service and Quit.
  2. Po usunięciu usługi i zamknięciu aplikacji przenieś Muddog.app z /Applications do Kosza.

Usunięcie samej aplikacji w pierwszej kolejności może opóźnić uporządkowanie elementów działających w tle. Ustawienia użytkownika oraz rejestry połączeń i przekazywania są zachowywane.

Pozostałe rejestry i zatrzymywanie udostępniania​

Usunięcie pakietu i usunięcie rejestrów połączeń/przekazywania to odrębne czynności. Lokalizacje i zasady przechowywania pozostałych rejestrów opisano w rejestrach połączeń i przekazywania. Aby zachować program, ale zatrzymać udostępnianie, możesz zatrzymać usługę. Dopóki usługa jest zatrzymana, własny VPN również nie będzie dostępny.