Installazione e aggiornamento di Muddog

Sistemi supportati

Controlla sistema operativo e versione sulla pagina di download, quindi scarica il programma di installazione.

Sistema operativo	Pacchetto e requisiti
Linux x86_64	Pacchetti .deb e .rpm. Richiede un ambiente desktop con systemd.
Windows 10/11 x64	Programma di installazione .msi. Il pacchetto Windows supporta attualmente soltanto x64.
macOS 13 Ventura o successivo	File .dmg. Il pacchetto Universal supporta Intel e Apple Silicon. Per controllare l’app serve un account amministratore macOS.

Il gestore di installazione Linux installa anche le librerie e le dipendenze necessarie all’app. La VPN per applicazione su Linux richiede inoltre una sessione utente systemd e cgroup v2; nftables è incluso nelle dipendenze del pacchetto. Anche Windows supporta la VPN per applicazione; macOS supporta la VPN per tutto Internet o per IP e intervalli.

Questa guida riguarda la versione 2.x. Se nella pagina di download non compare ancora un file 2.x per il tuo sistema, verificane prima la disponibilità. Per il file .exe di Windows 1.0.7, segui la guida alla versione precedente.

La condivisione inizia con il servizio

Su Linux e Windows, la condivisione Internet parte automaticamente al termine dell’installazione; su macOS, dopo il primo avvio e l’autorizzazione del servizio in background. In seguito il servizio parte anche all’avvio del sistema: altri utenti possono utilizzare la tua connessione senza che la finestra dell’app sia aperta. Prima di installare, consulta Gestione della condivisione Internet.

Installazione su Linux

I comandi seguenti utilizzano nomi di file della versione 2.0.0 come esempio. Nel terminale, passa alla directory del file scaricato e sostituisci il nome con quello del pacchetto effettivamente ricevuto. L’installazione richiede privilegi amministrativi.

Debian / Ubuntu

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora

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

Primo avvio dopo l’installazione

1. Al termine dell’installazione, esci dalla sessione desktop e accedi nuovamente.
2. Avvia Muddog dal menu delle applicazioni.
3. Verifica che la schermata Connessione mostri lo stato della VPN e di Condivisione della mia connessione Internet.
4. Segui Connessione VPN per scegliere un paese e connetterti.

Installando con sudo da un account normale, quell’utente viene aggiunto al gruppo muddog. Occorre accedere nuovamente affinché l’app riceva questo permesso. Avvia l’app come utente normale; per usare la VPN non devi inserire ID o password Mudfish.

Se un amministratore ha installato da un altro account o più utenti devono controllare l’app, consulta Verifica dei permessi di accesso al servizio.

Installazione su Windows

1. Se hai Muddog installato con il vecchio programma .exe, rimuovilo prima da Impostazioni → App di Windows. Se viene chiesto di rimuovere la versione esistente, completane la rimozione prima di ripetere l’installazione MSI.
2. Esegui il file .msi scaricato e autorizza la richiesta di privilegi amministrativi.
3. Segui le istruzioni. Se WebView2 Runtime manca, l’assistente lo scarica da Internet: serve quindi una connessione Internet.
4. Avvia muddog dal menu Start o dal desktop con i normali privilegi utente.
5. Verifica lo stato del servizio nella schermata Connessione e prosegui con Connessione VPN.

La directory predefinita è %ProgramFiles%\muddog. Il programma di installazione registra e avvia automaticamente il servizio muddog-engine e aggiunge la regola firewall UDP in ingresso necessaria al motore. I componenti per VPN e VPN per applicazione sono inclusi nel pacchetto. Non occorre eseguire l’app come amministratore a ogni utilizzo.

Installazione su macOS

1. Apri il file .dmg scaricato.
2. Copia Muddog.app nella cartella Applicazioni (/Applications). Avviandola direttamente dal DMG non puoi registrare il servizio in background.
3. Da un account amministratore macOS, avvia la copia di Muddog.
4. In Impostazioni di Sistema → Generali → Elementi login ed estensioni, autorizza l’esecuzione in background di Muddog. I nomi possono variare con la versione di macOS.
5. Quando l’app si riconnette al servizio, segui Connessione VPN.

Per riaprire la schermata di autorizzazione, seleziona Service → Background Service Settings… dalla barra dei menu macOS. Se occorre registrare il servizio, scegli Service → Enable Background Service. Questi menu sono visualizzati in inglese. Avvia l’app senza sudo.

Aggiornamento

Se la VPN è attiva, premi Disconnetti, quindi scarica il nuovo programma di installazione per il tuo sistema.

• Linux: chiudi l’app e usa i comandi di installazione precedenti con il nome del nuovo file .deb o .rpm.
• Windows: chiudi l’app ed esegui il nuovo .msi. L’installazione MSI precedente viene sostituita durante l’aggiornamento.
• macOS: prima rimuovi il servizio e chiudi l’app con Service → Remove Background Service and Quit. Sostituisci l’app in /Applications con Muddog.app del nuovo DMG, riavviala e completa le autorizzazioni necessarie.

L’aggiornamento interrompe le connessioni VPN e di condivisione in corso. Riapri l’app e verificane lo stato al termine. Se compare un errore per versioni diverse di app e servizio, consulta Risoluzione dei problemi.

Per passare dalla vecchia versione Linux 1.0.7, chiudi l’app precedente e installa il nuovo pacchetto. Se muddog_srv.service è registrato, il programma di installazione lo arresta e ne disabilita l’avvio automatico. Da quel momento avvia Muddog dal menu delle applicazioni.

Disinstallazione

Linux

Su Debian / Ubuntu:

sudo apt remove muddog

Su Fedora:

sudo dnf remove muddog

La rimozione del pacchetto arresta servizio e VPN e ripulisce i percorsi di rete aggiunti da Muddog. Su Debian / Ubuntu, per eliminare anche account e gruppo dedicati al servizio, puoi usare sudo apt purge muddog al posto della rimozione normale.

Windows

In Impostazioni → App, seleziona muddog e disinstallalo. La procedura arresta servizio e VPN, ripulisce i percorsi VPN, quindi rimuove il servizio e le regole firewall aggiunte all’installazione. Impostazioni utente e registri delle connessioni e dell’inoltro vengono conservati.

macOS

1. Nell’app, seleziona Service → Remove Background Service and Quit.
2. Quando la rimozione del servizio e la chiusura dell’app sono completate, sposta Muddog.app da /Applications al Cestino.

Eliminare prima il solo file dell’app può ritardare la rimozione degli elementi in background. Impostazioni utente e registri vengono conservati.

Registri residui e interruzione della condivisione

La rimozione del pacchetto e l’eliminazione dei registri sono operazioni distinte. Per posizione e conservazione dei registri locali, consulta Registri delle connessioni e dell’inoltro. Per mantenere il programma e interrompere soltanto la condivisione, puoi arrestare il servizio, ma finché il servizio è fermo non puoi usare neppure la tua VPN.