macOS 10.15 Catalina or newer

macOS Setup Guide

Recommended client: V2RayX

What You Need

Download the Client

1
Download the latest V2RayX disk image (.dmg).
- Save the .dmg file to your Downloads folder
- Prefer the Universal build if available (Apple Silicon + Intel)
2
Mount the disk image and drag V2RayX to Applications.
- Double-click the downloaded .dmg to mount it
- When the window opens, drag V2RayX onto the Applications folder
- Unmount the disk image after copying
3
Open V2RayX from Applications.
The first time you launch V2RayX, macOS may block it with "V2RayX cannot be opened because the developer cannot be verified".
If blocked → open System Settings → Privacy & Security → scroll to the bottom, click "Allow Anyway" next to the V2RayX notice, then open the app again.

Import Your Subscription Link

1
Locate the V2RayX menu-bar icon.
V2RayX lives in the menu bar at the top-right of your screen. You will see a small paper-plane or V logo.
2
Open Import from URL.
- Click the V2RayX menu-bar icon
- Hover over "Config" to reveal the submenu
- Click "Import from URL…"
3
Paste your STEA subscription link and click OK.
A toast notification will confirm the import. Your servers are now available from the server list inside the same menu.
To see servers, click the menu-bar icon → "Configure" → "Servers" panel.

Connect

1
Pick a server.
Click the menu-bar icon → select a server near you. For general browsing, Singapore or Japan are the fastest for most Asian users.
2
Turn on "Enable Proxy".
- From the menu, click "Enable Proxy"
- The menu-bar icon will switch to a colored "ON" state
- System proxy is automatically configured
You can toggle the proxy any time from the same menu, or set a global keyboard shortcut in Preferences.

Verify It Works

1
Open Safari or Chrome and verify your public IP.
Visit whatismyip.com — the country shown should match the selected server.
2
Test streaming and AI services.
Load Netflix, YouTube in 4K, or open ChatGPT to confirm access. First load may take a moment as the connection warms up.

PLACEHOLDERS

Menu Bar Icon

V2RayX lives in the top-right menu bar

Import from URL

Config → Import from URL → paste your link

Enable Proxy

Once enabled, icon shows as "running"

macOS says app is damaged or cannot be opened.
Re-download V2RayX and drag it again into Applications. If the issue persists, open Terminal and run: xattr -dr com.apple.quarantine /Applications/V2RayX.app
Proxy enables but websites do not load.
Open V2RayX Preferences → select a different Routing mode (start with "Global"). Also make sure you are not running another VPN at the same time.
Apple Silicon (M1/M2/M3) CPU crashes.
Make sure you downloaded the "arm64" or "Universal" build. The x86-only build runs under Rosetta and may crash randomly.

We respond within 24 hours — usually much faster.

WeChat

ixaiah-iBoY

Approved users can always download the latest client links from their dashboard.