Resolução de problemas do Muddog

Comece por verificar no ecrã Ligação se o problema está na Ligação VPN ou na Partilha da minha Internet. A causa aparece nos respetivos Detalhes da ligação ou nos Detalhes do erro da notificação de erro.

Sintoma	O que verificar
Não é possível ligar ao serviço	Estado do serviço e permissões de acesso
Lista de países vazia ou falha na ligação	País e ligação ao participante remoto
Aparece Ligado, mas o IP não muda ou não há acesso	Âmbito da VPN e tráfego
Botão de execução desativado ou VPN não aplicada a determinada aplicação	VPN por aplicação
Erro a indicar que o serviço não suporta uma funcionalidade	Versões da aplicação e do serviço
Apenas a partilha da minha Internet falha	Partilha e armazenamento de registos

Não é possível ligar ao serviço

A aplicação lê o estado do serviço em segundo plano e apresenta-o no ecrã. Esta mensagem significa que a aplicação não consegue verificar o estado, e não que a VPN ou a partilha estejam necessariamente desligadas.

Quando o serviço voltar ao normal, a aplicação volta a ligar-se automaticamente. Verifique abaixo o estado e as permissões para o seu sistema operativo. Ao iniciar o serviço, a partilha da Internet também começa.

Linux

1. Se acabou de instalar, termine a sessão do ambiente de trabalho, volte a iniciá-la e abra a aplicação.

2. Verifique o estado do serviço no terminal.

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

3. Se o serviço estiver parado e quiser voltar a usar a VPN e a partilha, inicie-o. A partilha da Internet também é retomada quando o serviço arranca.

   sudo systemctl start muddog-engine.service

4. Se o serviço estiver em execução, mas a aplicação não lhe conseguir aceder, execute id -nG num terminal da conta que usa a aplicação e verifique se o grupo muddog aparece.

Se o grupo estiver em falta porque um administrador instalou o programa com outra conta, execute o seguinte comando num terminal com sessão iniciada como o utilizador normal que irá usar a aplicação. Depois, termine a sessão do ambiente de trabalho e volte a iniciá-la.

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

Não substitua este procedimento pela execução da aplicação como administrador. Se o próprio serviço não arrancar, pode consultar os erros recentes com:

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

Windows

Verifique o estado do serviço no PowerShell.

Get-Service -Name muddog-engine

Se o serviço estiver parado, inicie-o no PowerShell aberto como administrador.

Start-Service -Name muddog-engine

Se tiver desativado o serviço, siga as instruções para reativar o arranque automático. Se o serviço não existir ou faltarem ficheiros necessários, instale ou repare a instalação com o MSI mais recente. Execute a aplicação como utilizador normal.

macOS

1. Confirme que utiliza macOS 13 ou posterior e que copiou Muddog.app para /Applications.
2. Confirme que a conta com sessão iniciada é uma conta de administrador do macOS.
3. Selecione Service → Enable Background Service para solicitar o registo do serviço.
4. Em Service → Background Service Settings…, autorize a execução do Muddog em segundo plano. Após a autorização, aguarde que a aplicação volte a ligar-se ao serviço.

Também pode verificar o estado do serviço registado no terminal.

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

Se executar a aplicação a partir do DMG ou de outra pasta, não poderá registar o serviço. Se o problema surgiu após substituir a aplicação existente, siga o procedimento de atualização do macOS para remover o serviço e voltar a abrir a aplicação.

Se a falha persistir após estes passos, inclua o erro do serviço ao comunicar o problema.

Lista de países vazia ou falha na ligação

1. Verifique se tem acesso normal à Internet.
2. Prima País de ligação → Atualizar lista.
3. Se o país selecionado tiver desaparecido da lista, ligue com Seleção automática ou escolha outro país.
4. Se alterou o servidor de ligação, reponha os valores predefinidos das definições avançadas e guarde.
5. Se a falha persistir, consulte os Detalhes da ligação.

A ligação P2P depende dos participantes no país escolhido e das condições das redes de ambos os lados. A presença de um país na lista não garante uma ligação. Se não houver participantes disponíveis, tente novamente mais tarde ou escolha outro país. Para verificar se a causa são restrições de comunicação da firewall ou do router, pode comparar o funcionamento noutra ligação à Internet disponível.

O máximo de 10 refere-se ao limite de tentativas de ligação. O processo pode terminar antes se não encontrar um participante. Se uma VPN já ligada perder a ligação, terá de voltar a ligá-la manualmente.

Aparece Ligado, mas o IP não muda ou não há acesso

1. Verifique se Ligação → Âmbito da ligação atual corresponde ao modo pretendido. Se apenas guardou as definições sem voltar a ligar, o âmbito anterior continua em vigor.
2. Nos modos de IPs e intervalos, confirme se o IP de destino a que pretende aceder está incluído ou excluído na lista. Não pode adicionar nomes de domínio à lista de endereços.
3. No modo por aplicação, feche completamente a aplicação e volte a executá-la a partir do Muddog.
4. Verifique se a ligação que está a testar usa IPv6. O IPv6 não passa pela VPN. No Windows, o modo por aplicação bloqueia as comunicações IPv6 das aplicações selecionadas.
5. Se estiver a usar outra VPN ou uma ferramenta de gestão de rede, compare também com essa ligação desligada. As rotas definidas por outras ferramentas podem ter prioridade.

Se o navegador ou a página de verificação do IP não estiver abrangido pela VPN, é normal ver o IP da ligação habitual. O DNS também pode usar a ligação habitual, consoante o modo selecionado e o IP do servidor DNS.

Se um site continuar a aplicar restrições por país, experimente outro país ou outro participante remoto. O Muddog não garante que esse serviço permita o acesso nem uma determinada velocidade.

No macOS, se mudou a ligação em uso, como a rede Wi-Fi, desligue a VPN e volte a ligar. Se, no modo de inclusão de IPs, aparecer um erro de conflito com uma rota de anfitrião definida por outro programa, verifique a ligação desse programa e os IPs e intervalos indicados.

A VPN por aplicação não é aplicada

• O macOS não suporta VPN por aplicação. Utilize o modo de toda a Internet ou um modo de IPs e intervalos.
• Se Executar através da VPN estiver desativado, confirme que guardou o modo por aplicação, que ligou à VPN nesse modo e que selecionou uma aplicação.
• Se a lista de aplicações estiver vazia, use Atualizar lista ou Procurar executável.
• Se o navegador apenas reabrir uma janela existente, termine também os seus processos em segundo plano antes de o executar.
• Não são suportadas aplicações que deleguem a execução num serviço separado ou reutilizem uma instância existente. Verifique a forma de instalação e os requisitos da VPN por aplicação.
• No Linux, não são suportadas aplicações Snap ou Flatpak. Se o erro estiver relacionado com a sessão de utilizador systemd, cgroup v2 ou nftables, verifique esse ambiente e inclua os Detalhes do erro ao comunicar o problema.
• No Windows, tem de selecionar o ficheiro .exe a executar. Depois de voltar a ligar a VPN, feche completamente o programa e volte a executá-lo a partir do Muddog.
• No Windows, se aparecer um erro a indicar que os componentes WinDivert estão em falta ou não podem ser carregados, repare ou reinstale com o MSI. Se a falha persistir, comunique os Detalhes do erro.

A aplicação e o serviço têm versões diferentes

Ocorre um erro se a aplicação se ligar a um serviço antigo que não suporte a funcionalidade solicitada. Atualize a aplicação e o serviço em conjunto com o novo pacote. A indisponibilidade da VPN por aplicação no macOS resulta das funcionalidades suportadas nessa plataforma, não de um erro de versão.

Se o mesmo erro persistir após a atualização, reinicie o serviço de acordo com o seu sistema operativo. Reiniciar interrompe as ligações VPN pessoais e de partilha em curso.

No Linux, feche a aplicação, execute o seguinte comando e volte a abri-la.

sudo systemctl restart muddog-engine.service

No Windows, feche a aplicação, execute o seguinte comando no PowerShell como administrador e volte a abrir a aplicação.

Restart-Service -Name muddog-engine

No macOS, selecione Service → Remove Background Service and Quit, volte a abrir o Muddog em /Applications e conclua as autorizações necessárias para o serviço.

Depois de reiniciar o serviço, tem de voltar a ligar à VPN. Se o erro persistir, comunique a versão da aplicação e os detalhes do erro em vez de reiniciar repetidamente.

Só a partilha da Internet falha ou não é possível ler os registos

Comece por consultar Partilha da minha Internet → Detalhes da ligação. A partilha para se faltar espaço para os registos, se o limite de armazenamento for ultrapassado ou se ocorrer um erro de escrita. Os registos são guardados de acordo com as regras de conservação local.

Verifique o espaço em disco e os registos do serviço. Se precisar dos registos conservados, não os elimine indiscriminadamente para remover o erro; peça apoio e inclua a mensagem de erro.

Se apenas a consulta dos registos falhar, verifique as permissões de acesso e a versão do serviço. Se o conteúdo mudou durante a consulta devido à limpeza dos registos por data, volte a selecionar a data e os filtros e prima Consultar. Se a consulta for bem-sucedida, mas não apresentar resultados, verifique a data UTC, os filtros e Registos seguintes.