ROAMSWITCH · UNINSTALL

Desinstalar o RoamSwitch

Antes de se remover, o RoamSwitch desfaz todas as alterações que fez à rede. Apagar apenas a app pode deixar regras de firewall, o bloqueio ARP do gateway e substituições de DNS, e a ligação pode ficar cortada.

Versões
A função de desinstalação está incluída a partir da versão 1.10.7 no Linux e 1.10.5 no Mac. As versões anteriores não têm o item Desinstalar.

1. O que acontece

A desinstalação segue a ordem abaixo. Cada passo é independente: se um falhar, os restantes são executados na mesma e, no fim, os resultados são listados.

  1. Desfazer as alterações feitas à rede. O isolamento Air-Gap, as regras de firewall, os kill switches de VPN e Tailscale, os bloqueios automáticos de análise de portas, o bloqueio ARP do gateway e as substituições de DNS são repostos. No Mac, os serviços que o RoamSwitch tinha parado (SSH, partilha de ficheiros, partilha de ecrã) também são reiniciados.
  2. Parar e anular o registo dos serviços. No Linux, os serviços e temporizadores do systemd. No Mac, o assistente com privilégios e os seus dois serviços auxiliares, o item de início de sessão e a extensão do sistema (proteção de ligações).
  3. Remover os ficheiros isco colocados. Os ficheiros ocultos de deteção de ransomware e os iscos de credenciais (como ~/.aws/credentials) são apagados. Só são removidos os ficheiros com a marca do RoamSwitch; um ficheiro real no mesmo caminho, ou uma ligação simbólica, não é tocado.
  4. Remover o que a instalação adicionou. No Linux, o hook do apt e os ficheiros de configuração do Falco e do logrotate. No Mac, os aliases da shell para npm e pnpm (só essas linhas são removidas).
  5. Remover o programa. No Linux, através do gestor de pacotes (apt, dnf, zypper ou pacman), ou apagando diretamente os ficheiros se foi instalado por tarball. No Mac, a app é movida para o Lixo (não é apagada, por isso pode ser recuperada).

2. No Mac

No ícone do RoamSwitch na barra de menus, escolha «🧰 Recuperação e desinstalação» → «🗑 Desinstalar o RoamSwitch…».

A janela de confirmação mostra o MAC atual do gateway e o MAC de confiança. Se forem diferentes, ou se não for possível confirmar que a causa de um isolamento desapareceu, pode estar em curso um ataque; o botão Desinstalar fica desativado até assinalar «Compreendo o risco acima e quero continuar». Se possível, mude primeiro para outra rede, por exemplo com partilha de ligação.

«Eliminar também as definições, o histórico e as informações da licença» está desativado por predefinição. Se ficar desativado, ~/Library/Application Support/RoamSwitch (ameaças em quarentena, histórico) e as informações da licença são mantidos, e uma reinstalação posterior aproveita-os. Se ativado, esses dados, as definições e tudo o que o assistente com privilégios guardava também são apagados.

Se utilizava a extensão do sistema (proteção de ligações), as Definições do Sistema podem pedir-lhe que aprove a sua remoção. A remoção conclui-se depois de a aprovar. Mesmo que não seja pedida aprovação, a remoção fica agendada assim que a app é eliminada e conclui-se no próximo reinício do Mac.

Por fim, a app é movida para o Lixo e o RoamSwitch fecha. Ao esvaziar o Lixo, a própria app é removida. Os resultados são mostrados numa lista, com o motivo de cada passo que tenha falhado.

3. No Linux

A partir do ambiente de trabalho (tabuleiro)

No ícone do tabuleiro, escolha «🧰 Recuperação e desinstalação» → «🗑 Desinstalar o RoamSwitch…». A janela de confirmação funciona como no Mac (se houver risco, é necessária uma confirmação, e «Eliminar também as definições, o estado e o histórico» está desativado por predefinição). Depois de premir Desinstalar, é pedida a palavra-passe de administrador (polkit) e a app fecha quando terminar.

A partir da linha de comandos

sudo roamswitch uninstall
sudo roamswitch uninstall --purge
sudo roamswitch uninstall --yes

Com --purge, as definições, o estado e o histórico também são apagados. Com --yes, a pergunta é omitida quando não há dúvidas. Sem nenhuma das duas, as definições e o histórico são mantidos.

Se o gateway não corresponder ao de confiança, ou se não for possível confirmar que a causa de um isolamento desapareceu, é mostrado um aviso e nada avança até escrever UNINSTALL. Sem terminal (num script, por exemplo), não altera nada e termina com o código 2, a menos que aceite o risco e adicione --force.

Com o gestor de pacotes

sudo apt remove roamswitch
sudo apt purge roamswitch
sudo dnf remove roamswitch
sudo zypper remove roamswitch
sudo pacman -R roamswitch

apt purge apaga também as definições, o estado e o histórico (apt remove mantém-nos). Com dnf, zypper e pacman, as definições e o histórico são mantidos.

Mesmo antes de o pacote ser removido, executam-se automaticamente a mesma recuperação de rede, a paragem dos serviços e a remoção dos ficheiros isco. Esta via não pede confirmação: depois de o pacote desaparecer, nada gere a rede, por isso dá-se prioridade a evitar uma ligação que fique cortada. Numa instalação por tarball, roamswitch uninstall apaga diretamente os ficheiros.

A entrada do repositório apt (/etc/apt/sources.list.d/roamswitch.list) e a respetiva chave de assinatura ficam como estão. Apague-as manualmente se não as quiser.

4. O que fica e o que nunca é tocado

  • O software que instalou separadamente, como ClamAV, nftables, Falco, Tailscale e as ferramentas do WireGuard, não é removido.
  • Um ficheiro real no caminho de um isco que não tenha a marca do RoamSwitch não é apagado.
  • As definições, o estado e o histórico são mantidos, a menos que escolha --purge no Linux (apt purge com o apt) ou assinale a caixa na janela de confirmação no Mac.

5. Se não houver ligação depois

No primeiro passo, são desfeitas todas as alterações que podem parar o tráfego. Se mesmo assim não houver ligação, volte a ligar o Wi-Fi ou o cabo para renovar a concessão DHCP. Antes de remover o RoamSwitch, essa mesma recuperação pode ser executada isoladamente: sudo roamswitch emergency-restore no Linux, ou «🧰 Recuperação e desinstalação» → «🆘 Recuperar a rede agora…» no menu do Mac.