v2rayNv2rayNGv2flyNG

Xray Core HubV2Ray Clients

Choose an open-source client for your platform, follow the guides to import subscriptions and configure routing, then check node and core compatibility in the protocol reference.

Download a Client for Your Platform

Check your operating system and processor architecture before choosing a package. The package determines whether the app runs on your device; the proxy protocol determines which core handles the connection. These are separate choices: after installation, configure the node using the parameters supplied with your subscription or by the server.

Windows

v2rayN Desktop has a cross-platform interface; Classic uses WPF. Check the system requirements before installing and locate your settings folder before switching editions.

If v2rayN won't start, check the CPU architecture, required desktop runtime, and write permissions for the folder you extracted it to.

Go to Downloads

macOS

Check the chip or processor in About This Mac. Choose the ARM64 build of v2rayN for Apple Silicon or the x64 build for Intel.

If your browser bypasses the proxy, check the active network's proxy settings and verify that the browser uses them.

Go to Downloads

Android

Choose v2rayNG for Xray or v2flyNG for V2Fly. Both offer ARM64 and universal packages. Pick ARM64 if your device supports it.

Allow the VPN connection when Android prompts you. If another VPN is active, disconnect it before retrying. Test the same node on Wi-Fi and mobile data.

Go to Downloads

Linux

Choose DEB for Debian or Ubuntu, or RPM for Fedora. Match the package to your CPU (x64 or ARM64) and check its dependencies before installing.

If the browser works but a terminal tool doesn't, check the tool's proxy settings and environment variables. It may not use the desktop proxy.

Go to Downloads

Client Features and Settings

Subscriptions provide nodes; the system proxy and virtual network interface determine how traffic enters the client; routing rules decide which outbound connection it uses. During initial setup, change one layer at a time: verify a single node, check that the target app is sending traffic through the client, then enable routing rules. This gives you a known set of settings to compare against if something goes wrong.

Settings / Subscription Groups

Subscriptions make it easy to manage a changing set of nodes. Create a group, enter the subscription URL provided by your service in the optional address field, and update it. If you only have a single share link, import it from the clipboard instead of treating it as a subscription URL. After the list updates, select one node and test the connection before checking the others. If the update succeeds but no entries appear, check whether the response uses a subscription format the client can read and whether you selected the right group during import. Keep manually added nodes in a separate group so they do not get mixed up with subscription entries.

Subscription Groups
Add Subscription Group
Optional address
Enter the subscription URL provided by your service
Update Subscription
Update the current subscription group

Project V, V2Fly, and Xray

The client provides the configuration interface, the core runs the connections, and the protocol defines how the two endpoints communicate. A single client can support multiple configurations, and the same protocol name may cover only some of the same transport and security options across different cores.

How Project V Is Structured

Project V is the open-source ecosystem that includes V2Ray. V2Ray's core design separates connections into inbound, routing, and outbound stages: inbound receives app traffic, routing selects an exit, and outbound establishes the connection using the relevant protocol. Graphical clients map these pieces to node lists, proxy toggles, and routing options. A lit connection indicator usually means only that the relevant service is running; it does not mean your browser, terminal, and other apps are all using the same proxy entry.

For example, a browser and a command-line tool may access the same domain differently: the browser might follow the system proxy, while the command-line tool might read only environment variables. Even with the same domain and node, one may work while the other fails. First determine whether the problem occurs before traffic reaches the client or during the outbound connection; this is more useful than repeatedly refreshing the subscription. If the log shows no connection from the target app, check that app's proxy settings. If a connection is logged, inspect the matched rule and outbound result.

Core Families and Configuration Compatibility

V2Fly continues the community maintenance of V2Ray, while Xray developed independently after branching from related code and added capabilities such as REALITY. They share some concepts and configuration structures, but they are not two names for the same program. Choose a core based on the server requirements: check the proxy protocol, then the underlying transport, security layer, and flow control, and finally confirm that the client passes all required fields to the core. Seeing a node name and server address in a subscription only confirms that the client read some of its contents.

When testing across cores, keep the original configuration for the same node; do not delete an entry that currently works. If switching cores adds or removes a field in the editor, check whether that setting is configured elsewhere or whether the combination is unsupported. A configuration error during startup and a handshake failure after startup are different starting points for troubleshooting: first check which fields the core supports; then verify that the values match the server. Compare Xray and V2Fly.

Protocols, Security Layers, and Flow Control

VMess, VLESS, Trojan, and Shadowsocks are proxy protocol options. In Xray's VLESS configuration, REALITY appears under transport security and Vision under flow control. A share link beginning with VLESS identifies the proxy protocol, but does not tell you which security layer it uses or whether it uses Vision. Use the node's parameters when editing it; do not apply the same security settings to every configuration. The server name in a standard TLS configuration also cannot replace the other parameters required by a REALITY node.

Public protocol specifications and open-source implementations can help explain what each field does, but protocol names alone do not predict real-world speed or battery use. To compare configurations, use two confirmed working setups on the same device and network, at roughly the same time, and run the same task. Evaluate page load time separately from sustained transfers. On a phone, also note whether switching Wi-Fi networks triggers repeated reconnects; one connectivity test does not represent the full experience.

Clients, Cores, and Rules Update Separately

v2rayN is an open-source desktop client, commonly used to edit servers and manage subscription groups. v2rayNG is an open-source Android client that primarily uses Xray; v2flyNG is an open-source option for Android users who need the V2Fly implementation. Each project maintains its own interface and release packages. Even with the same subscription on two devices, menus, local listening behavior, and system permissions may differ. A desktop configuration directory cannot replace subscription groups or network settings on a phone.

Before updating, identify what you plan to change. Updating the app package may affect menus, runtime dependencies, or how the core is invoked; changing only the core primarily affects protocol and field support; updating a subscription refreshes nodes; updating routing data can change some match results. To find out what caused an issue, note the working node, proxy mode, and routing preset, then make one update and retest with the same app. If the network also changed, treat that as a separate variable. Read the protocol and core reference.

Recent Technical Articles

Start with the stage where the problem occurs: check platform notes if the app will not start, investigate the traffic entry point if it is running but an app cannot connect, and review security layers and flow control when choosing a node protocol.

Download Client