V2Ray Download & Setup Guide
v2rayN and v2rayNG client downloads, subscription import, and routing configuration guides, covering Windows, macOS, Android, and Linux. Free forever, open source.
Whether you're new to V2Ray or want to dive deeper into routing rules and TUN mode, this site offers corresponding Chinese tutorials. From download and installation to subscription import, from node speed testing to troubleshooting, we'll guide you step by step to get the most out of this open-source proxy tool.
V2Ray itself is just a network proxy core; you need a graphical client to use it conveniently. v2rayN is the most popular V2Ray client on Windows, while v2rayNG is the go-to choice on Android. This site offers a Chinese guide for these two clients, from beginner to advanced.
Subscription Import
v2rayN supports batch importing nodes from subscription links. After pasting the subscription URL, the client automatically fetches and parses the node list, so no manual addition is needed. When the subscription updates, the node list syncs automatically to keep the configuration current. v2rayNG on Android also supports subscription import with the same workflow.
When importing subscriptions, it's recommended to create separate groups in the client for different providers or services to make management and switching easier. v2rayN's 'Subscription Group' feature lets you store nodes from different sources separately, avoiding a cluttered list that's hard to search. If a subscription expires, just delete the corresponding group without affecting other nodes.
Subscription links usually contain encrypted information, so don't share them casually. If a subscription link leaks, others may use your nodes and consume your traffic. It's recommended to change your subscription link regularly and enable 'Subscription Update Alerts' in the client to stay informed about node changes.
Routing
With routing rules, V2Ray can automatically identify traffic types: traffic within mainland China goes direct, traffic outside China goes through the proxy, and ad traffic is dropped. v2rayN includes common routing rules and also supports custom rules. Properly configuring routing rules can improve access speed and reduce proxy traffic consumption.
There are three common routing strategies: 'Bypass LAN' lets local devices (like printers and NAS) connect directly to avoid proxy interference; 'Bypass Mainland China' lets sites in mainland China connect directly while sites outside China go through the proxy; 'Ad Domain Blocking' drops known ad domains to reduce page load time.
If you use TUN mode to take over all traffic, routing rules become even more important. It's recommended to put domain rules before IP rules, because domain rules match more precisely and can prevent traffic from being incorrectly routed to the proxy. For apps that need real IPs, you can add direct rules separately.
Node Speed Test
v2rayN offers a node speed test feature that checks each node's latency and availability. Results are shown in milliseconds; lower latency means faster connections. v2rayNG on Android also supports speed testing to help users pick the best node. Speed test data is for local reference only and is never uploaded to any server.
When testing, it's recommended to compare multiple nodes rather than just one. Latency can fluctuate over time, so a single test result may not be accurate. v2rayN supports 'Batch Speed Test' to test all nodes in one click and sort them by latency for quick selection.
Besides latency, a node's bandwidth and stability are equally important. A node with low latency but limited bandwidth may be slow when downloading large files. It's recommended to combine speed test results with real-world experience to pick the best overall node. If a node frequently times out, you can mark it as 'Uncommon' to avoid selecting it by mistake.
Four-Platform Coverage
v2rayN supports Windows, macOS, and Linux desktop, while v2rayNG supports Android. No matter which operating system you use, there's a client for you. The client configuration format is unified, so when switching platforms you just need to re-import your subscription.
On Windows, v2rayN offers a graphical interface with system proxy and TUN mode support; on macOS, v2rayN also provides a full configuration interface; on Linux, v2rayN can run via command line or graphical interface; on Android, v2rayNG offers a mobile experience with per-app proxy support.
When using across platforms, it's recommended to keep your subscription link in a safe place so you can import it on different devices. Since the client configuration format is consistent across platforms, you can manually copy routing rules configured on one device to others, reducing duplicate setup work.
Quick Start
View Full Tutorial →Download Client
Choose the v2rayN or v2rayNG installer for your platform.
Import Subscription
Add the subscription link in the client to automatically fetch the node list.
Connection Test
Enable system proxy, test node connectivity, and choose the best node.
These three steps complete the basic setup. If you run into connection issues, check out the 'Troubleshooting' article on this site, or refer to the advanced configuration notes in the 'Full Tutorial'.
Download Client
Choose the client for your platform; all downloads are the latest version.
Windows
v2rayN Desktop
Go to Download →macOS
v2rayN Desktop
Go to Download →Android
v2rayNG / v2flyNG
Go to Download →Linux
v2rayN Desktop
Go to Download →Before downloading, confirm your system version and architecture (e.g., Windows 10/11, macOS Intel/Apple Silicon). All installers are the latest official versions; after installation, you can import your subscription and start using it.
If you're not sure which version to download, read the 'Quick Start' or 'Full Tutorial' first to understand the differences between clients on each platform before making a choice.
Project V Ecosystem & Open Source
V2Ray Core Family
V2Ray is a core component of the Project V project, with two kernel branches: V2Fly and Xray. v2rayN uses the Xray kernel by default, while v2rayNG supports switching between Xray and V2Fly kernels. All three clients share the same configuration format and ecosystem resources.
The Xray kernel is the current mainstream choice, supporting newer protocols like VLESS and REALITY with better performance; the V2Fly kernel is the classic branch that maintains compatibility with older protocols. If you're using older nodes, you may need to switch to the V2Fly kernel to connect properly.
Open Source License
v2rayN, v2rayNG, and v2flyNG are all open-source software with publicly available code. Open source means users can review the code and contribute, ensuring the software's behavior is transparent and predictable. The clients are free forever with no charges.
Open-source projects usually follow permissive licenses that allow free use, modification, and distribution. This is one reason the V2Ray ecosystem has grown so quickly. If you're interested in the code, you can check the source in the project repository and even submit improvement suggestions.
Community Maintenance
The Project V ecosystem is continuously maintained by an active community, with kernels and clients receiving regular updates. Users can get help from official documentation and community forums. This site provides Chinese guides to help users get started quickly.
When you encounter issues, it's recommended to check the official documentation and this site's tutorials before asking the community for help. When describing a problem, include logs and configuration if possible (remember to hide sensitive information) so you can get effective help faster.
Latest Articles
How to troubleshoot V2Ray kernel startup failure: locate configuration errors from log messages
Kernel startup failure is usually a configuration issue. This article shows you how to open the v2rayN log window, understand common errors like 'failed to start' and 'invalid config', and troubleshoot along three lines: port conflicts, JSON syntax, and certificate settings.
Androidv2rayNG Android usage tips: VpnService authorization, battery optimization whitelist, and per-app proxy settings
This article covers three key v2rayNG settings on Android: granting VpnService authorization on first connection, adding apps to the battery optimization whitelist to prevent background disconnections, and configuring per-app proxy as needed to let specific apps use or bypass the proxy.
AdvancedWhat is FakeDNS: how fake IPs speed up domain resolution and its use cases
FakeDNS answers DNS queries immediately with fake IPs from reserved ranges, eliminating real resolution round trips, then restores the domain name on outbound traffic. This article explains its workflow, the scenarios where it speeds things up, and things to watch out for when combining it with routing rules and TUN mode.
AdvancedV2Ray LAN connection settings: share your proxy with phones, TVs, and other devices
Enable 'Allow connections from LAN' in v2rayN, and phones, tablets, and TVs on the same network can use the proxy by entering your computer's IP and port. This article walks through the setup steps, firewall rules, and common reasons why devices can't connect.