Chinese notes on client downloads and configuration fields

V2Ray Client Hub

A central directory for Windows, macOS, Android, and Linux clients, with step-by-step explanations of subscription imports, protocol fields, and connection checks. Confirm your platform and client first, then follow the configuration guide.

Project V ecosystem Xray · V2Fly cores Chinese configuration notes Free forever

Open the download page for your system

CONFIGURATION NOTES

Step-by-step field explanations

Client interfaces turn complex configurations into forms, but the fields still map to one another precisely. The sections below annotate protocols, subscriptions, routing, transport, and cores in the order you use them. Select a key on the left to see what it controls, how to verify it, and which boundaries are easy to confuse.

01 / PROTOCOL

The protocol defines the parameter structure; it is not the transport

A protocol is the basic set of rules the client and remote service use to interpret data. VMess includes its own identity and timestamp checks; VLESS uses a leaner authentication structure and is often combined with different security layers. Trojan configurations typically focus on the password, server name, and certificate-related parameters, while Shadowsocks relies on its encryption method and password to define the connection. After importing a node, verify the protocol type first, then check that protocol’s required fields instead of judging by the node name alone.

Protocols and transports such as TCP, WebSocket, and gRPC belong to different layers. Changing the protocol does not automatically fix transport parameters. When the client reports a format error, compare the protocol, port, user identifier, transport, and security layer as one set.

Read the protocol selection guide →

PLATFORM ENTRY

Choose a V2Ray client for your system

Your platform determines the package format and recommended client. v2rayN is the main choice for desktop systems, while Android users can choose between v2rayNG and v2flyNG based on core requirements. The homepage routes you to the right platform; package types and architecture details are listed in the download center.

DESKTOP / X64

Windows

v2rayN is the recommended choice. The desktop edition uses a cross-platform interface, while the classic WPF edition retains a familiar Windows workflow. Both provide subscription management, system proxy controls, routing rules, and log views, so choose the interface that suits you.

Go to downloads

DESKTOP / ARM64 · X64

macOS

Use the v2rayN desktop client. Before downloading, confirm your processor architecture: choose arm64 for Apple Silicon devices and x64 for Intel-based devices. After installation, the same desktop workflow applies to subscriptions, node selection, and the system proxy.

Go to downloads

MOBILE / ARM64

Android

Prefer v2rayNG with the Xray core; choose v2flyNG when you need the V2Fly core. Most newer phones use arm64 packages; if you cannot confirm the architecture, use the universal package. The subscription and connection workflows are similar in both clients.

Go to downloads

DESKTOP / DEB · RPM

Linux

Use the v2rayN desktop client. Debian- and Ubuntu-based distributions generally use deb packages, while Fedora- and RHEL-based distributions generally use rpm packages; also confirm x64 or arm64 for the device processor. After installation, check the desktop session and system proxy settings first.

Go to downloads

QUICK START

From subscription import to connection verification

You do not need to change every advanced option during initial setup. Complete the three basics—subscription, node, and system proxy—then confirm the link works before configuring routing or changing protocols.

  1. 01

    Add a subscription and run an update

    Copy the complete subscription URL from your node service details. In v2rayN, open the subscription group settings; in v2rayNG, open subscription management. Enter a name and URL, then save. Saving only records the source, so run an update afterward. When it finishes, check that new entries appear and that basic details such as the protocol, server, and port display correctly.

    If the list does not change, copy the URL again, check for spaces or line breaks at either end, and confirm that the subscription is still valid. Do not paste an individual vmess:// or vless:// node link into a field that accepts subscription URLs only.

  2. 02

    Choose a node and proxy mode

    Select a node from the updated list as the active server. Start with the client’s real connection test to see whether an actual request completes; do not rely only on reachability tests. Then choose rule mode or global mode as needed: rule mode assigns traffic according to routing conditions, while global mode generally sends more connections through the current outbound. The difference is the scope of traffic handling, not the node configuration itself.

    For first-time use, keep the client’s default routing to reduce variables. If every node times out, check the local time, subscription status, and transport parameters first. If only a few nodes fail, switch nodes and compare the results.

  3. 03

    Start the connection and verify its scope

    After starting the client connection, enable the system proxy or the local takeover method required by the client. A changed connection icon does not mean every app is using the proxy. Open a webpage for a real access test, then check your current public endpoint for confirmation. If the browser works but another program does not, check whether that program follows the system proxy or needs its own proxy address and port.

    After verification, configure startup launch, automatic subscription updates, and custom routing. Change one category of setting at a time and record the result, so you can quickly return to the last known-good state if something goes wrong.

OPEN SOURCE CONTEXT

How Project V, V2Fly, and Xray fit together

Origins of the ecosystem

Project V is a technology ecosystem, not the name of a single client

V2Ray originally developed a composable design for proxies, transports, and routing. In a configuration, inbound, outbound, routing, and transport layers can be described separately and then executed together by the core. Project V is therefore best understood as a set of technical concepts and implementations. The v2rayN, v2rayNG, and v2flyNG clients users see every day provide graphical interfaces built on top of these core capabilities.

Distinguishing the client from the core matters. The client handles subscription management, interface controls, system proxy switches, and logs; the core parses configuration, establishes connections, processes protocols, and applies routes. Similar-looking interfaces do not guarantee identical underlying support.

Core families

V2Fly and Xray share common roots but continue to evolve independently

V2Fly continues V2Ray’s community-maintained direction, retaining support for inbound and outbound handlers, routing, and combinations of transports. Xray extends the same technical lineage with additional protocol, security-layer, and transport implementations. Many basic fields are understandable across both, including addresses, ports, user identifiers, routing rules, and transport networks. For REALITY, XTLS Vision, or specific extension fields, however, check the capabilities of the actual core.

Configuration compatibility cannot be judged solely by whether a file imports. If a client recognizes a share link, that only means the link format was parsed; the active core still has to process every field when starting the connection. For “imports successfully but will not connect” cases, include core capabilities, field names, and transport combinations in the investigation.

Maintenance model

Open-source protocols and community maintenance keep implementation details open to review

V2Fly, Xray, and their graphical clients are developed by different communities and maintainers, so release schedules do not always align. Feature updates may involve protocol implementations, dependencies, platform support, and interface changes. Before upgrading, check the target client’s supported platform and core direction, then decide whether settings need to be migrated. For long-term configurations, keep records of subscription URLs, routing rules, and necessary custom parameters so the environment can be rebuilt after reinstalling or switching clients.

Open-source code allows technical communities to inspect, discuss, and improve implementations and changes, but connection quality still depends on node parameters, the network environment, server configuration, and local system settings. Diagnose issues using logs and reproducible steps rather than drawing conclusions from the client name alone.

TECHNICAL NOTES

Recent configuration and troubleshooting notes

These technical notes focus on repeatable procedures. Each article defines the problem, explains the relevant fields or interface entry points, and ends with verification steps for comparison across clients.