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
Requires macOS 26 or later on Apple Silicon.
brew install --cask v2macapp/tap/v2mac
Or download the DMG from the latest release. It is not notarized: on first launch use Open Anyway in System Settings → Privacy & Security. Details in the installation guide. After that V2Mac updates itself: it downloads only the files that changed and installs them when you quit.
Quick start: click Add Subscription and paste your link, double-click a server, then use 127.0.0.1:10808 (SOCKS5 / HTTP) or switch on System Proxy or TUN.
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. 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. English, Persian, Chinese and Russian.
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 |
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
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.
