macOS Setup

Complete guide for configuring proxy clients on macOS system

This guide will help you select and configure the appropriate proxy client on macOS. We recommend using ClashX or V2RayU.

Recommended Clients

Here are the recommended proxy clients for macOS:

ClashX (Recommended)

ClashX is the most popular proxy client on macOS, supporting rule-based routing and policy groups.

Clean interface, intuitive operation

Rule-based routing, smart proxy

Auto-update subscriptions, node speed test

V2RayU

V2RayU is another popular macOS proxy client supporting multiple protocols.

Multiple protocol support

Flexible configuration

Stable and reliable

ClashX Setup Steps

1

Download & Install

Visit the 'Client Downloads' page in user center, download ClashX. Double-click the dmg file and drag the app to Applications folder.

2

First Run

Open ClashX from Launchpad or Applications folder. System may show 'unidentified developer' warning, go to System Preferences → Security & Privacy and click 'Open Anyway'.

3

Grant Permissions

On first run, you'll be asked for system password to install helper program. This is required for system proxy setup. Enter password and click OK.

4

Get Subscription Link

Login to user center, find Clash subscription link in 'Subscription Center' or dashboard, click copy.

5

Import Subscription

Click ClashX icon in menu bar, select 'Config' → 'Remote Config' → 'Manage', click 'Add', paste subscription link and set a name, click OK.

V2RayU Setup Steps

1

Download & Install

Download V2RayU from user center, double-click to install. If security warning appears, allow it in System Preferences.

2

Import Subscription

Click menu bar icon, select 'Subscription Settings', click '+' to add subscription, paste universal subscription link, click OK.

3

Update Subscription

Click 'Update Subscription' button and wait for node information to update.

4

Enable Proxy

Click menu bar icon, check 'Enable Proxy'. Select any node as current server.

Common Issues

Can't open app, shows 'damaged'?
This is macOS security mechanism. Open Terminal and run: sudo xattr -rd com.apple.quarantine /Applications/ClashX.app (replace with actual app name), then reopen the app.
Can't install helper program even after password?
Check Full Disk Access permissions. Go to System Preferences → Security & Privacy → Privacy → Full Disk Access, add ClashX and authorize.
Some apps can't access internet after enabling proxy?
Some apps don't respect system proxy settings. If using ClashX, try enabling 'Enhanced Mode'. You can also configure proxy in app's own settings (usually 127.0.0.1:7890).

Need Help?

If you have any questions or need support