Choose a platform and a trusted client
Android users often choose v2rayNG or Hiddify; iPhone users need a compatible client available in their App Store region; Windows users may use Hiddify, v2rayN, or another compatible application. Install from the official repository or store. A network client can see device traffic, so an unknown build received in a chat is not an acceptable source.
Three import methods
Open an import link, paste a profile from the clipboard, or scan a QR code. A link is convenient on the same device, while QR works well when the subscription page is displayed elsewhere. Check the profile name and issue date after import. Remove stale duplicates so the client does not reconnect with an expired key.
Basic troubleshooting
If the client reports a connection but applications remain offline, inspect system or TUN routing, DNS, and client permissions. If the tunnel itself fails, update the app, synchronize device time, and compare another network. Redact addresses, UUIDs, keys, and subscription links before sharing a log.
Select a platform guide
The VLESS Android guide covers v2rayNG and compatible clients, VLESS iPhone covers available iOS apps and QR import, and VLESS Windows covers system mode, startup behavior, and route checks. Button names change between releases, so compare the guide with the current official client interface.
Guides in Setup guides
9 min read
v2rayNG vs Hiddify for VLESS Android: Fix Common Errors
Compare v2rayNG and Hiddify for VLESS Android, choose by profile control and workflow, then diagnose import, handshake, DNS, and routing errors.
Read guide9 min read
Shadowrocket vs Streisand for VLESS: iPhone Diagnostics
Compare Shadowrocket and Streisand for VLESS on iPhone, then diagnose profile imports, VPN permissions, DNS, routing, and network-extension conflicts.
Read guide11 min read
VLESS VPN on a Router: Plan an Xray Home Network
Plan a VLESS VPN router deployment with Xray, supported firmware, selective routing, DNS, rollback, key protection, and device-by-device verification.
Read guide8 min read
Use a VPN QR Code to Import a VLESS Profile Safely
Learn what a VPN QR code contains, how to import VLESS on supported devices, when clipboard import works better, and how to prevent credential leaks.
Read guide