What Is v2rayN? The Client Everyone Downloads Expecting a VPN

Search for v2rayN and a good share of the results treat it as a free VPN you download and turn on. That expectation is the reason so many people install it, open it, and find themselves staring at an empty window. Here is what the project actually is, according to its own documentation, and what you still need after installing it.

What it is, precisely

The repository describes v2rayN in one line: a GUI client for Windows, Linux and macOS. Support Xray and sing-box and others.

Every important detail is in that sentence.

It is a GUI client, meaning a graphical front-end. It is not a proxy implementation of its own. The actual protocol work is done by a core underneath, and v2rayN drives that core: it manages your server entries, switches between them, applies routing rules, and shows you what is connected.

The cores it explicitly supports are Xray and sing-box, with the project pointing to a documented list of supported cores. The protocols in play are the ones you would expect from that family: Shadowsocks, SOCKS5, Trojan, VLESS, VMess and XTLS.

What it is not

A client is one half of a connection. The other half is a server, and v2rayN ships with none.

This is not a criticism of the project, which never claims otherwise. It is a correction of the expectation people arrive with. A VPN service sells you access to its servers, and the app is just the door. v2rayN is the door with no building attached: you supply the building.

So after installing it you still need a server configuration, and there are exactly three ways to get one. You rent a VPS and configure a core on it yourself. You subscribe to a provider that hands you a config. Or someone gives you one, which is worth thinking about carefully, since whoever runs that server sees your traffic patterns the same way any provider would.

Three green network cables plugged into a patch panel, with a partly obscured SERVER label visible below the ports.

v2rayN or v2rayNG?

This one causes real confusion, and the search suggestions show it: people type both names interchangeably.

They are two separate projects. The v2rayN README states that v2rayN is the desktop version and directs mobile users to v2rayNG, which is the Android client. Same family, same protocols, different codebase and different platform.

If you are on a phone, the NG suffix is the one you want. If you are on a laptop, drop it.

The platform list is broader than its reputation

v2rayN is widely described as a Windows tool, and that is where most of its users are, but the documented support is wider:

Windows: x64, x86, arm64
Linux: x64, arm64, riscv64, loong64
macOS: x64, arm64

The presence of riscv64 and loong64 in that list tells you something about who maintains this ecosystem and where it is used.

Free software, not free connectivity

The project is licensed under GPL-3.0 and distributed through GitHub releases. The software genuinely costs nothing and you can read its source.

That is a different statement from "free internet access". The cost simply moves: a VPS you rent by the month, or a subscription you pay for. Anyone presenting v2rayN itself as free unlimited access is skipping the part where a server has to exist and someone has to pay for it.

So which route do you actually want?

Two honest paths, and they suit different people.

Run your own. You rent a VPS, install a core on it, and point v2rayN at your own endpoint. You control the server, nobody else shares it, and the ongoing cost is the VPS. The trade is that configuration and maintenance are yours, and a misconfigured server is worse than no server. Our guides on sing-box vs Xray and the VLESS REALITY setup cover that path.

Use a commercial service. You pay a provider, install their app, and never see a config file. It is faster, it is supported, and you are trusting the provider's policies rather than your own configuration skills.

Choosing between them is a question about what you want to spend: time and attention, or money. Both are legitimate answers, and the one thing that is not an answer is expecting a client with no server to do the job.

The short version

v2rayN is a free, open-source GUI client for Xray and sing-box, GPL-3.0, running on Windows, Linux and macOS across a broad set of architectures. It is not a VPN, it includes no servers, and it is not the same project as v2rayNG, which is the Android client.

Install it and you have a capable front-end waiting for a configuration. Where that configuration comes from is the actual decision, and it is the one worth spending your thinking on.

The description of v2rayN, including the one-line project summary, the supported cores, the platform and architecture list, the GPL-3.0 licence and the statement that v2rayN is the desktop version with v2rayNG for mobile, is taken from the project's official repository README, checked at the time of writing. Open-source projects change quickly; verify against the repository before relying on a specific detail. This article describes the software and does not advise on the legality of proxy use in any jurisdiction, which varies and is your responsibility to check.

★ Nuremberg GDPR datacenter · ✓ Dedicated IPv4 included · 200+ Mbps guaranteed

A VPS you fully control for tunneling & obfuscation → ContaboRoot access · open any port · run your own stack→

Frequently asked questions

Is v2rayN a VPN?

No, and this is the single most common misunderstanding. The project describes itself as a GUI client for Windows, Linux and macOS that supports Xray and sing-box and others. A client is the software that speaks a protocol; it does not provide the server on the other end. Downloading v2rayN gives you an empty interface until you supply a server configuration, which you either rent, self-host, or receive from a provider.

What is the difference between v2rayN and v2rayNG?

They are two different projects for two different platforms. The v2rayN README states plainly that v2rayN is the desktop version and points mobile users to v2rayNG, which is the Android application. Search suggestions mix the two constantly, so if you are looking for an Android client the NG suffix is the one you want.

Which platforms does v2rayN run on?

The README lists Windows on x64, x86 and arm64; Linux on x64, arm64, riscv64 and loong64; and macOS on x64 and arm64. So despite its reputation as a Windows tool, it is genuinely cross-platform on the desktop.

Which cores and protocols does it support?

It is a front-end for proxy cores rather than an implementation of its own, and the project explicitly supports Xray and sing-box, with a documented list of supported cores. The protocol topics listed on the repository include Shadowsocks, SOCKS5, Trojan, VLESS, VMess and XTLS.

Is v2rayN free and open source?

The repository is published under the GPL-3.0 licence, and releases are distributed through GitHub. Free in this context means the software costs nothing and its source is available. It does not mean the connectivity is free, because the server you point it at is a separate cost, whether that is a VPS you rent or a subscription you buy.