pt Installation

Instalação

Requisitos

• macOS 26 ou posterior
• Apple Silicon (M1 ou posterior). Os Macs Intel não são suportados.

Homebrew (recomendado)

brew install --cask v2macapp/tap/v2mac

O Homebrew evita o aviso do Gatekeeper. Depois, o V2Mac atualiza-se automaticamente, mesmo quando instalado com Homebrew (consulte Atualização).

Transferência manual

1. Transfira V2Mac-<version>.dmg da versão mais recente. Cada versão inclui um ficheiro .sha256 para verificar a transferência.
2. Abra o DMG e arraste V2Mac para Aplicações.
3. A aplicação não está notarizada, pelo que o macOS bloqueia o primeiro arranque. Tente abri-la uma vez e clique em Abrir mesmo assim em Definições do sistema → Privacidade e segurança, ou execute:

   xattr -dr com.apple.quarantine /Applications/V2Mac.app

Verificar uma transferência

O V2Mac ainda não está notarizado, pelo que o macOS não pode garantir a autenticidade do DMG. Pode verificar o seguinte:

shasum -a 256 ~/Downloads/V2Mac-<version>.dmg

• Compare o resultado com o ficheiro .sha256 da versão e com sha256 no cask Homebrew. Se corresponder, o ficheiro não foi danificado ou substituído durante a transferência. Ambos vêm da mesma versão, pelo que isto não prova que a própria versão seja autêntica.
• Após instalar, codesign --verify --deep --strict /Applications/V2Mac.app verifica se algum conteúdo da aplicação foi alterado depois da compilação.
• As atualizações na aplicação oferecem uma garantia mais forte: cada uma é assinada com a chave de atualização do V2Mac e a aplicação recusa atualizações sem essa assinatura.

Primeira ligação

1. Clique em Adicionar subscrição (⌘N) e cole o URL da subscrição ou uma ligação vless://, vmess://, trojan://, ss:// ou hy2://.
2. Faça duplo clique num servidor (ou selecione-o e prima Return) para ligar.
3. Configure as aplicações para usar socks5://127.0.0.1:10808 ou http://127.0.0.1:10808, ou ative Proxy do sistema ou TUN.

O V2Mac permanece na barra de menus. Fechar a janela mantém o proxy em execução; saia com ⌘Q para o parar.

No primeiro arranque, o V2Mac pede autorização para mostrar notificações. Consulte Barra de menus e atalhos.

Atualização

• Aplicação: o V2Mac consulta o GitHub uma vez por dia e instala novas versões automaticamente. Transfere em segundo plano apenas os ficheiros alterados (frequentemente muito menos de 1 MB) e instala a atualização quando sair. Enquanto houver uma atualização pendente, aparece um pequeno ponto no ícone da barra de menus; o painel e Definições → Geral mostram Reiniciar agora para instalar imediatamente (a VPN interrompe-se durante alguns segundos). Um anel no ícone indica que foi encontrada uma versão, mas ainda não foi transferida. Após a atualização, recebe a notificação «V2Mac atualizado para …».
• Para decidir manualmente, desative Instalar atualizações automaticamente em Definições → Geral: o V2Mac passa a mostrar apenas Atualizar agora. Procurar atualizações da aplicação desativa completamente a verificação.
• Todas as atualizações são verificadas através da assinatura do projeto antes de instalar qualquer ficheiro.
• Núcleo Xray: Definições → Núcleo → Procurar atualização. A transferência é verificada através do SHA-256 e testada antes de substituir o núcleo atual. Voltar ao núcleo incluído repõe o núcleo fornecido com a aplicação.

Desinstalação

1. Saia do V2Mac (⌘Q). Isto desativa o TUN, o proxy do sistema e o bloqueio de emergência.
2. Se ativou o auxiliar com privilégios, remova-o em Definições → Geral → Auxiliar com privilégios → Remover auxiliar.
3. Elimine /Applications/V2Mac.app (ou execute brew uninstall --cask v2mac).
4. Para remover também os dados: ~/Library/Application Support/v2mac.