zh Installation

安装

系统要求

• macOS 26 或更高版本
• Apple Silicon（M1 或更新）。不支持 Intel Mac。

Homebrew（推荐）

brew install --cask lordversa/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

首次连接

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。