Instalação e atualização do Muddog

Requisitos

Na página de transferências, confirme o sistema operativo e a versão antes de descarregar o ficheiro de instalação.

Sistema operativo	Formato disponível e instruções
Linux x86_64	Pacotes .deb e .rpm. É necessário um ambiente de trabalho que utilize systemd.
Windows 10/11 x64	Instalador .msi. Atualmente, o pacote para Windows suporta apenas x64.
macOS 13 Ventura ou posterior	Instalador .dmg. O pacote Universal suporta Intel e Apple Silicon. É necessária uma conta de administrador do macOS para controlar a aplicação.

O gestor de pacotes Linux instala também as bibliotecas e dependências necessárias à aplicação. A VPN por aplicação no Linux requer ainda uma sessão de utilizador systemd e cgroup v2. O nftables está incluído nas dependências do pacote. O Windows também suporta VPN por aplicação; o macOS suporta VPN para toda a Internet e por IPs e intervalos.

Este manual destina-se à versão 2.x. Se a página de transferências ainda não apresentar um ficheiro 2.x para o seu sistema operativo, confirme primeiro se já está disponível. Para o ficheiro .exe da versão 1.0.7 para Windows, siga o guia da versão anterior.

A partilha começa quando o serviço arranca

No Linux e no Windows, a partilha da Internet começa automaticamente após a instalação; no macOS, após a primeira execução e a autorização do serviço em segundo plano. A partir daí, o serviço também arranca com o computador. Outros utilizadores podem usar a sua ligação à Internet mesmo sem abrir a janela da aplicação. Antes de instalar, consulte Gerir a partilha da Internet.

Instalar no Linux

Os comandos abaixo usam nomes de ficheiros da versão 2.0.0 como exemplo. No terminal, aceda à pasta onde está o ficheiro descarregado e substitua o nome do ficheiro pelo nome do pacote que recebeu antes de executar o comando. A instalação requer privilégios de administrador.

Debian / Ubuntu

sudo apt install ./muddog_2.0.0_amd64.deb

Fedora

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

Primeira execução após a instalação

1. Após a instalação, termine a sessão do ambiente de trabalho e volte a iniciá-la.
2. Abra o Muddog no menu de aplicações.
3. Confirme que o ecrã Ligação apresenta o estado da VPN e da Partilha da minha Internet.
4. Siga Ligar à VPN para escolher um país e estabelecer a ligação.

Quando instala com sudo a partir de uma conta de utilizador normal, esse utilizador é adicionado ao grupo muddog. É necessário iniciar sessão novamente para que a aplicação tenha essa permissão. Execute a aplicação como utilizador normal; não é necessário introduzir um ID Mudfish ou uma palavra-passe para usar a VPN.

Se um administrador instalou o programa com outra conta, ou se vários utilizadores precisam de controlar a aplicação, consulte a verificação das permissões de acesso ao serviço.

Instalar no Windows

1. Se tiver o Muddog instalado com o antigo instalador .exe, remova-o primeiro em Definições → Aplicações do Windows. Se lhe for pedido que remova a instalação anterior, conclua a remoção e volte a executar o instalador MSI.
2. Execute o ficheiro .msi descarregado e autorize o pedido de privilégios de administrador.
3. Siga as instruções de instalação. Se o WebView2 Runtime não estiver instalado, o assistente descarrega-o da Internet, pelo que é necessária uma ligação à Internet.
4. Abra o muddog no menu Iniciar ou no ambiente de trabalho como utilizador normal.
5. Verifique o estado do serviço no ecrã Ligação e siga Ligar à VPN.

A localização de instalação predefinida é %ProgramFiles%\muddog. O instalador regista e inicia automaticamente o serviço muddog-engine e adiciona a regra de firewall para o tráfego UDP de entrada necessário ao motor. Os componentes necessários à VPN e à VPN por aplicação estão incluídos no pacote. Não é necessário executar a aplicação como administrador sempre que a utiliza.

Instalar no macOS

1. Abra o ficheiro .dmg descarregado.
2. Copie Muddog.app para a pasta Aplicações (/Applications). Se executar a aplicação diretamente a partir do DMG, não poderá registar o serviço em segundo plano.
3. Com sessão iniciada numa conta de administrador do macOS, abra o Muddog que copiou.
4. Em Definições do Sistema → Geral → Itens de início de sessão e extensões, autorize a execução do Muddog em segundo plano. Os nomes das opções podem variar consoante a versão do macOS.
5. Quando a aplicação voltar a ligar-se ao serviço, siga Ligar à VPN.

Para voltar a abrir o ecrã de autorização, selecione Service → Background Service Settings… na barra de menus do macOS. Se precisar de registar o serviço, selecione Service → Enable Background Service. Os nomes destes menus aparecem em inglês. Execute a aplicação sem sudo.

Atualizar

Se estiver a utilizar a VPN, prima Desligar e descarregue o novo instalador para o seu sistema operativo na página de transferências.

• Linux: feche a aplicação e instale o novo ficheiro .deb ou .rpm com o comando indicado acima, usando o novo nome de ficheiro.
• Windows: feche a aplicação e execute o novo ficheiro .msi. A instalação MSI existente é substituída durante a atualização.
• macOS: selecione primeiro Service → Remove Background Service and Quit para remover o serviço e fechar a aplicação. Substitua a aplicação em /Applications pela Muddog.app do novo DMG, volte a abri-la e conclua as autorizações necessárias para o serviço.

A atualização interrompe as ligações VPN e de partilha em curso. Após a atualização, volte a abrir a aplicação e verifique o estado da ligação e da partilha. Se aparecer um erro a indicar que a aplicação e o serviço têm versões diferentes, consulte a resolução de problemas.

Para mudar da versão anterior 1.0.7 no Linux, feche a aplicação antiga e instale o novo pacote. Se o serviço antigo muddog_srv.service estiver registado, o instalador para-o e desativa o seu arranque automático. A partir daí, abra o Muddog no menu de aplicações.

Remover

Linux

No Debian / Ubuntu, utilize o seguinte comando:

sudo apt remove muddog

No Fedora, utilize o seguinte comando:

sudo dnf remove muddog

A remoção do pacote termina o serviço e a VPN e remove as rotas de rede adicionadas pelo Muddog. No Debian / Ubuntu, para remover também a conta e o grupo dedicados ao serviço, pode usar sudo apt purge muddog em vez da remoção normal.

Windows

Em Definições → Aplicações do Windows, selecione muddog e remova-o. A remoção termina o serviço e a VPN, limpa as rotas VPN e elimina o serviço e as regras de firewall adicionadas durante a instalação. As definições do utilizador e os registos de acesso e retransmissão são conservados.

macOS

1. Na aplicação, selecione Service → Remove Background Service and Quit.
2. Quando a remoção do serviço e o encerramento da aplicação terminarem, mova Muddog.app de /Applications para o Lixo.

Se eliminar primeiro apenas o ficheiro da aplicação, a limpeza dos itens em segundo plano pode demorar. As definições do utilizador e os registos de acesso e retransmissão são conservados.

Registos restantes e paragem da partilha

Remover o pacote não é o mesmo que eliminar os registos de acesso e retransmissão. Consulte a localização e a forma de conservação dos registos locais restantes em Registos de acesso e retransmissão. Para manter o programa e apenas parar a partilha, pode parar o serviço, mas também não poderá usar a sua VPN enquanto o serviço estiver parado.