zh Hant Installation

安裝

需要 macOS 14 或更高版本，支援 Apple Silicon 和 Intel。 Apple Silicon 請選擇一般 DMG，Intel 請選擇 Intel DMG（-intel.dmg）。安全沙盒需要 Apple Silicon 和 macOS 26 或更高版本。Liquid Glass 和控制中心需要 macOS 26；macOS 14/15 使用標準控制項。Apple Intelligence 網域建議需要 macOS 26 和可用的本機模型；Spotlight 伺服器索引需要 macOS 15。

系統要求

• macOS 14 或更高版本
• Apple Silicon / Intel。

Homebrew（推薦）

brew install --cask v2macapp/tap/v2mac

Homebrew 可跳過 Gatekeeper 提示。之後 V2Mac 會自動更新，通過 Homebrew 安裝的也一樣（見更新）。

手動下載

1. 從最新版本下載 V2Mac-<version>.dmg。每個版本還附帶 .sha256 檔案用於校驗。
2. 打開 DMG，將 V2Mac 拖到 Applications。
3. 應用未經公證，macOS 會阻止首次啓動。先打開一次，然後在 系統設定 → 隱私與安全性 中點擊 仍要打開，或運行：

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

校驗下載

V2Mac 尚未經過公證，因此 macOS 無法為 DMG 擔保。你可以自行檢查：

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

• 將結果與該版本的 .sha256 檔案以及 Homebrew cask 中的 sha256 比對。一致說明檔案在傳輸中沒有損壞或被替換。兩者來自同一次發佈，因此不能證明發佈本身是真的。
• 安裝後，codesign --verify --deep --strict /Applications/V2Mac.app 會檢查應用在構建後是否被改動。
• 應用內更新更可靠：每次更新都用 V2Mac 的更新密鑰簽名，未簽名的更新會被拒絕。

首次連線

1. 點擊 Add Subscription（⌘N），粘貼訂閱地址，或單個 vless://、vmess://、trojan://、ss://、hy2:// 連結。
2. 雙擊伺服器（或選中後按 Return）連線。
3. 將應用設定為 socks5://127.0.0.1:10808 或 http://127.0.0.1:10808，或打開 System Proxy 或 TUN。

V2Mac 常駐菜單欄。關閉窗口不會停止代理；按 ⌘Q 退出才會停止。

首次啓動時 V2Mac 會請求通知權限，見菜單欄與快捷方式。

更新

• 應用： V2Mac 每天檢查一次 GitHub，並自動安裝新版本。它在後台只下載有變化的檔案（通常不到 1 MB），並在你退出時安裝更新。更新就緒時，菜單欄圖標上會出現一個小圓點，面板和 Settings → General 會顯示 Restart Now，可立即安裝（VPN 會斷開幾秒）。圖標上的圓環表示已發現新版本但尚未下載。更新後會收到“V2Mac 已更新到 …”的通知。
• 如需自己決定，請在 Settings → General 關閉 Install updates automatically：V2Mac 將只顯示 Update Now。Check for app updates 會完全關閉檢查。
• 每次更新在安裝前都會用項目的簽名進行校驗。
• Xray 內核： Settings → Core → Check for Update。下載會校驗 SHA-256，並在替換前測試。Revert to Bundled 恢復為隨應用附帶的內核。

卸載

1. 退出 V2Mac（⌘Q），這會關閉 TUN、系統代理和 Kill Switch。
2. 如啓用了特權助手，在 Settings → General → Privileged helper 中點擊 Remove Helper。
3. 刪除 /Applications/V2Mac.app（或 brew uninstall --cask v2mac）。
4. 如需刪除資料：~/Library/Application Support/v2mac。