Home

V2Mac Wiki

V2Mac is a free, open-source menu bar client for Xray-core on macOS 26+ (Apple Silicon). Paste a subscription link, pick a server, and you get a local SOCKS5 + HTTP proxy, or turn on TUN mode to send the whole Mac through it.

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

Contents

1. Installation: requirements, Homebrew, DMG, first launch
2. Servers and Subscriptions: adding, updating, editing, favorites, latency tests
3. Connecting: proxy address, TUN mode, system proxy, kill switch, exit check, automatic server selection, WARP
4. Routing: routing modes, custom rules, per-app rules, Rule Builder, Proxifier import
5. Connections: live list of requests and the map
6. Menu Bar and Shortcuts: menu bar panel, keyboard, Shortcuts, Siri, Control Center, notifications
7. Settings Reference: every setting and its default, backup, files on disk, privacy
8. Troubleshooting and FAQ

At a glance

• Protocols: VLESS (REALITY, XTLS Vision), VMess, Trojan, Shadowsocks, Hysteria2, WireGuard, SOCKS, HTTP, and full Xray JSON configs.
• Routing: Global, Bypass regions (Iran, China, Russia), Rules Only, Direct, plus ordered Proxy / Direct / Block rules by site and by app.
• No Electron, no analytics, no telemetry.

Source, issues and releases: github.com/LordVersA/v2mac.