How to use v2rayN on Linux? Complete instructions for installing and using the desktop version

Many people don't know: v2rayN is rewritten with a cross-platform framework starting from 7.x. There is an official Linux desktop version——Ubuntu, Debian, Fedora and other desktop distributions can all run, and the interface is modeled after the Windows version. There is no need to painstakingly handwrite configuration files on Linux. This article talks about which package to download, how to install it, and several differences from the Windows version.

1Which package to download

Linux packages are not mirrored on this site yet, please check the official website GitHub Releases Page, select by file name:

• v2rayN-linux-64: Select this for regular Intel/AMD 64-bit computers; linux-arm64 for ARM devices.
• .deb package: Ubuntu / Debian / Mint users are preferred. After downloading, double-click to install it in the software center, or execute it in the terminal. sudo dpkg -i package name.deb.
• .zip carrying case: Common to any distribution, add executable permissions to the main program after decompression (chmod +x v2rayN) runs directly, the logic is the same as the green version of Windows.

2Do two things when starting for the first time

1. Complement the kernel: As with the Windows version, the kernel may not be included in the package. After startup, go to "Check for Updates" to download the Xray kernel (add sing-box if necessary), and it says that the kernel cannot be found. This is the reason.
2. Guide subscription: The operation is exactly the same as the Windows version - "Subscription" → "Subscription Group Settings", add address, and then update the subscription. If you're not familiar with it, just follow it Subscribe to import tutorial Just do it, the interface is the same.

3Three differences from the Windows version

• Effective scope of system agent: Under GNOME / KDE, v2rayN sets the system proxy corresponding to the proxy setting of the desktop environment. Firefox and Chrome generally follow; however, the command line program in the terminal does not follow this set of rules and needs to manually set the environment variables (export http_proxy=http://127.0.0.1:10809, https_proxy is the same), or simply turn on Tun.
• To escalate privileges in Tun mode: Taking over the network card under Linux requires root privileges. When opening Tun, you will be asked to authorize/enter a password, which is normal. If the authorization fails in the graphical environment pop-up window, use the terminal sudo Try starting it once.
• Start automatically at boot: If there is no Windows option, just add v2rayN to the "Startup Program" of the desktop environment (for GNOME, use Tweaks, for KDE, go to System Settings → Startup and Shutdown).

4Unreachable Linux-specific checkpoints

• If the browser has a proxy plug-in (such as SwitchyOmega) installed, the plug-in priority is higher than the system proxy. Check the current mode of the plug-in first.
• Confirm that the port is not occupied: Terminal ss -tlnp | grep 1080 Check whether 10808/10809 is occupied by other programs. The processing idea is the same. Port conflict tutorial.
• General troubleshooting (node failure, time out of sync, subscription expiration) has nothing to do with the platform. General troubleshooting for being unable to access the Internet Go through it again.

5Options beyond the desktop

If you just want to "have an agent available" on Linux and are not obsessed with the graphical interface: xray bare kernel can be run by adding a copy of config.json, with minimal resource usage and suitable for small hosts that are turned on all year round; desktop users do not need to bother - the v2rayN graphical version is more comfortable than handwritten JSON. See the corresponding client for Windows / macOS / Android devices. Downloads.