03 — Guides & troubleshooting
All guides
The complete set of V2Ray / v2rayN usage, troubleshooting and security guides — 30 articles, available in 5 languages.
v2rayN for beginners: from download to online
First time with v2rayN? This walks through the three things in order — download, import a node, turn on the proxy — so you're online in five minutes.
Getting startedHow to import a subscription URL in v2rayN
A subscription URL keeps your node list updated automatically. Here's how to add it, update it, and troubleshoot import failures.
ConfigurationVMess vs VLESS vs Trojan vs Shadowsocks
Which protocol should you pick? A one-line verdict plus a comparison so the node parameters stop confusing you.
AdvancedWhat is REALITY, and why it resists blocking
REALITY borrows a real, major website for the TLS handshake, so there's no certificate of its own to expose. Here's the idea and the key settings.
ConfigurationTUN mode vs system proxy: which to use
A system proxy only catches apps that read proxy settings; TUN captures the whole machine. Understand the difference so you're never puzzled by an app that ignores the proxy.
ConfigurationRouting rules: direct at home, proxy abroad
Routing decides what goes through the proxy and what connects directly. The right preset saves data and keeps local sites fast.
TroubleshootingCommon v2rayN errors and how to fix them
The frequent failures — startup errors, port in use, missing core — matched to what the message means.
TroubleshootingHow to test node latency and real speed correctly
Low latency isn't the same as high speed. Here's how to use v2rayN's test tools and read the results.
ConfigurationHow to update the Xray / sing-box core
New protocols and features live in the core. Update it inside v2rayN with one click, or replace it manually.
ConfigurationSwitching between the Xray and sing-box cores
To use Hysteria2 or TUIC you need sing-box. Here's when and how to switch.
AdvancedPer-app proxy: route only some programs
Want the browser proxied but a downloader direct? Use process- or domain-based routing for fine control.
AdvancedShare v2rayN's proxy with other LAN devices
One PC connects a node; let your phone, TV and console all use its proxy.
AdvancedConfigure DNS to avoid poisoning and leaks
Bad DNS setup causes poisoned lookups or leaks your real location. Here's a solid split-DNS scheme.
Getting startedImport and share nodes with QR codes
When copying a link is awkward, a QR code is fastest. Scanning to import, generating a share code, and a safety note.
TroubleshootingWhen antivirus flags it or the firewall blocks it
xray.exe being deleted as a trojan is the single most common "won't open" cause. Here's how to whitelist it properly.
SecurityVerify the file hash to avoid backdoored builds
Repacks with backdoors are common. Spend a minute comparing the hash to confirm you have the genuine official build.
MobileGetting started with v2rayNG on Android
The mainstream Android client, by the same author as v2rayN. Download, import, and turning on the VPN, end to end.
MobileUsing V2Ray on iOS: clients and setup
The App Store limits, the non-China Apple ID you need, and how to choose between free and paid clients — all in one place.
MobileA guide to macOS clients
Besides v2rayN's cross-platform build, the Mac has a few solid native clients — pick by need.
AdvancedTransparent proxy on OpenWrt routers
Run the proxy on the router and every device routes automatically — no per-device setup. Plugin choices and the basic idea.
Getting startedChoosing a subscription without getting burned
Cheap, stable and fast rarely come together. A few practical tips for choosing and protecting yourself.
AdvancedSelf-hosting a VLESS + REALITY node (overview)
One overseas VPS is enough to run your own, private and unthrottled. An overview from installing Xray to producing a client link.
Troubleshooting"Connected but no pages load": how to diagnose
The node shows connected with normal latency, yet the browser just spins. Follow this order to pinpoint it in a few steps.
ConfigurationStreaming unlock and how to route it
Netflix and YouTube region limits depend on a node's unlock ability. How to check, and how to route to a node that unlocks.
TroubleshootingLatency, packet loss and speed — how they relate
Why is the connection choppy when latency is low? Understand these three metrics to tune the right thing.
ConfigurationSet up automatic subscription updates
Let v2rayN refresh subscriptions on a schedule instead of by hand. The settings and the caveats.
ConfigurationBack up and migrate your v2rayN config
Before switching PCs or reinstalling, back up these files to restore everything in minutes.
ConfigurationManaging multiple subscriptions with groups
Using two or three providers? Groups and filtering keep it tidy no matter how many nodes.
TroubleshootingRead v2rayN logs to troubleshoot yourself
The log is the scene of the crime. How to enable it, recognize the key fields, and pinpoint problems fast.
SecuritySecurity and privacy best practices with proxies
However skilled you are with the tools, bad habits still bite. A practical self-protection checklist.
No matching clients — try another keyword.
30 / 30