Siirry pääsisältöön

Muddogin asennus ja päivitys

Järjestelmävaatimukset​

Tarkista käyttöjärjestelmä ja versio lataussivulta ja lataa asennustiedosto.

KäyttöjärjestelmäPaketti ja käyttöohje
Linux x86_64.deb- ja .rpm-paketit. Edellyttää systemd:tä käyttävää työpöytäympäristöä.
Windows 10/11 x64.msi-asennustiedosto. Windows-paketti tukee tällä hetkellä vain x64:ää.
macOS 13 Ventura tai uudempi.dmg-asennustiedosto. Universal-paketti tukee Inteliä ja Apple Siliconia. Sovelluksen hallinta edellyttää macOS:n ylläpitäjätiliä.

Linuxin paketinhallinta asentaa tarvittavat kirjastot ja riippuvuudet. Linuxin sovelluskohtainen VPN edellyttää lisäksi systemd-käyttäjäistuntoa ja cgroup v2:ta. nftables sisältyy paketin riippuvuuksiin. Myös Windows tukee sovelluskohtaista VPN:ää. macOS tukee koko internetin sekä IP- ja verkkokohtaista VPN:ää.

Tämä ohje koskee versiota 2.x. Jos lataussivulla ei vielä näy käyttöjärjestelmäsi 2.x-tiedostoa, tarkista ensin sen julkaisutilanne. Windowsin 1.0.7-version .exe-tiedostoon sovelletaan vanhan version ohjetta.

Jakaminen alkaa palvelun käynnistyessä

Linuxissa ja Windowsissa internetin jakaminen alkaa automaattisesti asennuksen valmistuttua. macOS:ssa se alkaa ensimmäisen käynnistyksen ja taustapalvelun hyväksymisen jälkeen. Palvelu käynnistyy myöhemmin myös tietokoneen käynnistyessä, joten muut käyttäjät voivat käyttää liittymääsi avaamatta sovellusikkunaa. Tutustu ennen asennusta internetin jakamisen hallintaan.

Asentaminen Linuxiin​

Alla olevat komennot käyttävät version 2.0.0 esimerkkitiedostonimiä. Siirry päätteessä lataushakemistoon ja vaihda tiedostonimi todella lataamasi paketin nimeksi. Asennus edellyttää ylläpitäjän oikeuksia.

Debian / Ubuntu​

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora​

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

Ensimmäinen käynnistys asennuksen jälkeen​

  1. Kirjaudu ulos työpöydältä ja takaisin sisään asennuksen jälkeen.
  2. Käynnistä Muddog sovellusvalikosta.
  3. Tarkista, että Yhteys-näkymässä näkyvät VPN:n ja oman internetin jakamisen tilat.
  4. Valitse maa ja yhdistä VPN-yhteysohjeen mukaisesti.

Kun asennat tavalliselta käyttäjätililtä komennolla sudo, kyseinen käyttäjä lisätään muddog-ryhmään. Uusi kirjautuminen tarvitaan oikeuden voimaantuloon. Suorita sovellus tavallisena käyttäjänä. VPN:n käyttöön ei syötetä Mudfish-tunnusta tai salasanaa.

Jos ylläpitäjä asensi ohjelman toiselta tililtä tai usean käyttäjän täytyy hallita sovellusta, katso palvelun käyttöoikeuksien tarkistus.

Asentaminen Windowsiin​

  1. Jos Muddog on asennettu vanhalla .exe-asennusohjelmalla, poista se ensin Windowsin Asetukset → Sovellukset -kohdasta. Jos asennus pyytää poistamaan vanhan version, tee poisto ja aloita MSI-asennus uudelleen.
  2. Suorita ladattu .msi ja hyväksy ylläpitäjän oikeuspyyntö.
  3. Noudata asennusohjeita. Jos WebView2 Runtime puuttuu, asennusapu lataa sen internetistä, joten verkkoyhteys tarvitaan.
  4. Käynnistä Käynnistä-valikon tai työpöydän muddog tavallisen käyttäjän oikeuksilla.
  5. Tarkista palvelun tila Yhteys-näkymästä ja noudata VPN-yhteysohjetta.

Oletusasennuspolku on %ProgramFiles%\muddog. Asennus rekisteröi ja käynnistää automaattisesti muddog-engine-palvelun sekä lisää moottorin tarvitseman saapuvan UDP-liikenteen palomuurisäännön. VPN:n ja sovelluskohtaisen VPN:n osat sisältyvät pakettiin. Sovellusta ei tarvitse suorittaa joka kerta ylläpitäjänä.

Asentaminen macOS:ään​

  1. Avaa ladattu .dmg.
  2. Kopioi Muddog.app Ohjelmat (/Applications) -kansioon. Taustapalvelua ei voi rekisteröidä, jos sovellus käynnistetään suoraan DMG:stä.
  3. Käynnistä kopioitu Muddog macOS:n ylläpitäjätilillä.
  4. Hyväksy Muddogin taustasuoritus kohdasta Järjestelmäasetukset → Yleiset → Kirjautumiskohteet ja laajennukset. Nimet voivat vaihdella macOS-version mukaan.
  5. Kun sovellus yhdistää palveluun uudelleen, noudata VPN-yhteysohjetta.

Avaa hyväksymisasetukset uudelleen macOS:n valikkorivin kohdasta Service → Background Service Settings…. Jos palvelu täytyy rekisteröidä, valitse Service → Enable Background Service. Nämä valikot näkyvät englanniksi. Käynnistä itse sovellus ilman sudo-komentoa.

Päivittäminen​

Jos VPN on käytössä, paina Katkaise yhteys ja lataa käyttöjärjestelmällesi uusi asennustiedosto lataussivulta.

  • Linux: sulje sovellus ja käytä yllä olevaa asennuskomentoa uuden .deb- tai .rpm-tiedoston nimellä.
  • Windows: sulje sovellus ja suorita uusi .msi. Aiempi MSI-asennus korvataan päivityksessä.
  • macOS: poista ensin palvelu ja sulje sovellus valinnalla Service → Remove Background Service and Quit. Korvaa /Applications-kansion sovellus uuden DMG:n Muddog.app-tiedostolla, käynnistä se ja hyväksy tarvittavat palveluluvat.

Päivitys katkaisee käynnissä olevat VPN- ja jakamisyhteydet. Avaa sovellus päivityksen jälkeen ja tarkista yhteyden sekä jakamisen tilat. Jos sovelluksen ja palvelun eri versioista näkyy virhe, katso Vianmääritys.

Vaihdettaessa Linuxin vanhasta 1.0.7-versiosta sulje aiempi sovellus ja asenna uusi paketti. Jos muddog_srv.service on rekisteröity, asennus pysäyttää sen ja poistaa automaattisen käynnistyksen. Käynnistä tämän jälkeen sovellusvalikon Muddog.

Poistaminen​

Linux​

Debianissa ja Ubuntussa käytä:

sudo apt remove muddog

Fedorassa käytä:

sudo dnf remove muddog

Paketin poistaminen pysäyttää palvelun ja VPN:n sekä siivoaa Muddogin lisäämät verkkoreitit. Debianissa ja Ubuntussa voit poistaa myös erillisen palvelutilin ja ryhmän komennolla sudo apt purge muddog tavallisen poiston sijasta.

Windows​

Valitse muddog Windowsin Asetukset → Sovellukset -kohdasta ja poista se. Poisto pysäyttää palvelun ja VPN:n, siivoaa VPN-reitit sekä poistaa palvelun ja asennuksessa lisätyn palomuurisäännön. Käyttäjäasetukset ja yhteys- sekä välityslokit säilyvät.

macOS​

  1. Valitse sovelluksessa Service → Remove Background Service and Quit.
  2. Kun palvelu on poistettu ja sovellus sulkeutunut, siirrä /Applications-kansion Muddog.app roskakoriin.

Jos poistat sovellustiedoston ensin, taustakohteen siivous voi viivästyä. Käyttäjäasetukset sekä yhteys- ja välityslokit säilyvät.

Jäljelle jäävät lokit ja jakamisen pysäyttäminen​

Paketin poistaminen ja yhteys- sekä välityslokien poistaminen ovat eri asioita. Paikallisten lokien sijainnit ja säilytys kuvataan kohdassa Yhteys- ja välityslokit. Voit pysäyttää vain jakamisen poistamatta ohjelmaa pysäyttämällä palvelun, mutta palvelun ollessa pysäytettynä myöskään oma VPN ei ole käytettävissä.