v2rayN
A cross-platform GUI proxy client supporting Xray and sing-box.
Download v2rayN
Installer for Apple Silicon (M1/M2/M3) Macs (.dmg)
Other downloads (3)
Getting a "can't verify the developer" warning?
If you see a warning on first launch, go to System Settings > Privacy & Security and click "Open Anyway". Open source software usually isn't signed with an Apple developer certificate, which is normal.
Clicking "Download" takes you to a source confirmation page first; the download starts after confirmation.
About v2rayN
A GUI client for Windows, Linux and macOS, support Xray and sing-box and others
See incorrect information? Tell us
Risk notice
As a proxy client, v2rayN's real-world performance depends on the nodes and services you configure. Please use it in compliance with local laws and regulations. Release files are signed with GPG; we recommend verifying them after download. Without verification, there is no guarantee that the files have not been tampered with. The macOS version is not distributed through the Mac App Store, so the first launch may trigger a system security prompt requiring manual approval.
Who it's for
- Users who need a graphical interface to manage proxy connections on Windows, Linux, or macOS
- Users running Xray, sing-box, or other supported cores and wanting a unified UI
- Users who need multiple package formats (deb/rpm/dmg/zip) for different systems
- Users who prefer verifying downloaded files with GPG signatures
Who it's not for
- Users who expect a zero-configuration, out-of-the-box experience
- Users who only need a browser-level proxy extension and not a standalone client
- Users who do not wish to accept the GPL-3.0 license
Install guide
v2rayN Installation Guide
1. Before You Download
- Determine your operating system and CPU architecture: Windows (x86 / x64 / arm64); Linux (x64 / arm64 / riscv64 / loong64); macOS (x64 for Intel / arm64 for Apple Silicon).
- We recommend also downloading the matching
.sigsignature file andv2rayN-public-key.ascto verify package integrity.
2. Verify Signature (Optional)
gpg --import v2rayN-public-key.asc
gpg --verify v2rayN-windows-64.zip.sig v2rayN-windows-64.zip (Replace the filename with the one you actually downloaded.)
- Import the public key:
- Verify a file, for example Windows x64:
3. Install by Platform
Windows
- Recommended by this site:
v2rayN-windows-64.zip(for 64-bit systems). - If your PC is arm64, download
v2rayN-windows-arm64.zip. - For 32-bit (x86) systems, download
v2rayN-windows-86.zip. - Unzip the package and run
v2rayN.exefrom the extracted folder. - For a desktop shortcut, you may try the versions with
desktopin the name (e.g.,v2rayN-windows-64-desktop.zip).
macOS
- Recommended by this site:
v2rayN-macos-arm64.dmg(for Apple Silicon). - For Intel Macs, download
v2rayN-macos-64.dmg. - Open the dmg and drag
v2rayN.appinto the Applications folder. - On first launch, if macOS warns “cannot be opened because the developer cannot be verified,” go to System Settings → Privacy & Security and click “Open Anyway,” or right-click the app and select “Open.”
Linux
sudo dpkg -i v2rayN-linux-64.deb sudo rpm -ivh v2rayN-linux-rhel-64.rpm
- For Debian/Ubuntu (amd64): install
v2rayN-linux-64.deb; for arm64:v2rayN-linux-arm64.deb. - For RHEL/Fedora:
v2rayN-linux-rhel-64.rpmorv2rayN-linux-rhel-arm64.rpmdepending on architecture. - For other architectures (riscv64, loong64), choose the matching
.debor.rpmfile. - You can also download the zip version and run it directly.
- Example commands:
4. First Run
- v2rayN requires a proxy core such as Xray or sing-box to function. The installation package does not include core binaries. Please consult the official Wiki to learn how to download and configure the core.
- For configuration files, subscription import, and other settings, refer to the Wiki as well.
FAQ
Is v2rayN free?
Yes, v2rayN is open-source under the GPL-3.0 license.
Which operating systems and architectures are supported?
Windows (x86/x64/arm64), Linux (x64/arm64/riscv64/loong64), and macOS (x64/arm64). Choose the corresponding package for your device.
Do I need to install Xray or sing-box separately?
Yes. v2rayN is a GUI client; the core binaries are not bundled. Follow the official Wiki to download and configure a core.
How can I verify that my download is official?
Every release file has a matching `.sig` file and the public key `v2rayN-public-key.asc` is provided. Import the key and run `gpg --verify` to check the package.
How do I update to a new version?
Visit the GitHub Releases page and download the latest package, then install over the previous version. Check the release notes before updating.