This beginner guide explains how to install v2rayN on Windows 11, launch it safely, add a server subscription, select an appropriate core, enable the local proxy, and verify that traffic is actually using the selected node. It focuses on a clean first setup with v2rayN 7.x, Xray, a common local port such as 10808, and practical checks that help separate an installation problem from a subscription, node, or Windows proxy problem.
Before You Install v2rayN
v2rayN is a Windows graphical client that manages proxy profiles, subscription groups, local listeners, routing modes, and the Xray or V2Fly core process. It is not the remote server itself and it does not provide a server subscription. You need both the client application and a valid configuration source, such as an individual VMess or VLESS profile or a subscription URL supplied by your service administrator.
Windows 11 may display security warnings when an application has been downloaded from the internet or extracted from a compressed archive. This does not automatically mean that the program is damaged, but it is a reason to verify the download source, keep the original archive until the installation has been tested, and avoid replacing individual core files with random files from unrelated websites. A portable v2rayN installation normally runs from its extracted folder and does not require a traditional setup wizard.
- Use a current 64-bit Windows 11 system with permission to extract files and run a desktop application.
- Prepare the complete subscription URL or a complete node profile before opening v2rayN.
- Keep the system clock synchronized through Windows automatic date and time settings.
- Close older proxy clients temporarily so they do not occupy the same local ports.
- Do not enable several routing rule sets during the first test; a simple configuration is easier to diagnose.
Download and Extract the Client
Start from the site’s download center and choose the Windows package that matches your computer. The archive name and included files can change between releases, so do not rely on an old screenshot or copy only the executable from another installation. The core binaries, language files, configuration folders, and runtime libraries may all be needed for the application to start correctly.
-
Open the download page
Choose the current Windows v2rayN package from the download center. Save the archive locally instead of launching it from a browser’s temporary download view.
-
Check Windows security
Open the archive’s Properties dialog and review whether Windows marks it as downloaded from another computer. If the file is from a trusted source, use the available unblock option before extracting it.
-
Extract all files
Right-click the archive, select “Extract All,” and choose a short writable path such as
C:\Apps\v2rayN. Keep the folder structure created by the extractor. -
Launch the executable
Open the extracted folder and run the v2rayN executable. Allow the Windows firewall prompt only when you recognize the program and understand that the rule applies to the local client process.
-
Confirm the tray icon
Check the notification area and the main window for a normal startup. If the window closes immediately, inspect the files in the folder and review the runtime message before downloading another build.
On the first launch, Windows Defender or SmartScreen may show a reputation warning. Read the publisher and file information shown by Windows, then make a deliberate choice based on the source you used. Do not disable Windows security globally merely to start v2rayN. If an antivirus product quarantines a core executable, record the exact filename and detection message first; deleting and re-extracting the archive without understanding the alert can leave the installation incomplete.
Keep v2rayN in one stable folder after the first successful start. Moving the folder later can make shortcuts, scheduled startup entries, or manually referenced paths invalid. A portable client also stores operational data near its executable or in its application data location, so back up the configuration folder before performing a major upgrade.
Add a Subscription and Select the Core
Open the main v2rayN window and locate “Subscription Groups.” In the v2rayN 7.x interface, the exact wording can vary slightly by minor release or translation, but the workflow remains the same: create a group, paste the full URL, save it, and update the group. A subscription URL is sensitive account information. Treat it like a password, do not post it in a screenshot, and avoid pasting it into public URL shorteners or chat rooms.
VLESS plus Reality
- Protocol
- VLESS
- Transport
- TCP
- Security
- Reality
- Flow
- xtls-rprx-vision
A current Xray core is normally required; subscription import should fill the detailed identity parameters.
VMess plus WebSocket
- Protocol
- VMess
- Transport
- WebSocket
- Path
- /ws
- Security
- TLS or none
Often used for compatibility scenarios; the address, host, path, and TLS settings must match the server.
Use “Subscription Groups” → “Subscription Group Settings” → “Add” to create a group. Enter a descriptive name, paste the complete URL, and save it. Then use “Subscription Groups” → “Update All Subscriptions (Without Proxy)” for the first update. Updating without a proxy is easier to interpret because it tests whether Windows can reach the subscription address directly. If the provider requires an existing proxy to fetch the URL, use the proxy update option only after you have a working local profile.
After the update, the server list should contain aliases, protocols, addresses, and ports. Select one server and inspect its details rather than changing every field manually. A subscription may use VLESS, VMess, Trojan, Shadowsocks, or another supported format. The protocol name alone is not enough: transport, TLS or Reality security, server name, path, user identity, and flow settings must be consistent with the remote service.
For a first connection, choose Xray under “Settings” → “Parameter Settings” → “Core Type” when the imported profiles require Xray features such as VLESS with Reality. V2Fly can be useful for older VMess-oriented configurations, but switching between cores cannot repair an incorrect server address, expired subscription, wrong UUID, or invalid transport path. Save the core choice and reload the configuration before testing.
Enable the Proxy and Choose Routing
Connecting a node and routing application traffic through v2rayN are separate actions. First select a server in the list and start the core. Then use the system proxy control near the bottom of the main window to enable Windows proxy integration. In a common v2rayN setup, the local listener may use 127.0.0.1:10808 for mixed or SOCKS traffic and 127.0.0.1:10809 for HTTP traffic, but your installation may use different values. Always treat “Settings” → “Parameter Settings” and the visible client status as the source of truth.
- System proxy: sends traffic from applications that follow Windows proxy settings to the local v2rayN listener.
- Global mode: usually sends matching application requests through the proxy route, making it useful for a short diagnostic test.
- Rule mode: selects direct, proxy, or blocked behavior according to domain, IP, geolocation, and other rules.
- Direct mode: bypasses the proxy for testing or for applications that should use the normal network path.
Use global mode only as a temporary verification method. If a page works in global mode but fails in rule mode, the node may be healthy while the routing rules, DNS strategy, or domain classification needs attention. If nothing works in global mode, focus on the node, core startup, local listener, DNS resolution, system time, and remote port rather than adding more rules.
Bottom line: prove the local path before tuning rules
A working node test plus a listening local port is a much stronger installation milestone than a changed tray icon. Once 127.0.0.1:10808 responds and one real request succeeds, routing adjustments become controlled experiments instead of guesses.
Applications do not all handle proxy settings in the same way. A browser that follows Windows settings may work immediately after the system proxy is enabled, while a terminal tool may need explicit HTTP_PROXY and HTTPS_PROXY variables or its own command-line option. If you configure a browser manually, choose the correct proxy type and port. Sending HTTP proxy traffic to a SOCKS-only port can produce an immediate protocol error even when the v2rayN core is healthy.
Verify the First Connection
Do not stop at “Connected.” A usable setup needs several independent checks: the core remains running, the selected server passes a real connection latency test, the local port is listening, the browser or application is using the proxy, and a request returns the expected result. A regular ICMP Ping is not sufficient because it does not perform a VMess or VLESS handshake and does not validate the proxy transport.
| Check | Expected result | What failure suggests |
|---|---|---|
| Core startup | No immediate exit and no configuration parse error | Missing core file, invalid JSON, unsupported parameter, or blocked executable |
| Real connection latency | A repeatable result for the selected node | Address, port, time, TLS, identity, or remote availability problem |
| Local listener | The configured loopback port is listening | Core did not start, another program owns the port, or the port value was changed |
| Browser request | A test page loads while the system proxy is enabled | Browser override, routing issue, DNS failure, or direct connection fallback |
In the server list, right-click the selected profile and choose the real connection latency or connectivity test provided by your build. Test two or three servers from different regions rather than repeatedly testing one profile. A result around 120 to 250 milliseconds may be perfectly usable for ordinary browsing, while a low result does not guarantee stable throughput. Compare consistency, packet loss, and page loading behavior instead of selecting only the smallest displayed number.
Next, enable the system proxy and open a normal browser window. Visit a service that displays the public address or region of the request, then compare it with a direct test after disabling the system proxy. Do not use a single page as absolute proof: cached content, browser extensions, DNS behavior, and application-specific settings can obscure the result. A second browser or a private window can help separate cached data from a new proxied request.
The subscription updated, but the server list is empty. What should I check?
Confirm that the URL is complete, the subscription group is enabled, and the log does not show a timeout or format error. Try “Update All Subscriptions (Without Proxy)” again after checking direct network access.
v2rayN says connected, but the browser still uses the normal network.
Check that the system proxy switch is enabled, then open Windows “Settings” → “Network & Internet” → “Proxy.” Confirm that the browser has not configured a separate proxy and that it points to the current local port.
The real latency test fails on every imported server. Is the core wrong?
Not necessarily. Check the Windows clock, subscription freshness, DNS resolution, firewall permissions, and the node address first. A core change cannot fix an expired account or an unreachable remote port.
Why does one website work while another one times out?
Switch briefly to global mode. If the second site works there, review rule mode, DNS routing, and domain matching. If it still fails, inspect the core log and test another server.
Resolve Common Installation Problems
If v2rayN does not start, confirm that the archive was fully extracted and that the executable has not been quarantined. A missing DLL, blocked core file, or incomplete extraction can prevent the application from launching. Move the folder to a simple writable path, start the program once as a normal user, and inspect the runtime log. Running as administrator should be a targeted test, not the permanent solution for every startup problem.
If the application starts but the core exits immediately, inspect the first configuration error rather than the final “core stopped” message. The generated configuration may contain an unsupported protocol, malformed JSON, an invalid port, or a missing executable. Re-import the subscription if the profile was manually edited, then test one untouched server. Keep the selected core aligned with the imported protocol and feature set.
A port conflict is another common Windows 11 issue. If another proxy client is already using 127.0.0.1:10808 or 127.0.0.1:10809, v2rayN may fail to bind its listener. Close the competing application or change the v2rayN local port in “Settings” → “Parameter Settings.” After changing it, restart the core and update any browser or terminal proxy entry that still points to the old port.
When the subscription update fails, identify whether the URL itself is unreachable or whether its content cannot be parsed. A timeout points toward DNS, network access, firewall filtering, or a provider-side outage. A format or decode error points toward an incomplete URL, expired authorization, unexpected response content, or a subscription format that the current client cannot interpret. Preserve the exact timestamp and log wording when contacting the service administrator.
Finish with a Repeatable Windows 11 Workflow
Once the first node works, document the settings that produced the result: v2rayN version family, selected core, server alias, local port, routing mode, and the time of the successful test. This small record makes future troubleshooting much faster. If a later update breaks the setup, you can compare the changed item instead of rebuilding every setting from memory.
- Update the subscription only from the configured “Subscription Groups” menu.
- Test a real proxy connection after selecting a different server.
- Enable the system proxy only when the core and local listener are ready.
- Use rule mode for normal use, but use global mode briefly to isolate routing problems.
- Disable the system proxy before closing v2rayN if other applications should return to a direct connection.
- Back up the configuration folder before upgrading or moving the portable installation.
For a complete menu-by-menu configuration reference, continue with the setup tutorial. If the client is ready but the node cannot connect, compare the timestamped runtime messages with the server parameters and system clock. If the node passes a real test but applications still connect directly, investigate the Windows proxy entry and each application’s own proxy behavior rather than replacing the subscription immediately.