Install guide About 9 min

Install v2rayN on Windows: unzip, allowlist, and first connection

On Windows, v2rayN is usually a portable build: download the zip, extract fully, and run the main program. Below is a real-world order that gets you to a stable first connection.

Confirm three things before installing

Before downloading, confirm you are on Windows and need a desktop client—not an Android APK. The default for Windows is v2rayN, not v2rayNG or v2flyNG. Prefer a 64-bit system; most PCs today are x64. Prepare a non-system-drive folder, such as D: or a dedicated folder under Documents—updates and antivirus allowlisting are easier later.

Also prepare a subscription URL, or at least one working node share link. Without nodes, you can finish install but cannot verify the proxy. You can add a subscription later, but importing on first install saves a lot of back-and-forth.

Step 1: download the correct Windows package

Open this site’s Download Center, switch to v2rayN, and filter by Windows. Most PCs should take the Windows x64 zip; choose ARM64 only if you run Windows on ARM. Avoid similarly named unknown bundles, especially repacked builds with bundled plugins.

After download, check the filename and format look right. Windows v2rayN packages are usually zip. If the browser rewrote the extension or the file is oddly small, do not extract and run—redownload. Note the version and update date from the Download Center for later compatibility checks.

Step 2: extract fully—do not pull out only the exe

Extract the archive to a target folder, for example D:\Apps\v2rayN. The key is a full extract: the folder usually also contains core files, config-related files, and dependencies. Dragging only v2rayN.exe to the desktop alone often causes launch failures or missing features.

Avoid overly deep paths, odd special characters, and system folders that need admin write access. The portable build’s strength is control—put it where you have full read/write rights so overwriting on update is easy. Keep the original zip for a while so you can retry quickly if install fails.

Step 3: run the app and handle antivirus / Windows security blocks

Double-click to run v2rayN.exe. On first launch, Windows Defender or other security software may block, quarantine, or warn. That is not rare for open-source proxy clients and does not automatically mean the file is malicious—but you should still only use packages from trusted channels. If blocked, add the whole v2rayN folder to trust/exclusions, then reopen.

If double-click does nothing, check quarantine first, then whether the extract is complete, then extract again to a new folder under your user account. Occasionally a shortcut points at an old path, creating the illusion that a fresh download will not open. Run the main program from the real extract folder to locate the issue.

Step 4: import a subscription or node

Once the client opens, add a subscription URL and update; if you only have a single vmess://vless://trojan://ss:// link, you can also import it manually. Subscriptions suit bulk management; single nodes suit quick verification. On first use, get “online” working before diving into groups, latency tests, and complex routing.

After import, check that usable entries appear in the node list. If update fails, do not rush to reinstall—first check that the subscription URL is complete and not expired, that the current network can reach it, and that system time is correct. Treat subscription issues separately from install issues to avoid misdiagnosis.

Step 5: enable system proxy and verify the connection

Pick a relatively low-latency node, then enable system proxy. For beginners, system proxy is usually better than TUN: simple setup, covering browsers and most apps. Do not run multiple proxy tools at once on first install—rules will conflict.

Verification is straightforward: open a page in the browser and confirm it loads. If the client shows connected but the page fails, check that system proxy is truly on, whether the browser still uses another proxy extension, and try another node. If it still fails, revisit whether the subscription expired, or read the system proxy vs TUN article to see if mode choice is the issue.

Update and everyday usage tips

To update Windows v2rayN later, exit the client and extract the new version over the same folder. Back up config first if you worry about wiping personal subscription data. Avoid keeping many scattered extract folders—you will never know which one is running.

For daily use, keep two habits: refresh subscriptions regularly, and pick nodes by latency and stability. The tool solves how you connect; node quality still depends on your provider. Get install path, allowlisting, and the proxy toggle solid, and Windows v2rayN has completed the essential onboarding loop.