CLIENT RELEASE INDEX / ZH-CN

V2Ray Download Hub
Clients & Guides

A central directory for v2rayN and v2rayNG, covering subscription imports, traffic routing, and connection troubleshooting. Choose a client for your platform, then follow the graphical setup steps.

Free forever Open source Xray · V2Fly English documentation
ROUTE REGIONS United States Japan Hong Kong Singapore South Korea
04 SUPPORTED PLATFORMS 03 GRAPHICAL CLIENTS CORE XRAY · V2FLY CONFIG SUBSCRIPTION · ROUTING

CONFIGURATION LEDGER

Core client capabilities

Each item below maps to an action path in the client. Select an item on the left to see its purpose, setup method, and practical limits.

01 / SUBSCRIPTION INPUT

Build a server list from a subscription link

Subscription import writes the server collection provided by a service into the client. On desktop, add the address under “Subscription groups”; on Android, open subscription settings from the top-right menu. After saving, run an update manually so the client can read the remote content and create server entries. A subscription is only a configuration source, not a connection state; after updating, select a server and start the connection.

If an update returns no results, check in order that the link is complete, the response is reachable, the client recognizes its encoding, and the client is not outdated. Do not add the same address repeatedly, as this can create duplicate groups. When switching services, disable the old group before adding the new address so configuration sources and later update results stay clear.

View subscription import steps →

PLATFORM DIRECTORY

Choose a client by operating system

Platform links only take you to the relevant download category. Package types, processor architectures, and system requirements are listed on the download page.

01 / DESKTOP

Windows

Use v2rayN on desktop. The download page offers both a newer cross-platform desktop interface and the classic WPF interface, suitable for system proxy settings, routing rules, subscription groups, and TUN interception. Check your system architecture and runtime environment before choosing.

Go to downloads
02 / DESKTOP

macOS

Use v2rayN’s cross-platform desktop interface. When downloading, distinguish between Apple Silicon and Intel processors; the two installers are not interchangeable. After installation, import a subscription, choose a server, and follow the software prompts to grant any required network permissions.

Go to downloads
03 / MOBILE

Android

Use v2rayNG with the Xray core by default; choose v2flyNG when you need the V2Fly core. Most modern devices use the arm64 architecture; consider a universal build only when the architecture is unknown. The two clients have similar subscription-import workflows, but their core extension support differs.

Go to downloads
04 / DESKTOP

Linux

Use v2rayN on desktop and choose a deb or rpm package for your distribution. Different processor architectures require different builds, so confirm the system architecture before installation. The graphical interface is suited to subscription and routing management; system-wide interception still depends on your distribution’s network settings.

Go to downloads

QUICK START SEQUENCE

From installation to connection

Complete the shortest path first, then adjust advanced settings. This keeps installation, subscription, and routing issues separate during troubleshooting.

  1. 01

    Choose a client and install it

    Use v2rayN on Windows, macOS, and Linux; use v2rayNG on Android by default, or choose v2flyNG when you need the V2Fly core. Before downloading, confirm the operating system, processor architecture, and package type. After the first launch, keep the default routing and port settings and avoid changing several advanced options at once. If the system asks for network or virtual-adapter permissions, understand their purpose before applying them to your current mode.

  2. 02

    Add a subscription and update the list

    Copy the complete subscription link and add a new group in the client’s subscription manager. The name is only for local identification, so use the service source or intended purpose. Save it, run an update, confirm that the server list appears, and then test one entry. If nothing appears after updating, check the link and response format first rather than switching proxy modes; the problem is still in the configuration-input stage.

  3. 03

    Start the connection and verify the exit

    After selecting a server, start the client and use the system proxy or default client mode to verify basic connectivity. Once connected, decide whether to use rule-based routing or TUN based on the required coverage. During verification, watch both the client status and core logs: a successful startup does not guarantee a successful target connection, and browser access does not mean every application uses the same exit. Troubleshoot in order through the subscription, core, and network layers.

The complete guide covers subscription updates, server selection, system proxy settings, routing modes, TUN permissions, DNS settings, and connection verification. Menu locations vary between clients, but the workflow remains the same.

View the complete guide

OPEN SOURCE ECOSYSTEM

Project V, V2Fly, and Xray

Clients, cores, protocols, and subscription formats are different concepts. Understanding how these layers relate helps you assess configuration compatibility and functional limits.

The ecosystem and its layers

Project V established an open-source technology ecosystem built around proxy protocols, transport layers, security parameters, and routing. In practice, users usually interact with a graphical client, while the core handles connections, configuration parsing, transport setup, and routing rules. The client organizes subscription management, server selection, system proxy settings, and log viewing into an interface, then converts the result into a configuration the core can read.

This layered design means clients with similar interfaces may use different cores, and the same basic configuration may behave differently when extension fields vary. When troubleshooting, identify the failing layer first: can the client save settings, can the subscription create entries, can the core parse the configuration, can the connection complete its handshake, and can routing rules match? Mixing these stages makes configuration errors easy to mistake for network problems.

The V2Fly and Xray core families

V2Fly continues the core capabilities of the Project V ecosystem, focusing on protocol implementations, transport combinations, routing, and cross-platform operation. Xray developed within a similar configuration model and expanded parts of its protocol capabilities, transport options, and security parameters. The two share many basic fields, but not every extension is interchangeable. When a subscription contains newer fields, the selected client core and its support range directly affect the import result.

Do not choose a core by name alone. When a service specifies a protocol type and configuration requirements, use a client that fully recognizes those fields. v2rayNG with the Xray core suits common Android configurations; v2flyNG is an alternative for users who need the V2Fly family. On desktop, v2rayN brings settings related to multiple cores and system proxy features into one interface, while the available options still depend on the components included in the current build.

Open-source licensing and community maintenance

v2rayN, v2rayNG, and v2flyNG are all open-source clients. Open-source licenses define the boundaries for using, modifying, and redistributing source code, while allowing protocol implementations, configuration conversion, and interface behavior to be discussed publicly. Open source does not mean every build has the same features; release schedules, dependencies, and core update cycles can differ. When a new protocol field is not recognized, first check the client type and release timeline.

Community maintenance usually focuses on bug fixes, system compatibility, core upgrades, and configuration-format changes. A new build may add field support or adjust menu locations and defaults. Before upgrading, record your subscription groups and key routing settings; afterward, verify the basic connection before restoring complex rules. Keeping an old configuration from an unknown source increases troubleshooting costs; reorganizing it around fields supported by the current client is easier to maintain.

Subscription formats and update boundaries

A subscription link distributes configuration. Its response may be a collection of individual links, encoded text, or structured configuration. The client must fetch the response and then parse it into server entries in a supported format. If the link is reachable but the list is empty, the response format, encoding, or field support may differ; if the list is normal but connections fail, continue by checking core startup and target parameters. Updating a subscription does not automatically repair manually overridden settings or choose a routing mode for you.

Managing subscription groups, client settings, and core logs separately reduces mistakes. The subscription supplies server parameters, the client manages the local entry point and interface state, routing chooses the traffic exit, and logs record execution results. Each has a clear role. When moving to a new device, complete an independent import and verification there before disabling the old configuration, so old port or permission problems are not carried over.

Download V2Ray clients