客户端下载
v2rayN 下载与安装指南
v2rayN 没有官方网站，唯一的官方下载入口就是 GitHub Release。下面给出地址，再说清楚下哪个文件、怎么确认文件没被换过、以及装完报错怎么查。
官方下载地址
仓库是 2dust/v2rayN，除此之外没有任何官方发布渠道。
「v2rayN 官网」这个搜索本身就是个坑
v2rayN 从来没有做过官方网站。它只有一个 GitHub 仓库，发布也只走 Release 页面。所以当你搜「v2rayN 官网」并点进某个看起来很正式的下载站时，那一定不是官方的——因为官方根本不存在这么一个页面。
这类第三方站点未必都有恶意，但代理客户端经手的是你全部的上下行流量，装上一个被改过的版本，从外观上完全看不出来。判断方法很简单：地址栏不是
github.com/2dust/v2rayN
就别下。
这里同样不写具体版本号——版本几周就会变，Release 页面永远是最新的那个。另外，客户端本身不含节点，装完还需要一份订阅才能用；手上还没有的话可以先看机场推荐排行榜，细节放在文章后面说。
下载哪个文件
Release 页面文件不少，绝大多数人只需要其中一个。
| 系统 | 最低版本 | 架构 | 格式 |
|---|---|---|---|
| Windows | Windows 10 及以上 | x64、x86、arm64 | .zip |
| 普通 zip 是 WPF 界面，带 -desktop 的是 Avalonia 界面，功能一样，挑顺眼的就行。 | |||
| macOS | macOS 13.6 及以上 | x64、arm64 | .dmg |
| dmg 没有签名，第一次打开会提示「已损坏」，解决办法见下面的常见故障。 | |||
| Linux | Debian 12+ / Ubuntu 22.04+ / Fedora 36+ / RHEL 9+ | x64、arm64、riscv64、loong64 | .deb / .rpm / .zip |
| 架构覆盖比大多数客户端都全，riscv64 和龙芯都有现成包。 | |||
它是绿色版，不用安装
Windows 和 Linux 的 zip 解压出来直接运行就行，配置和数据都留在同一个文件夹里，卸载就是删文件夹。顺带一个实用技巧：把整个文件夹复制一份、改掉里面的监听端口，就能同时跑两个互不干扰的实例。
路径建议用纯英文、不带空格，也别放进需要管理员权限才能写入的目录——官方 FAQ 里的报错有相当一部分都是这个原因。
怎么确认下载的文件没被换过
v2rayN 给每个发行文件都做了签名，这在同类客户端里并不常见。
Release 页面上每个安装包旁边都有一个同名的
.sig
文件，公钥
v2rayN-public-key.asc
也放在同一页。项目把理由写得很直白：防止镜像站、运营商和 CDN 在传输过程中掉包。
对大多数人来说，只要是从 GitHub 原地址下载的就够了。但如果你因为网络原因用了某个镜像，那这一步就很值得做——把安装包、.sig 和公钥都下下来，导入公钥之后校验一次，几十秒的事，能确认拿到的就是作者发布的那个文件。
v2rayN 和 v2rayNG 是两个东西
同一个作者，名字只差一个字母，装错了会白折腾。
它为什么能兼容那么多协议
关键不在界面，在于发行包里带了几个内核。
能不能连上某个节点，取决于内核支不支持那个协议，和客户端界面没什么关系。v2rayN 的发行包里同时带了三个内核，所以下面这张表它基本全覆盖：
| 协议 | Xray | sing-box | mihomo |
|---|---|---|---|
| VMess / Shadowsocks / Trojan | ✓ | ✓ | ✓ |
| VLESS | ✓ | ✓ | ✓ |
| REALITY | ✓ | ✓ | ✓ |
| Hysteria 2 | — | ✓ | ✓ |
| TUIC | — | ✓ | ✓ |
Hysteria 2 和 TUIC 这两个 Xray 内核本身不支持，靠 sing-box 和 mihomo 补上。所以如果你的机场给的是这类节点，用 v2rayN 通常不用额外折腾。
装完不对劲？先看这些
内容整理自项目自己的 Wiki FAQ。
Windows
系统代理只有 HTTP，没有 SOCKS
这是 Windows 自己的限制，它的系统代理设置只支持 HTTP，不支持 SOCKS5。需要 SOCKS 的程序得在程序自己的设置里填代理地址。
macOS
提示「应用已损坏，无法打开」
不是真的损坏，是 dmg 没有签名，被 Gatekeeper 拦下了。在终端执行 xattr -cr /Applications/v2rayN.app 之后再打开即可。
自动设置系统代理没反应，也不报错
macOS 上这个功能是靠调用脚本实现的，失败的时候界面上看不出来，去 guiLogs 里找具体原因。
通用
测速或测延迟时提示「核心启动失败」
通常是配置有问题、内核不再支持这份配置，或者本地监听端口被别的程序占了——装了虚拟机的机器特别容易遇到。把日志级别调成 Debug 再看一次会清楚很多。
不知道去哪看日志
分两个地方：界面、设置、测速相关的问题看 guiLogs 文件夹；节点和连接本身的问题看主界面下方的信息栏。
装在中文路径或者 Program Files 里之后各种报错
官方建议路径用纯英文、不要带空格，也不要放在需要额外权限才能写入的目录。它是绿色版，放哪都行，换个地方解压就好。
更完整的清单在官方 Wiki里。另外，Windows 7 官方的说法是「理论上可行」，但需要自己往 bin 目录里手动放特制内核，还依赖 .NET 8——不建议为了它折腾，换台机器或者升级系统更省事。
装好了，然后呢
客户端本身不含节点，这一步是很多人卡住的地方。
v2rayN 只是个壳加几个内核，它不提供任何节点。装完之后你还需要一份订阅链接，导入进去、选一个节点连上才算能用。订阅要么来自机场服务，要么是自己搭的节点——自建要租服务器、自己配置和维护，大多数人图省事会直接买一份订阅，我们整理的机场推荐排行榜把在用的几家按线路、实测速度和性价比排了序，可以对照着挑。
v2rayN 对订阅格式的兼容性比 Clash 系客户端宽松一些，v2ray / vmess 这类链接也能直接吃。如果你更习惯 Clash 的规则体系，可以看看Clash Verge那篇。
v2rayN 常见问题
v2rayN 官网是哪个？
没有官网。v2rayN 只有 GitHub 仓库和 Release 页面，项目本身从来没有做过官方网站。所以搜索结果里任何自称「v2rayN 官网」的页面都是第三方做的，下载前请务必确认地址是 github.com/2dust/v2rayN。
v2rayN 下载哪个文件？
Windows 用户绝大多数下 x64 的 zip 就行。普通 zip 用的是 WPF 界面，带 -desktop 的用 Avalonia 界面，两者功能完全一样，只是界面框架不同。macOS 选对应芯片的 dmg，Linux 有 deb、rpm 和 zip 三种。
v2rayN 需要安装吗？
不需要。它是绿色便携版，解压出来直接运行就能用，数据也存在同一个文件夹里。想同时跑多个实例，把整个文件夹复制一份、改掉监听端口就可以。
v2rayN 和 v2rayNG 有什么区别？
是同一个作者的两个项目：v2rayN 是桌面版，跑在 Windows、macOS 和 Linux 上；v2rayNG 是安卓版。名字只差一个字母，但仓库和安装包都是分开的，别下错。
macOS 上提示「应用已损坏」怎么办？
这不是文件坏了，而是 dmg 没有做签名，被系统的 Gatekeeper 拦住了。在终端里执行 xattr -cr /Applications/v2rayN.app，然后重新打开就可以了。
v2rayN 支持 Hysteria 2 和 TUIC 吗？
支持。这两个协议 Xray 内核本身不支持，但 v2rayN 的发行包里同时带了 Xray、sing-box 和 mihomo 三个内核，缺的那部分由后两个补上，所以常见协议基本都能覆盖。