V2Ray client downloads,
choose a package for your platform

The main differences are the interface and runtime environment, not the proxy protocols. Desktop brings a next-generation interface to multiple desktop platforms, while WPF retains the classic Windows layout. If you already have a setup, stick with the version you know. Before migrating, export your subscription groups and custom routes so you don’t mistake an interface change for lost settings.

Both download options here are x64 packages. Before downloading, open Settings → System → About and confirm your system type. Once the download finishes, extract the entire archive before running the installer—don’t launch it from the archive utility’s temporary folder. If the installer reports a missing runtime component, follow its instructions instead of repeatedly switching nodes.

On first launch, check the local listening port, then import a subscription and select a node. The system proxy affects only apps that honor system proxy settings; it won’t automatically route every program. If an older version is still running in the background, both instances may try to use the same port. Exit the old process before testing the new version to help distinguish installation issues from connection issues.

Your Mac’s chip type is a better guide than its appearance or purchase year. Open About This Mac from the Apple menu: choose arm64 for a Mac with an Apple chip, or x64 for one with an Intel processor. Both packages do the same job; they differ in the architecture they run on. Use the native package for your Mac rather than choosing the other architecture for a matching interface.

Open the DMG and move the app to Applications, then launch it from there. Avoid running the app directly from the mounted image long-term, as this can make updates and permissions harder to manage. If macOS displays a security alert on first launch, verify the download source and follow the system’s per-app approval process. Don’t disable system security features altogether.

The system proxy settings in v2rayN need to work with your current network service. After switching between Wi-Fi, Ethernet, or another network tool, check the proxy address and port in your system network settings. TUN routes traffic differently and may require additional permissions. For your first setup, import a subscription and verify standard proxy mode before trying more complex modes.

On Linux, the package must match both your distribution’s package management system and your CPU architecture. deb and rpm are package formats, not proxy modes, and you can’t switch between them by changing a file extension. Choose deb for distributions such as Debian and Ubuntu, and rpm for systems such as Fedora and RHEL. Distribution tags in the filename and system library versions also affect compatibility—support for rpm doesn’t mean it will install on every rpm-based system.

Most desktop PCs use x64, shown as amd64 or x86_64 in package metadata. arm64 devices use arm64 or aarch64. Check your processor in System Information, or use the command below. v2rayN is a graphical client that requires a desktop session; don’t follow desktop installation steps on a terminal-only system.

uname -m

After downloading, open the package with your distribution’s software installer or package manager, which will handle dependencies. If it reports missing libraries, an architecture mismatch, or an unmet dependency version, resolve that first. Don’t force the installation past dependency errors and then blame proxy settings when the app won’t start. Package manager error messages are usually more useful for troubleshooting than downloading the installer again.

After installation, launch the graphical client in a regular user session, import a subscription, and check the local listening port. Linux desktop environments handle system proxy settings differently, and some command-line tools require proxy settings of their own. If you need to route more apps through the client, review the TUN permissions and routing instructions. Don’t run the entire desktop client with elevated permissions just to make your first connection.