Paste a subscription link, pick a server, and you have a local SOCKS5 + HTTP proxy, or turn on TUN mode to send the whole Mac through it. V2Mac is a free, open-source v2rayN / V2RayX alternative for macOS, written natively in SwiftUI with Liquid Glass. No Electron, no analytics, no telemetry.
Install
Or install with Homebrew, which picks the right build for your Mac:
brew install --cask v2macapp/tap/v2mac
[!NOTE]
V2Mac is not notarized yet, so macOS blocks the first launch. Open System Settings → Privacy & Security and click Open Anyway. Details in the installation guide.
From then on V2Mac keeps itself up to date: it downloads only the files that changed and installs them when you quit. Earlier versions are on the Releases page.
Quick start
- Click Add Subscription and paste your link.
- Double-click a server to connect.
- Point your apps at
127.0.0.1:10808 (SOCKS5 and HTTP), or turn on System Proxy or TUN to route the whole Mac.
Requirements
| Apple Silicon | Intel |
|---|
| V2Mac (macOS 14 Sonoma or later) | ✓ | ✓ |
| Spotlight server search (macOS 15 or later) | ✓ | ✓ |
| Liquid Glass and Control Center (macOS 26) | ✓ | ✓ |
| Apple Intelligence domain suggestions (macOS 26) | ✓ | — |
| Secure Sandbox (macOS 26) | ✓ | — |
On macOS 14 and 15 the app uses standard controls in place of Liquid Glass.
Features
- Protocols: VLESS (REALITY, XTLS Vision), VMess, Trojan, Shadowsocks, Hysteria2, WireGuard, SOCKS, HTTP and full Xray JSON configs.
- Subscriptions: auto-update, usage and expiry, favorites, QR and one-click import, a full server editor.
- Connection: real-delay and speed tests, automatic server selection, live switching without a restart, exit country in the menu bar.
- Whole-Mac modes: TUN, system proxy and a pf-based kill switch.
- Routing: Global, Bypass regions (Iran, China, Russia), Rules Only and Direct, plus Proxy / Direct / Block rules by site and by app.
- Proxifier alternative: per-app rules with "Only when" conditions, rules via another server or group,
.ppx profile import and a live Connections view.
- Cloudflare WARP: as its own server or chained behind yours.
- Secure Sandbox (beta): run apps in mini VMs, each with its own server and fail-closed, every app as its own Mac app. A mini VM is a set of containers that share one Linux kernel, inside one VM that has no network device. Downloaded only when you first open it.
- macOS: menu bar panel, Shortcuts, Siri, Spotlight, Control Center, a desktop widget, Apple Intelligence domain suggestions, Touch ID, notifications, backup and restore. Available in 13 interface languages.
Screenshots
Documentation
The V2Mac Wiki covers everything in detail:
| |
|---|
| Installation | Homebrew, DMG, first launch, updates |
| Servers and Subscriptions | Adding, updating, editing, latency tests |
| Connecting | TUN, system proxy, kill switch, exit check, WARP |
| Routing | Modes, the Rules window, Via servers, Proxifier import |
| Connections | Live connection list |
| Secure Sandbox | Mini VMs, sandbox apps, exits, store |
| Menu Bar and Shortcuts | Panel, keyboard, Shortcuts, notifications |
| Settings Reference | Every setting, backup, privacy |
| Troubleshooting and FAQ | Common problems and questions |
| Known Limitations | What each mode covers and what it does not; how to report a vulnerability |
For leak protection in Chrome, pair V2Mac with noleaker, a free extension from the same author.
Build from source
Scripts/fetch-core.sh
xcodegen generate
xcodebuild -project v2mac.xcodeproj -scheme v2mac -configuration Debug build
For an Intel Debug build, fetch the core with ARCH=x86_64 Scripts/fetch-core.sh and add ARCHS=x86_64 to xcodebuild. Package an Intel DMG with ARCH=x86_64 Scripts/make-dmg.sh.
Needs Xcode 26+ and XcodeGen. Design: docs/SPEC.md. Tests: cd Packages/V2MacCore && swift test. Bug reports and pull requests are welcome in Issues.
License
GPL-3.0. Bundles Xray-core (MPL-2.0); see THIRD_PARTY.md.
