The Ultimate Beginner's Guide to V2RayU on macOS

V2RayU is a simple, user-friendly V2Ray/Xray client for Mac. If you want a straightforward way to use VLESS or VMess on macOS, V2RayU is an excellent choice. This tutorial will get you up and running in minutes—no advanced configuration required.

Step 1 — Download and Install V2RayU

From the Official GitHub Page

Always download from the official releases page for integrity.

Download the .dmg suitable for your Mac chip:
- Intel: V2RayU-64.dmg
- Apple Silicon: V2RayU-arm64.dmg

Installation

Open the downloaded .dmg file.
Drag the V2RayU icon into the Applications folder.
If Gatekeeper blocks the app, go to System Settings → Privacy & Security and allow it.

Step 2 — Import Your Proxy Servers (Nodes)

Method A: Import via Subscription Link (Recommended)

Copy your subscription URL provided by your service.
Click the V2RayU icon in your menu bar → choose Subscription setting.
Click +, paste your URL into the url field, add a remarks name, and click OK.
Back in the menu, click Update subscription to fetch the server list.

Method B: Import from Clipboard (Single Server)

Copy a single vless:// or vmess:// URL.
Click the V2RayU icon in your menu bar → Import vmess/vless link from clipboard.

Step 3 — Activate the Proxy and Choose a Server

1) Turn On V2RayU

Click the menu bar icon and toggle Turn V2Ray-Core On to start routing traffic.

2) Select Your Server

Open the Server list and pick a node with normal latency and stable performance.

3) Choose Your Proxy Mode (PAC vs. Global)

PAC Mode (Recommended): Only foreign/blocked sites go through the proxy. V2RayU generates and updates the PAC file automatically.
Global Mode: All traffic on your Mac goes through the selected proxy.
Manual Mode: For advanced users who prefer manual OS proxy configuration.

Troubleshooting

Subscription update failed or shows 0 servers: Verify the URL is correct and reachable; ensure V2Ray-Core is turned on; try clicking “Update” once in Subscription setting.

IP hasn’t changed after turning it on: Make sure you not only turned on V2Ray-Core but also selected a specific server from the Server list. Confirm Proxy Mode is set to PAC or Global.

Need a Fast, Working Route?

Use our smart proxy finder to scan and recommend fast, available routes for your region.

Launch a Scan