de Installation

Installation

Voraussetzungen

• macOS 26 oder neuer
• Apple Silicon (M1 oder neuer). Intel-Macs werden nicht unterstützt.

Homebrew (empfohlen)

brew install --cask v2macapp/tap/v2mac

Mit Homebrew entfällt die Gatekeeper-Abfrage. Danach aktualisiert sich V2Mac selbst, auch bei Installation mit Homebrew (siehe Aktualisieren).

Manueller Download

1. Laden Sie V2Mac-<version>.dmg von der neuesten Version herunter. Jede Version enthält auch eine .sha256-Datei zur Downloadprüfung.
2. Öffnen Sie das DMG und ziehen Sie V2Mac nach Programme.
3. Die App ist nicht notarisiert. macOS blockiert deshalb den ersten Start. Öffnen Sie sie einmal und klicken Sie anschließend unter Systemeinstellungen → Datenschutz & Sicherheit auf Dennoch öffnen, oder führen Sie Folgendes aus:

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

Download prüfen

V2Mac ist noch nicht notarisiert. macOS kann daher nicht für das DMG bürgen. Folgendes können Sie prüfen:

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

• Vergleichen Sie das Ergebnis mit der .sha256-Datei der Version und sha256 im Homebrew-Cask. Eine Übereinstimmung zeigt, dass die Datei unterwegs nicht beschädigt oder ausgetauscht wurde. Beide Werte stammen aus derselben Veröffentlichung und beweisen daher nicht deren Echtheit.
• Nach der Installation prüft codesign --verify --deep --strict /Applications/V2Mac.app, ob seit dem Erstellen etwas in der App verändert wurde.
• App-interne Updates bieten stärkere Absicherung: Jedes ist mit dem V2Mac-Updateschlüssel signiert. Nicht entsprechend signierte Updates werden abgelehnt.

Erste Verbindung

1. Klicken Sie auf Abonnement hinzufügen (⌘N) und fügen Sie Ihre Abonnement-URL oder einen einzelnen vless://-, vmess://-, trojan://-, ss://- oder hy2://-Link ein.
2. Doppelklicken Sie auf einen Server oder wählen Sie ihn aus und drücken Sie Return, um sich zu verbinden.
3. Stellen Sie Ihre Apps auf socks5://127.0.0.1:10808 oder http://127.0.0.1:10808 ein, oder aktivieren Sie System-Proxy oder TUN.

V2Mac bleibt in der Menüleiste. Das Schließen des Fensters lässt den Proxy weiterlaufen. Beenden Sie die App mit ⌘Q, um ihn zu stoppen.

Beim ersten Start bittet V2Mac um Erlaubnis für Mitteilungen. Siehe Menüleiste und Kurzbefehle.

Aktualisieren

• App: V2Mac prüft GitHub einmal täglich und installiert neue Versionen selbstständig. Es lädt nur geänderte Dateien im Hintergrund herunter, häufig deutlich weniger als 1 MB, und installiert beim Beenden. Solange ein Update wartet, erscheint ein kleiner Punkt am Menüleistensymbol. Das Menüleistenfenster und Einstellungen → Allgemein zeigen Jetzt neu starten, um es sofort zu installieren. Dabei unterbricht die VPN-Verbindung für einige Sekunden. Ein Ring am Symbol bedeutet, dass eine neue Version gefunden, aber noch nicht heruntergeladen wurde. Nach dem Update erscheint „V2Mac auf … aktualisiert“ als Mitteilung.
• Für manuelle Entscheidungen deaktivieren Sie Updates automatisch installieren unter Einstellungen → Allgemein. V2Mac zeigt dann nur Jetzt aktualisieren. Nach App-Updates suchen schaltet die Prüfung vollständig aus.
• Jedes Update wird vor der Installation anhand der Projektsignatur geprüft.
• Xray-Kern: Einstellungen → Kern → Nach Update suchen. Der Download wird anhand von SHA-256 geprüft und getestet, bevor er den aktuellen Kern ersetzt. Mitgelieferten Kern wiederherstellen kehrt zum Kern der App zurück.

Deinstallieren

1. Beenden Sie V2Mac (⌘Q). Dies deaktiviert TUN, System-Proxy und Kill Switch.
2. Falls Sie den privilegierten Hilfsdienst aktiviert haben, entfernen Sie ihn unter Einstellungen → Allgemein → Privilegierter Hilfsdienst → Hilfsdienst entfernen.
3. Löschen Sie /Applications/V2Mac.app oder führen Sie brew uninstall --cask v2mac aus.
4. Zum Entfernen Ihrer Daten löschen Sie auch ~/Library/Application Support/v2mac.