The corresponding client on Mac is v2rayU. It has no main window, all operations are in That little icon at the top of the menu bar It's done in the drop-down menu, but it's very easy once you get used to it. This article covers installation, passing Gatekeeper prompts, importing nodes, and mode switching.
1Installation and handling of "Corrupted/Unable to Open"
Download .dmg Then double-click and drag V2rayU into "Applications". When you open macOS for the first time, you may be intercepted, prompting "Comes from an unidentified developer" or "Corrupted and cannot be opened" - this is Gatekeeper's normal interception of unsigned applications, not really damaged:
- Unidentified developer: Go to "System Settings → Privacy & Security", there will be a "Open Anyway" button at the bottom, click it. Or right-click V2rayU in "Applications" → "Open".
- Prompt "Corrupted": Open "Terminal" and execute
xattr -cr /Applications/V2rayU.appRemove the isolation attribute and open it again.
Why is this happening? Applications downloaded from the Internet will be marked as "quarantined" by macOS. Most open source software does not have Apple's signature certificate, so this prompt will be triggered. After removing the isolation attribute, it can be used normally.
2Get to know menu bar icons
After startup, the screen Menu bar in the upper right corner A small V2rayU icon (a V) will appear. Click it to pop up a drop-down menu. This is the entire operation center of v2rayU: importing nodes, switching modes, viewing nodes, and opening settings are all here.
3Import nodes and subscriptions
- Share link: Copy first
vmess:///vless://link, click "Import Server from Clipboard" in the menu. - QR code: Click "Scan QR code to import" and a screenshot will be taken to identify the node QR code on the screen.
- Subscription address: Click "Subscription Settings", fill in the subscription URL and save it, then click "Update Subscription" to pull the node.
After importing, you can see the node list in the "Server" sub-item of the menu. Click one to select it as the current node.
4PAC mode or global mode?
You can switch between two modes directly in the menu, and the logic is the same as the Windows side:
- PAC mode (recommended): Divide according to rules, domestic direct connection, overseas agent, use this daily.
- Global mode: All traffic goes through the proxy, and when you encounter a site that cannot be opened under PAC, it will be cut off.
These two concepts are completely similar to v2rayN. If you want to understand more, take a look. Detailed explanation of proxy mode.
Remember to turn off the agent before exiting: When not in use, switch the mode back to "off" in the menu or exit v2rayU, otherwise the system agent will always hang and may affect other network applications.
If you also want global takeover or multi-protocol support like Tun on Mac, you can learn about a more complete desktop client solution; for protocol concepts, see Protocol differences.