Risoluzione dei problemi di Muddog

Nella schermata Connessione, verifica prima se il problema riguarda la tua connessione VPN o la condivisione della tua connessione Internet. La causa compare nei rispettivi dettagli della connessione o nei dettagli dell’errore della notifica.

Sintomo	Controllo
Impossibile connettersi al servizio	Stato e permessi del servizio
Elenco dei paesi vuoto o connessione fallita	Paese e connessione al peer
Stato connesso ma IP invariato o accesso impossibile	Ambito VPN e traffico
Pulsante di avvio app disabilitato o app specifica non inclusa	VPN per applicazione
Il servizio non supporta una funzione richiesta	Versioni di app e servizio
Fallisce soltanto la condivisione Internet	Condivisione e registri

Impossibile connettersi al servizio

L’app legge e mostra lo stato del servizio in background. Questo messaggio significa che l’app non riesce a verificarne lo stato, non che VPN o condivisione siano certamente disattivate.

Quando il servizio torna disponibile, l’app si riconnette automaticamente. Verifica stato e permessi secondo il sistema operativo. Avviare il servizio avvia anche la condivisione Internet.

Linux

1. Se hai appena installato, esci dalla sessione desktop, accedi nuovamente e apri l’app.

2. Controlla lo stato del servizio dal terminale.

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

3. Se è fermo e vuoi riprendere VPN e condivisione, avvialo. Anche la condivisione Internet riprenderà.

   sudo systemctl start muddog-engine.service

4. Se il servizio è attivo ma l’app non vi accede, esegui id -nG dal terminale dell’account che usa l’app e verifica che compaia il gruppo muddog.

Se il gruppo manca perché un amministratore ha installato da un altro account, esegui il seguente comando da un terminale dell’utente normale che utilizzerà l’app. Poi esci dalla sessione desktop e accedi nuovamente.

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

Non sostituire questa procedura con l’esecuzione dell’app come amministratore. Se il servizio stesso non parte, consulta gli errori recenti con:

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

Windows

Controlla lo stato da PowerShell.

Get-Service -Name muddog-engine

Se è fermo, avvialo da PowerShell eseguito come amministratore.

Start-Service -Name muddog-engine

Se il servizio è disabilitato, segui le istruzioni per riattivare l’avvio automatico. Se manca il servizio o qualche file necessario, installa o ripara con l’MSI più recente. Avvia l’app come utente normale.

macOS

1. Verifica di usare macOS 13 o successivo e di aver copiato Muddog.app in /Applications.
2. Verifica che l’account corrente sia un amministratore macOS.
3. Richiedi la registrazione del servizio con Service → Enable Background Service.
4. In Service → Background Service Settings…, autorizza l’esecuzione in background di Muddog. Attendi che l’app si riconnetta al servizio.

Puoi controllare il servizio registrato anche dal terminale.

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

Non puoi registrare il servizio avviando l’app dal DMG o da un’altra cartella. Se il problema è iniziato dopo aver sostituito l’app, rimuovi il servizio e riavvia l’app seguendo la procedura di aggiornamento macOS.

Se il problema persiste, includi l’errore del servizio nella segnalazione.

Elenco dei paesi vuoto o connessione fallita

1. Verifica che la normale connessione Internet funzioni.
2. Premi Paese di connessione → Aggiorna elenco.
3. Se il paese scelto è scomparso, usa Selezione automatica o un altro paese.
4. Se hai modificato il server di connessione, ripristina i valori predefiniti delle impostazioni avanzate e salva.
5. Se continua a fallire, consulta i dettagli della connessione.

La connessione P2P dipende dai partecipanti nel paese selezionato e dalle condizioni di entrambe le reti. La presenza di un paese nell’elenco non garantisce la connessione. Se non ci sono peer disponibili, riprova più tardi o scegli un altro paese. Per verificare eventuali limitazioni di firewall o router, puoi confrontare il comportamento usando un’altra connessione Internet disponibile.

Dieci è il numero massimo di tentativi. La procedura può terminare prima se non trova peer; se una VPN già stabilita cade, devi riconnetterti manualmente.

Connesso, ma IP invariato o accesso impossibile

1. Verifica che Connessione → Ambito della connessione corrente mostri la modalità desiderata. Se hai soltanto salvato senza riconnetterti, rimane attivo l’ambito precedente.
2. Nelle modalità IP/intervalli, verifica se l’IP di destinazione è incluso o escluso dall’elenco. Non puoi inserire nomi di dominio nell’elenco degli indirizzi.
3. Nella modalità per applicazione, chiudi completamente l’app e riavviala da Muddog.
4. Verifica se la connessione da controllare usa IPv6. IPv6 non attraversa la VPN; la modalità per applicazione Windows lo blocca per le app selezionate.
5. Se usi altre VPN o strumenti di gestione della rete, confronta anche il comportamento dopo averli disconnessi. I percorsi impostati da altri strumenti possono avere la precedenza.

Se il browser o la pagina di verifica IP non rientrano nell’ambito VPN, è normale vedere l’IP originale. Anche DNS può usare la connessione originale in base alla modalità e all’IP del server DNS.

Se un sito continua ad applicare restrizioni geografiche, prova un altro paese o peer. Muddog non garantisce l’accesso a quel servizio o una velocità specifica.

Su macOS, se cambi la connessione utilizzata, ad esempio Wi-Fi, disconnetti e riconnetti la VPN. Se in modalità inclusione IP compare un conflitto con un percorso host impostato da un altro programma, controlla la connessione di quel programma e gli IP/intervalli specificati.

La VPN per applicazione non viene applicata

• macOS non supporta questa funzione. Usa tutto Internet o la modalità IP/intervalli.
• Se Avvia nella VPN è disabilitato, verifica di aver salvato la modalità per applicazione, di essere connesso in quella modalità e di aver selezionato un’app.
• Se l’elenco è vuoto, usa Aggiorna elenco o Cerca eseguibile.
• Se il browser riapre soltanto una finestra esistente, termina anche tutti i processi in background prima di avviarlo.
• Le app che delegano l’esecuzione a un servizio separato o riutilizzano un’istanza esistente non sono supportate. Verifica il metodo di installazione e i requisiti della VPN per applicazione.
• Su Linux, le app Snap e Flatpak non sono supportate. Per errori relativi a sessione utente systemd, cgroup v2 o nftables, verifica l’ambiente e includi i dettagli dell’errore nella segnalazione.
• Su Windows devi selezionare il file .exe. Dopo una riconnessione VPN, chiudi completamente il programma e riavvialo da Muddog.
• Se Windows segnala componenti WinDivert mancanti o impossibili da caricare, ripara o reinstalla con l’MSI. Se il problema persiste, segnala i dettagli dell’errore.

Versioni diverse di app e servizio

Un servizio vecchio può non supportare una funzione richiesta dall’app, causando un errore. Aggiorna insieme app e servizio con il nuovo pacchetto. L’assenza della VPN per applicazione su macOS è un limite di supporto, non un errore di versione.

Se dopo l’aggiornamento l’errore rimane, riavvia il servizio secondo il sistema operativo. Il riavvio interrompe le connessioni VPN personali e di condivisione in corso.

Su Linux, chiudi l’app, esegui il comando e riaprila.

sudo systemctl restart muddog-engine.service

Su Windows, chiudi l’app, esegui da PowerShell amministratore e riaprila.

Restart-Service -Name muddog-engine

Su macOS, scegli Service → Remove Background Service and Quit, riavvia Muddog da /Applications e completa le autorizzazioni necessarie.

Dopo il riavvio del servizio devi riconnettere la VPN. Se l’errore persiste, segnala versione dell’app e dettagli dell’errore, anziché continuare a riavviare.

Fallisce soltanto la condivisione o non si leggono i registri

Controlla prima Condivisione della mia connessione Internet → Dettagli della connessione. La condivisione si arresta se manca spazio per i registri, viene superato il limite di archiviazione o si verifica un errore di scrittura. I registri seguono le regole di conservazione locale.

Controlla lo spazio disco e i log del servizio. Se potresti aver bisogno dei registri conservati, non cancellarli indiscriminatamente per eliminare l’errore: richiedi assistenza allegando il messaggio.

Se fallisce soltanto la consultazione, verifica permessi e versione del servizio. Se i registri giornalieri sono stati ripuliti durante la ricerca, seleziona nuovamente data e filtri e premi Cerca. Se la ricerca riesce ma non mostra risultati, controlla data UTC, filtri e Registri successivi.