Solución de problemas de Muddog

Primero, compruebe en la pantalla Conexión si el problema afecta a su Conexión VPN o a Mi Internet compartido. La causa aparece en los Detalles de conexión de cada área o en Detalles del error del aviso.

Síntoma	Qué comprobar
No se puede conectar al servicio	Estado del servicio y permisos de acceso
La lista de países está vacía o falla la conexión	País y conexión con otro participante
Aparece Conectado, pero la IP no cambia o no hay acceso	Alcance de la VPN y tráfico
No se puede pulsar el botón de ejecución o la VPN no se aplica a una aplicación concreta	VPN por aplicación
Un error indica que el servicio no admite una función	Versiones de la aplicación y del servicio
Solo falla Mi Internet compartido	Uso compartido y almacenamiento de registros

No se puede conectar al servicio

La aplicación lee el estado del servicio en segundo plano y lo muestra en pantalla. Este mensaje significa que la aplicación no puede consultar el estado; no confirma que la VPN o el uso compartido estén desactivados.

Cuando el servicio vuelva a funcionar, la aplicación se reconectará automáticamente. Compruebe el estado y los permisos según su sistema operativo como se indica a continuación. Al iniciar el servicio, también se empieza a compartir Internet.

Linux

1. Si acaba de instalar, cierre la sesión del escritorio, vuelva a iniciarla y abra la aplicación.

2. Compruebe el estado del servicio en el terminal.

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

3. Si el servicio está detenido y desea volver a utilizar la VPN y compartir Internet, inícielo. El uso compartido también se reanuda al iniciarlo.

   sudo systemctl start muddog-engine.service

4. Si el servicio está en ejecución pero la aplicación no puede acceder a él, ejecute id -nG en un terminal de la cuenta que utiliza la aplicación y compruebe que aparezca el grupo muddog.

Si falta el grupo porque un administrador instaló desde otra cuenta, ejecute el siguiente comando en un terminal con la sesión del usuario normal que utilizará la aplicación. Después, cierre la sesión del escritorio y vuelva a iniciarla.

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

No sustituya este paso por ejecutar la aplicación como administrador. Si el propio servicio no se inicia, puede consultar los errores recientes con:

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

Windows

Compruebe el estado del servicio en PowerShell.

Get-Service -Name muddog-engine

Si el servicio está detenido, inícielo desde PowerShell ejecutado como administrador.

Start-Service -Name muddog-engine

Si ha deshabilitado el servicio, siga las instrucciones para volver a activar el inicio automático. Si el servicio no existe o faltan archivos necesarios, instale o repare la instalación con el MSI más reciente. Ejecute la aplicación como usuario normal.

macOS

1. Compruebe que utiliza macOS 13 o posterior y que ha copiado Muddog.app en /Applications.
2. Compruebe que la cuenta con la que ha iniciado sesión sea una cuenta de administrador de macOS.
3. Seleccione Service → Enable Background Service para solicitar el registro del servicio.
4. En Service → Background Service Settings…, autorice la ejecución de Muddog en segundo plano. Después, espere a que la aplicación vuelva a conectarse al servicio.

También puede comprobar el estado del servicio registrado desde el terminal.

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

Si ejecuta la aplicación desde el DMG o desde otra carpeta, no podrá registrar el servicio. Si el problema apareció después de sustituir la aplicación anterior, siga el procedimiento de actualización en macOS para eliminar el servicio y volver a abrir la aplicación.

Si sigue fallando después de estos pasos, incluya el error del servicio al informar del problema.

La lista de países está vacía o falla la conexión

1. Compruebe que su conexión habitual a Internet funcione.
2. Pulse País de conexión → Actualizar lista.
3. Si el país elegido ha desaparecido de la lista, utilice Selección automática u otro país.
4. Si cambió el servidor de conexión, restaure y guarde los valores predeterminados de los ajustes avanzados.
5. Si sigue fallando, consulte Detalles de conexión.

La conexión P2P depende de los participantes del país elegido y del estado de ambas redes. Que un país aparezca en la lista no garantiza la conexión. Si no hay participantes disponibles, inténtelo de nuevo más tarde o elija otro país. Para comprobar si la causa son restricciones de comunicación del cortafuegos o del router, puede comparar el resultado utilizando otra conexión a Internet disponible.

Diez es el número máximo de intentos de conexión. El proceso puede terminar antes si no encuentra otro participante. Si se pierde una conexión VPN ya establecida, debe volver a conectarse manualmente.

Aparece Conectado, pero la IP no cambia o no hay acceso

1. Compruebe que Conexión → Alcance de la conexión actual muestre el modo que desea. Si solo guardó los ajustes sin volver a conectarse, sigue aplicándose el alcance anterior.
2. En el modo de IP y rangos, compruebe si la IP de destino a la que intenta acceder está incluida o excluida de la lista. No puede introducir nombres de dominio en la lista de direcciones.
3. En el modo por aplicación, cierre por completo la aplicación y vuelva a iniciarla desde Muddog.
4. Compruebe si el acceso que está verificando utiliza IPv6. IPv6 no pasa por la VPN; en Windows, el modo por aplicación bloquea el tráfico IPv6 de las aplicaciones seleccionadas.
5. Si utiliza otra VPN o una herramienta de gestión de red al mismo tiempo, compare también el resultado con esa conexión desactivada. Las rutas configuradas por otras herramientas pueden tener prioridad.

Si el navegador o la página de consulta de IP no están dentro del alcance de la VPN, es normal que aparezca la IP de su conexión habitual. DNS también puede utilizar esa conexión según el modo seleccionado y la IP del servidor DNS.

Si persisten las restricciones geográficas de un sitio web, pruebe con otro país u otro participante. Muddog no garantiza que ese servicio permita el acceso ni una velocidad concreta.

Si ha cambiado la conexión de red que utiliza en macOS, por ejemplo la de Wi-Fi, desconecte la VPN y vuelva a conectarla. Si en el modo de inclusión de IP aparece un error por un conflicto con una ruta de host configurada por otro programa, compruebe la conexión de ese programa y las IP y los rangos indicados.

La VPN por aplicación no se aplica

• macOS no admite la VPN por aplicación. Utilice el modo de todo Internet o el de IP y rangos.
• Si Ejecutar con VPN está desactivado, compruebe que haya guardado el modo por aplicación, que la VPN esté conectada en ese modo y que haya seleccionado la aplicación que desea iniciar.
• Si la lista de aplicaciones está vacía, utilice Actualizar lista o Buscar ejecutable.
• Si el navegador solo vuelve a abrir una ventana existente, finalice también sus procesos en segundo plano antes de iniciarlo.
• No se admiten las aplicaciones que delegan su ejecución en un servicio independiente o reutilizan una instancia existente. Compruebe el método de instalación y los requisitos de la VPN por aplicación.
• En Linux, no se admiten las aplicaciones instaladas con Snap o Flatpak. Si el error está relacionado con la sesión de usuario de systemd, cgroup v2 o nftables, revise ese entorno e incluya los Detalles del error al informar del problema.
• En Windows, debe seleccionar el archivo .exe que desea ejecutar. Después de volver a conectar la VPN, cierre por completo el programa y vuelva a iniciarlo desde Muddog.
• Si en Windows aparece un error que indica que falta un componente de WinDivert o que no se puede cargar, repare o reinstale la aplicación con el MSI. Si sigue fallando, envíe los Detalles del error.

La aplicación y el servicio tienen versiones distintas

Se produce un error si se conecta a un servicio antiguo que no admite la función solicitada por la aplicación. Actualice tanto la aplicación como el servicio con el nuevo paquete. La falta de VPN por aplicación en macOS se debe a las funciones admitidas en ese sistema, no a un error de versión.

Si el mismo error persiste después de actualizar, reinicie el servicio según su sistema operativo. El reinicio interrumpe las conexiones activas de su VPN personal y del uso compartido.

En Linux, cierre la aplicación, ejecute el siguiente comando y vuelva a abrirla.

sudo systemctl restart muddog-engine.service

En Windows, cierre la aplicación, ejecute el siguiente comando en PowerShell como administrador y vuelva a abrir la aplicación.

Restart-Service -Name muddog-engine

En macOS, seleccione Service → Remove Background Service and Quit, vuelva a abrir Muddog desde /Applications y complete las autorizaciones necesarias del servicio.

Después de reiniciar el servicio, debe volver a conectar la VPN. Si el error persiste, recopile la versión de la aplicación y los detalles del error para informar del problema, en lugar de reiniciar repetidamente.

Solo falla el uso compartido o no se pueden leer los registros

Compruebe primero Mi Internet compartido → Detalles de conexión. Se deja de compartir si falta espacio para los registros, se supera el límite de almacenamiento o se produce un error al escribir los archivos. Los registros se guardan según las reglas de conservación local.

Compruebe el espacio en disco y los registros del servicio. Si necesita los registros conservados, no los borre indiscriminadamente para eliminar el error; solicite ayuda e incluya el mensaje de error.

Si solo falla la consulta de registros, compruebe los permisos de acceso y la versión del servicio. Si la limpieza de los registros por fecha ha cambiado el contenido durante la consulta, vuelva a seleccionar la fecha y los filtros y pulse Consultar. Si la consulta termina correctamente pero no muestra resultados, compruebe la fecha UTC, los filtros y Siguientes registros.