← Back to VPN

Mac VPN Setup

Get macOS connected in 5 minutes

Recommended clients

Recommended

ClashX Meta

Recommended
Price:Free, open sourceBest for:Polished UI; SS + V2Ray; native Apple Silicon (M1/M2/M3)

Original ClashX is unmaintained. ClashX Meta (MetaCubeX fork) is the active version.

ShadowsocksX-NG

Lightweight
Price:Free, open sourceBest for:SS only; tiny footprint; Intel Macs first

Project is archived but still works. Compatible with M1/M2 via Rosetta.

Step-by-step (~5 minutes first time)

  1. 1

    Download ClashX Meta .dmg and install

    Drag to Applications. First launch is blocked by Gatekeeper → System Settings → Privacy & Security → 'Open Anyway'.

  2. 2

    Cat icon appears in the menu bar

    If not, double-click ClashX Meta in Applications to launch.

  3. 3

    Menu bar → Proxies → Add Proxy

    Type = Shadowsocks. Fill IP / Port / Password / Encryption from jiangren.com.au Account → VPN.

  4. 4

    Select the new node

    Menu bar → click the node name to put a tick next to it.

  5. 5

    Menu bar → 'Set as System Proxy'

    Crucial — without this, browsers go around the proxy. Once enabled, macOS Settings → Network → Wi-Fi → Details → Proxies will auto-populate (127.0.0.1:7890).

  6. 6

    Mode → 'Rule' (smart routing)

    Switch to Global temporarily if some sites refuse to proxy.

  7. 7

    Verify in any browser with https://ifconfig.me

    IP should switch. Then try google.com.

Mac troubleshooting

Safari isn't going through the proxy

Settings → Network → Wi-Fi → Details → Proxies → ensure HTTP / HTTPS proxy is 127.0.0.1:7890. Toggling 'Set as System Proxy' in ClashX Meta should populate this automatically.

Can't access the internet after quitting ClashX

Disable 'Set as System Proxy' before quitting. If you forgot: Settings → Network → Wi-Fi → Details → Proxies → turn off all proxy switches.

M1/M2/M3 compatibility

ClashX Meta supports ARM natively. ShadowsocksX-NG runs via Rosetta 2. Pick the universal or arm64 build when downloading.

Gatekeeper blocking

macOS 14+: System Settings → Privacy & Security → scroll down → 'ClashX Meta was blocked' → 'Open Anyway'.

Links go to official sources. If GitHub is slow or unreachable in your region, email contact@jiangren.com.au for mirrors.

Still can't connect?

Email contact@jiangren.com.au with subject [VPN issue]. Include: device model, client name & version, error screenshot, selected region. We reply within 24h.