Resolució de problemes de Muddog

Primer comproveu a Connexió si el problema afecta la vostra connexió VPN o la compartició de la vostra connexió a Internet. La causa apareix als Detalls de connexió corresponents o als Detalls de l'error de la notificació.

Símptoma	Què cal comprovar
No es pot connectar al servei	Estat i permisos del servei
Llista de països buida o connexió fallida	Països i connexió amb participants
Connectat, però la IP no canvia o no hi ha accés	Abast de la VPN i trànsit
No es pot executar una aplicació o no s'hi aplica la VPN	VPN per aplicació
El servei no admet una funció	Versions de l'aplicació i del servei
Només falla la compartició d'Internet	Compartició i desament de registres

No es pot connectar al servei

L'aplicació consulta l'estat del servei en segon pla per mostrar-lo. Aquest missatge significa que l'aplicació no pot comprovar-ne l'estat, no que la VPN o la compartició estiguin necessàriament desactivades.

Quan el servei torna a funcionar, l'aplicació s'hi reconnecta automàticament. Comproveu l'estat i els permisos segons el vostre sistema operatiu. Iniciar el servei també inicia la compartició d'Internet.

Linux

1. Si acabeu d'instal·lar-lo, tanqueu la sessió de l'escriptori, torneu-hi a entrar i obriu l'aplicació.

2. Comproveu l'estat del servei al terminal.

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

3. Si el servei està aturat i voleu reprendre la VPN i la compartició, inicieu-lo. La compartició també es reprendrà.

   sudo systemctl start muddog-engine.service

4. Si el servei funciona però l'aplicació no hi accedeix, executeu id -nG al terminal del compte que utilitza l'aplicació i comproveu si hi apareix el grup muddog.

Si un administrador ha instal·lat el paquet amb un altre compte i falta el grup, executeu l'ordre següent en un terminal amb la sessió de l'usuari normal que utilitzarà l'aplicació. Després, tanqueu la sessió de l'escriptori i torneu-hi a entrar.

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

No substituïu aquest procediment executant l'aplicació com a administrador. Si el servei mateix no s'inicia, consulteu els errors recents:

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

Windows

Comproveu l'estat des de PowerShell:

Get-Service -Name muddog-engine

Si està aturat, inicieu-lo des de PowerShell executat com a administrador:

Start-Service -Name muddog-engine

Si heu desactivat el servei, seguiu Reactivar l'inici automàtic. Si falta el servei o algun fitxer necessari, instal·leu-lo o repareu-lo amb l'MSI més recent. Executeu l'aplicació com a usuari normal.

macOS

1. Comproveu que utilitzeu macOS 13 o posterior i que hàgiu copiat Muddog.app a /Applications.
2. Comproveu que la sessió actual sigui d'un compte d'administrador de macOS.
3. Sol·liciteu el registre del servei amb Service → Enable Background Service.
4. A Service → Background Service Settings…, autoritzeu l'execució en segon pla de Muddog i espereu que l'aplicació es reconnecti al servei.

També podeu consultar l'estat del servei registrat al terminal:

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

No es pot registrar el servei si executeu l'aplicació des del DMG o des d'una altra carpeta. Si el problema ha aparegut després de substituir l'aplicació, seguiu el procediment d'actualització de macOS, elimineu el servei i torneu a obrir l'aplicació.

Si encara falla, incloeu l'error del servei a Informar d'un problema.

Llista de països buida o connexió fallida

1. Comproveu que Internet funcioni normalment.
2. Premeu País de connexió → Actualitza la llista.
3. Si el país seleccionat ha desaparegut, utilitzeu Selecció automàtica o un altre país.
4. Si heu modificat el servidor de connexió, restabliu els valors predeterminats avançats i deseu.
5. Si continua fallant, consulteu Detalls de connexió.

La connexió P2P depèn dels participants del país seleccionat i de les xarxes de tots dos extrems. Que un país aparegui no garanteix poder-hi connectar. Si no hi ha cap participant disponible, torneu-ho a provar més tard o trieu un altre país. Per comprovar si la causa és un tallafoc o una restricció de l'encaminador, podeu comparar amb una altra connexió a Internet disponible.

10 intents és el límit màxim. El procés pot acabar abans si no troba cap participant. Si una VPN ja connectada es desconnecta, cal reconnectar-la manualment.

Apareix connectat, però la IP no canvia o no hi ha accés

1. Comproveu que Connexió → Abast actual de la connexió sigui el mode desitjat. Si només heu desat sense reconnectar, continua aplicant-se l'abast anterior.
2. En mode d'IP i rangs, comproveu si la IP de destinació està inclosa o exclosa de la llista. No s'hi poden introduir noms de domini.
3. En mode per aplicació, tanqueu completament l'aplicació i torneu-la a iniciar des de Muddog.
4. Comproveu si la connexió és IPv6. IPv6 no passa per la VPN; en el mode per aplicació de Windows, es bloqueja l'IPv6 de l'aplicació seleccionada.
5. Si utilitzeu altres VPN o eines de gestió de xarxa, compareu també amb aquestes connexions desactivades. Les rutes d'altres eines poden tenir prioritat.

Si el navegador o la pàgina amb què consulteu la IP no estan inclosos a la VPN, és normal veure la IP habitual. El DNS també pot utilitzar la connexió habitual segons el mode i la IP del servidor DNS.

Si un lloc web continua aplicant restriccions geogràfiques, proveu un altre país o participant. Muddog no garanteix que el servei permeti l'accés ni una velocitat concreta.

A macOS, si canvieu la connexió utilitzada, com el Wi-Fi, desconnecteu la VPN i torneu-la a connectar. Si el mode d'inclusió d'IP indica un conflicte amb una ruta de host d'un altre programa, reviseu aquella connexió i les IP i els rangs especificats.

La VPN per aplicació no s'aplica

• macOS no admet VPN per aplicació. Utilitzeu tot Internet o el mode d'IP i rangs.
• Si Executa amb VPN està desactivat, comproveu que hàgiu desat el mode per aplicació, que la VPN estigui connectada amb aquell mode i que hàgiu seleccionat una aplicació.
• Si la llista està buida, utilitzeu Actualitza la llista o Cerca un executable.
• Si el navegador només reobre una finestra existent, tanqueu també els processos en segon pla abans d'executar-lo.
• No s'admeten aplicacions que deleguen l'execució en un servei independent o reutilitzen una instància existent. Comproveu la instal·lació i els requisits de la VPN per aplicació.
• A Linux no s'admeten aplicacions Snap o Flatpak. Si l'error afecta la sessió d'usuari systemd, cgroup v2 o nftables, reviseu l'entorn i incloeu els Detalls de l'error a Informar d'un problema.
• A Windows cal seleccionar el fitxer .exe. Després de reconnectar la VPN, tanqueu completament el programa i torneu-lo a executar des de Muddog.
• Si Windows indica que falta WinDivert o no es pot carregar, repareu o reinstal·leu amb l'MSI. Si persisteix, envieu els Detalls de l'error.

Les versions de l'aplicació i del servei són diferents

Un servei antic que no admet una funció sol·licitada per l'aplicació provoca un error. Actualitzeu tots dos amb el paquet nou. La manca de VPN per aplicació a macOS és una limitació de compatibilitat, no un error de versió.

Si l'error continua després d'actualitzar, reinicieu el servei segons el sistema operatiu. El reinici talla la VPN personal i les connexions de compartició en curs.

A Linux, tanqueu l'aplicació, executeu l'ordre següent i torneu-la a obrir:

sudo systemctl restart muddog-engine.service

A Windows, tanqueu l'aplicació, executeu això a PowerShell com a administrador i torneu-la a obrir:

Restart-Service -Name muddog-engine

A macOS, seleccioneu Service → Remove Background Service and Quit, torneu a obrir Muddog des de /Applications i completeu les autoritzacions necessàries.

Després de reiniciar el servei, cal reconnectar la VPN. Si l'error persisteix, informeu de la versió de l'aplicació i dels detalls de l'error en lloc de reiniciar repetidament.

Només falla la compartició o no es poden llegir els registres

Consulteu primer Comparteixo la meva connexió a Internet → Detalls de connexió. La compartició s'atura si falta espai per als registres, se supera el límit o falla l'escriptura de fitxers. Els registres segueixen el sistema de conservació local.

Comproveu l'espai del disc i els registres del servei. Si necessiteu els registres conservats, no els elimineu indiscriminadament per fer desaparèixer l'error; demaneu suport amb el missatge d'error.

Si només falla la consulta, comproveu els permisos i la versió del servei. Si el contingut ha canviat durant la consulta per una neteja dels registres diaris, torneu a seleccionar la data i els filtres i premeu Consulta. Si la consulta funciona però no hi ha resultats, reviseu la data UTC, els filtres i Registres següents.