跳到主要内容
机场图鉴 机场图鉴
客户端下载

v2rayN 下载:没有官网,只认 GitHub(附校验方法)

v2rayN 没有官方网站,唯一的官方下载入口就是 GitHub Release。下面给出地址,再说清楚下哪个文件、怎么确认文件没被换过、以及装完报错怎么查。

信息核对于 2026年9月23日 预计阅读 5 分钟 官方渠道直链 GPG 校验

官方下载地址

仓库是 2dust/v2rayN,除此之外没有任何官方发布渠道。

前往 GitHub Release
项目仓库 官方 Wiki / FAQ 本页信息核对于 2026年9月23日

「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 和龙芯(loong64)都有现成包。

它是绿色版,不用安装

Windows 和 Linux 的 zip 解压出来直接运行就行,配置和数据都留在同一个文件夹里,卸载就是删文件夹。顺带一个实用技巧:把整个文件夹复制一份、改掉里面的监听端口,就能同时跑两个互不干扰的实例。

路径建议用纯英文、不带空格,也别放进需要管理员权限才能写入的目录(如 C:\Program Files)——官方 FAQ 里的报错有相当一部分都是这个原因。

怎么确认下载的文件没被换过

v2rayN 给每个发行文件都做了签名,这在同类客户端里并不常见。

Release 页面上每个安装包旁边都有一个同名的 .sig 文件,公钥 v2rayN-public-key.asc 也放在同一页。项目把理由写得很直白:防止镜像站、运营商和 CDN 在传输过程中掉包。

对大多数人来说,只要是从 GitHub 原地址下载的就够了。但如果你因为网络原因用了某个镜像站,那这一步就很值得做——把安装包、.sig 和公钥都下下来,导入公钥之后校验一次,几十秒的事,能确认拿到的就是作者发布的那个文件。

GPG 校验操作指南(终端 / 命令行) Bash / PowerShell

第 1 步:导入作者官方公钥

gpg --import v2rayN-public-key.asc

第 2 步:验证安装包签名与完整性

gpg --verify v2rayN-windows-64.zip.sig v2rayN-windows-64.zip
输出显示「Good signature from ...」即证明压缩包完全属于作者本人原版构建,未被中间人篡改。

v2rayN 和 v2rayNG 是两个东西

同一个作者,名字只差一个字母,装错了会白折腾。

v2rayN

桌面端

支持 Windows / macOS / Linux。发行包里自带 Xray、sing-box、mihomo 三个内核,功能大而全。

v2rayNG

安卓端

专为 Android 安卓设备 设计。仓库和安装包都是独立的 APK 文件,内置的是 Xray 和 v2fly 内核。

它为什么能兼容那么多协议

关键不在界面,在于发行包里带了几个内核。

能不能连上某个节点,取决于内核支不支持那个协议,和客户端界面没什么关系。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。如果某个特殊程序需要走 SOCKS5 代理,需要在该程序自身的网络连接设置中单独填写本地 SOCKS 端口。

macOS

提示「应用已损坏,无法打开」

不是真的安装包损坏,而是 dmg 安装包没有购买苹果官方开发者证书签名,被系统安全机制 Gatekeeper 拦截。在 Mac 终端中运行以下命令移除拦截属性即可正常打开:

xattr -cr /Applications/v2rayN.app

自动设置系统代理没反应,也不报错

macOS 上这个功能是通过内部调用系统脚本实现的,调用失败时图形界面上看不出直接报错,建议前往程序目录下的 guiLogs 文件夹查看具体排错日志。

通用排查

测速或测延迟时提示「核心启动失败」

通常是配置参数有语法错误、当前使用的核心版本不再支持这份配置,或者本地监听端口被别的程序占了——装了 VMware / VirtualBox 虚拟机的机器特别容易遇到端口冲突。在设置中把日志级别调成 Debug 再看一次会清晰很多。

不知道去哪看日志

日志分为两个地方:界面、设置、测速相关的问题查看软件目录下的 guiLogs 文件夹;节点连接、握手和数据传输问题直接看主界面下方的信息栏输出。

装在中文路径或者 Program Files 里之后各种报错

官方强烈建议存放路径采用纯英文、不带空格,更不要放在需要额外管理员权限才能写入的目录。它是绿色便携版,放哪里都能直接跑,建议移动至 D 盘或用户个人文档根目录下解压使用。

更完整的故障排查清单可参考 官方 Wiki 知识库。另外,针对 Windows 7 用户,官方的说法是「理论上可行」,但需要自己往 bin 目录里手动放特制内核,且重度依赖 .NET 8 运行库——不建议为了旧系统折腾,换台机器或升级到 Windows 10/11 更省心。

装好了,然后呢

客户端本身不含节点,这一步是很多人卡住的地方。

v2rayN 只是个壳加几个内核,它不提供任何节点。装完之后你还需要一份订阅链接,导入进去、选一个节点连上才算能用。订阅要么来自机场服务,要么是自己搭的节点——自建要租服务器、自己配置和维护,大多数人图省事会直接买一份订阅,我们整理的机场推荐排行榜把在用的几家按线路、实测速度和性价比排了序,可以对照着挑。挑的时候留意每张卡片上的「使用方式」一栏:标着专属客户端的机场走的是自家 App,不发订阅链接,用不上 v2rayN。

v2rayN 对订阅格式的兼容性比 Clash 系客户端宽松一些,v2ray / vmess 这类原始格式链接也能直接吃。如果你更习惯基于分流策略组与规则体系的管理方式,也可以参考我们整理的 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 三个内核,缺的那部分由后两个补上,所以常见协议基本都能覆盖。

更喜欢 Clash 的规则体系与分流界面?

Clash Verge Rev 是目前最主流的桌面客户端,提供规则分组可视化与更简洁的日常操作体验。

阅读 Clash Verge 指南 →