V2Mac

A native macOS client for Xray-core and V2Ray.
VLESS, REALITY, VMess, Trojan, Shadowsocks, Hysteria2 and WireGuard in a fast SwiftUI menu bar app for Apple Silicon.

English | فارسی | 简体中文 | Русский

Install · Features · Website · Documentation · Build

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

Per-app and per-site rules	Every connection and the rule behind it
Countries on the map	Proxifier import

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.

_{If V2Mac helps you, a ⭐ helps others find it.}