v2ray.cn · Windows
V2Ray / v2rayN for Windows: download, install, and first-run guide
One release can contain many files. Confirm the operating system, CPU architecture, and package format before installation to avoid most compatibility failures.
platform and architecture choice
Project relationship and intended users
v2rayN is the graphical client; V2Ray or Xray may provide the connection core; subscriptions and share links provide server configuration. Record client, core, and configuration timestamps separately.
Check system and architecture
On Windows 10 or 11, confirm x64 or arm64. Install WebView2, Visual C++ runtime, or service components only through Microsoft or project documentation when required.
Package formats and filenames
An installer suits routine updates; a portable build suits isolated testing. Service mode, TUN, or firewall rules may require administrator approval.
Verify the release source first
Confirm the release through the official repository, release page, or platform store. A mirror can change delivery speed, but filename, tag, and checksum must still match the official record. Search snippets labeled latest can be stale.
- Open the official Releases page and confirm the owner
- Choose operating system and CPU architecture
- Compare filename, tag, and publication date
- Calculate SHA-256 when supplied
- Keep the release page and verification result
Before installation
Close old instances, back up required configuration, and confirm disk space and system time. Before an upgrade, record the old version and data path so a program change can be separated from a configuration change.
Installation steps
Run only a package traced to the verified release. Grant necessary permissions through normal platform prompts and do not permanently disable protection. Launch once and confirm the interface, version, and data path.
- Download the correct platform build
- Back up configuration or recovery data
- Install and launch once
- Prepare one configuration or account
- Validate one explicit function
- Enable advanced options one at a time
The smallest first-run loop
Import one known-good configuration, select an available endpoint or policy group, and enable the system proxy. Evaluate TUN only for applications that do not honor the system proxy.
Verify the result
Test one explicit outcome: the app opens, configuration loads, the required feature is enabled, and real behavior matches the status. A colored button alone is not evidence; compare logs and the target application.
Enable advanced settings in order
Complete one working loop on defaults, then change TUN, DNS, rule overrides, background behavior, or autostart one at a time. Record each result so the last change can be reversed.
Updates, backup, and rollback
Back up before updating. Afterward, check app and core versions before reusing configuration. Preserve logs and return to the last known-good state instead of deleting all data.
Security and privacy
Subscription URLs, recovery phrases, private keys, credentials, and debug logs may contain secrets. Redact them before screenshots or support requests and never paste them into unknown checkers.
Related pages
Related site guides
- v2ray.cn
- Choosing a client per platform: Windows / Android / macOS / iOS | v2ray.cn
- V2Ray Tutorials, Xray Configuration & Official Client Guides | v2ray.cn
- Installing v2rayN on Windows: from download to first connection | v2ray.cn
- v2rayNG on Android: QR codes, subscriptions and connecting | v2ray.cn
- What is a DNS leak, and why does it expose you even with a proxy on? | v2ray.cn