03 — Guides & troubleshooting
All guides
The complete set of V2Ray / v2rayN usage, troubleshooting and security guides — 40 articles in 5 languages, covering official download channels and keeping the core on the latest version.
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.
AdvancedUsing Hysteria2 and TUIC nodes in v2rayN
Xray-core doesn't implement either protocol, so you have to switch cores. Here's the switch, plus why an imported node still won't connect.
TroubleshootingPort 10808 is already in use and v2rayN won't start
A failed listener usually means the previous instance never exited, or another proxy grabbed the port. How to find the culprit and move the port.
AdvancedChained proxies: send traffic through one hop before it leaves
An upstream proxy covers two cases — a network that only allows one exit, and routing through a relay before the exit node. How to set it up, and what it costs.
AdvancedOverriding the JSON that v2rayN generates with your own config
Options the GUI doesn't expose — fragmentation, complex routing, extra inbounds — have to be written by hand. How to import a custom config properly.
TroubleshootingReading TLS handshake and certificate errors
handshake failure, unknown authority, expired — each points somewhere different. Use these to tell a node problem from a local one.
ConfigurationSubscription formats: Base64, Clash YAML and sing-box JSON
The several subscription URLs one provider hands you contain different things. Knowing which one v2rayN eats directly saves a lot of fiddling.
ConfigurationShould you enable IPv6, and why it can make things slower
Home broadband has IPv6, your node doesn't, and you end up half-connected. What each IPv6 switch in v2rayN actually does.
TroubleshootingYour usage doesn't match the provider's dashboard
The client says 3 GB, the panel deducted 5 GB. The gap usually comes from multipliers, retransmissions and where the counting happens.
SecurityWhat happens if your subscription link leaks, and how to recover
A subscription URL is as sensitive as a password. The consequences, the signs someone else is using it, and the reset routine.
Mobilev2rayNG keeps disconnecting because Android kills it
Drops a minute after the screen goes off and reconnects when you come back — that's power management, not the node. Where the settings live on each brand.
No matching clients — try another keyword.
40 / 40