先选与你的系统、架构对应的文件,再运行程序、导入配置。导入订阅后,还要检查内容是否获取成功、是否完成解析。列表里出现配置,不代表代理已经启用。
Windows 与 macOS:先分清文件类型
截至 2026-11-08,v2rayN 的最新正式版为 7.25.6。下载可进入项目的 GitHub 发布页。核对仓库名称应为 2dust/v2rayN,再查看文件名。
截至 2026-11-08,项目 Wiki 列出的系统要求与文件区别如下:
| 系统 | 系统要求 | 文件怎么区分 |
|---|---|---|
| Windows | Windows 10 及以上 | x64、arm64 各有两种界面文件;带 -desktop 的是 Avalonia UI,另一种是 WPF |
| macOS | macOS 13.6 及以上 | 分 x64、arm64;dmg 用于安装,zip 用于便携运行 |
选择时要同时核对系统、架构和扩展名,不能只看名称中是否包含 v2rayN。压缩包属于便携形式,解压后即可运行;相关数据保存在所在文件夹,不同副本可以独立使用。安装形式的数据则放在系统规定的用户位置。
截至 2026-11-08,Windows 发布文件中还列有名称带 -86 的压缩包。README 的平台表标记支持 x86;Wiki Faq 却表示,开发与测试没有在相应系统中验证,并提到需要自行编译。这些说法来自不同项目页面,不能据此保证对应文件在每台电脑上都能运行。
需要逐项核对包名,可查看下载文件与架构的对应说明。
Linux:按发行版与架构核对
截至 2026-11-08,Wiki 写明的最低发行版要求为 Debian 12、Ubuntu 22.04、Fedora 36、Red Hat 9,或各自更高版本。
| 文件类型 | Wiki 对应说明 |
|---|---|
deb | 用于 Debian、Ubuntu |
rpm | 用于 Fedora、Red Hat |
zip | 便携形式,解压运行 |
架构支持表与实际文件列表需要分开看。截至 2026-11-08,README 的 Linux 表格标记了 x86、ppc64le;7.25.6 发布页却没有这两种架构的文件。Wiki 的 Linux 说明列出 x64、arm64,而发布页还提供 riscv64、loong64 的安装文件。
另一个差异是 rpm 文件名:Wiki 写的是 v2rayN-linux-rhel-x64.rpm,同版发布页列出的则是 v2rayN-linux-rhel-64.rpm。下载时应逐字核对发布页中的实际名称。
Android 与 iOS:不要混用桌面端文件
v2rayN 是桌面客户端。Android 应查看 2dust/v2rayNG 项目,可进入 v2rayNG 发布页。
v2rayN、v2rayNG 均没有 iOS 版本。iOS 相关内容可另阅小火箭资料站:小火箭.top。
订阅链接怎么导入
先辨认手中内容:订阅地址与单个节点的分享链接,会进入不同的处理流程。
截至 2026-11-08,按 7.25.6 的菜单文字与 Wiki 说明,可以使用以下入口:
| 手中内容 | 操作入口 | 程序如何处理 |
|---|---|---|
| 已复制的分享内容 | 「从剪贴板导入分享链接」 | 读取剪贴板,尝试识别内容格式 |
| 屏幕上的二维码 | 「扫描屏幕上的二维码」 | 扫描后导入分享内容 |
| 图片中的二维码 | 「扫描图片中的二维码」 | 从图片识别分享内容 |
| 需要维护的订阅 | 「订阅分组设置」 | 配置分组及其更新字段 |
使用剪贴板导入时,也可在非输入框区域按 Ctrl+V。Wiki 说明,程序会尝试解析 BASE64 和明文;遇到以 https 起始的内容,会进入新增订阅流程,识别到标准协议分享链接则新增配置。
因此,粘贴订阅地址与粘贴单个分享链接,得到的结果不一定相同。不能只用“粘贴后有没有新增一行”判断订阅是否已经更新。
分组中有「启用更新」与「自动更新间隔 (分钟)」字段。手动更新还区分全部订阅、当前订阅,以及是否通过代理。操作前先确认要更新的范围。更多说明见订阅导入与更新流程。
多节点管理:先确认导入结果,再选节点
订阅更新与剪贴板导入,应分别核对结果。更新订阅时,日志会依次反映请求内容、获取完成、解析处理和流程结束。仅看到流程结束,还应回看中间是否出现异常。
截至 2026-11-08,7.25.6 中可见的异常提示包括:
| 提示 | 应核对的环节 |
|---|---|
| 「未设置有效的订阅」 | 订阅设置 |
| 「无效的订阅内容」 | 已获取内容的识别结果 |
| 「导入订阅内容失败」 | 内容导入环节 |
| 「未启用更新」 | 分组的更新开关 |
这些文字不能直接解释失败原因。官方没有说明各条提示与故障原因的一一对应关系。
选中节点的具体操作、测速入口和测速结果应如何判断,官方没有说明。看到导入成功提示,只能确认对应导入动作的结果,不能据此判断该节点已经启用。
代理模式怎么选、怎样启用
导入配置与启用代理是两个操作环节。代理模式的完整菜单、各模式含义,以及从选中节点到启用的连续操作,官方没有说明。
截至 2026-11-08,已明确的是:Windows 使用 Tun 需要管理员权限。这个权限要求不能替代其他代理设置,也不能作为连接成功的判断依据。
进阶:路由规则与 DNS
截至 2026-11-08,7.25.6 的 Avalonia 界面定义中,「设置」下包含「路由设置」。具体规则如何填写、DNS 参数如何选择,官方没有说明。
不要把订阅更新、路由调整和 DNS 修改合并成同一次排查。先保留出现问题时的提示,再确认问题发生在下载、导入还是更新环节,便于继续核对。
常见故障:从提示所在环节查起
下载文件不确定时,回到发布页核对系统、架构与扩展名;订阅没有更新时,查看分组是否启用更新,以及日志是否完成获取和解析。二维码导入失败的系统权限处理,官方没有说明。
截至 2026-11-08,Wiki Faq 指出,程序更新相关日志位于 guiLogs。需要继续查看提示文字,可阅读常见报错与日志核对说明。
本文涉及的版本、系统门槛、文件列表及界面文字均以截至 2026-11-08 的记录为准;项目发布新版本或调整 Wiki 后,应重新核对。
第三方整理,与项目方无关。
文件与版本一律以项目发布页为准,下载前先核对来源。