v2rayN
桌面版采用新一代跨平台界面,适合首次安装。WPF 版是 Windows 经典版本,适合已熟悉原有界面和操作路径的用户。两版选一套即可。
安装包选型
先选系统,再核对处理器架构。电脑使用 v2rayN;安卓设备首选 v2rayNG,需要 V2Fly 内核时选 v2flyNG。
桌面版采用新一代跨平台界面,适合首次安装。WPF 版是 Windows 经典版本,适合已熟悉原有界面和操作路径的用户。两版选一套即可。
| 检查项 | 要求与确认方式 |
|---|---|
| 系统 | 建议使用仍受支持的 Windows 11;旧系统先确认该构建及其运行库要求。 |
| 架构 | 此处为 x64 包。在「设置 → 系统 → 系统信息」查看系统类型及处理器。 |
| 安装 | 先解压 ZIP,再运行包内安装程序。若明确缺少运行库,按提示核对版本和架构。 |
区分系统位数和处理器架构。 系统写着「64 位」不一定代表是 x64 处理器。若设备使用 ARM,先确认当前 Windows 是否支持该 x64 构建的仿真运行;这里提供的两个入口都不是原生 ARM 包。
安装前退出旧版。 关闭窗口后检查任务栏通知区域,若图标仍在,使用托盘菜单退出。两套程序同时启动可能争用监听端口,或者先后修改同一份系统代理设置。第一次运行时先确认界面正常,再导入配置,不要同时开启系统代理和 TUN 来试错。
如果安装程序一启动就报错,先保留报错原文,区分「安装程序无法运行」「客户端窗口无法打开」和「打开后连接失败」。前两类先查系统、运行库或安装目录权限;界面正常而连接失败时,再查配置和网络,不必先换另一个界面版本。
在苹果菜单打开「关于本机」。显示 Apple M 系列芯片就选 Apple Silicon;显示 Intel 处理器就选 Intel。不要按外观或购买年份判断。
| 检查项 | 要求与确认方式 |
|---|---|
| 系统 | 使用仍受支持的 macOS;旧系统需核对所选构建的最低版本要求。 |
| 芯片 | Apple Silicon 对应 arm64;Intel 对应 x64。 |
| 安装 | 打开 DMG,按镜像内说明将应用移到「应用程序」后启动。 |
复制完成后再推出镜像。 不要把挂载的镜像当作应用的常用启动位置。如果新版安装后仍打开旧版,在访达的「应用程序」中直接启动新副本,并确认程序坞里的旧图标是否仍指向另一份应用。
若系统提示当前 macOS 版本不兼容,优先确认系统版本;若提示无法运行该应用,再核对芯片与所下载文件的架构。遇到安全提示时先读清原因,区分未识别开发者、应用损坏和系统版本不符,不要把这些提示一概当成网络问题,也不要全局关闭系统保护。
使用 Xray 内核。2015 年后推出的主流手机通常可选 arm64;确认系统支持 arm64-v8a 后再选。架构不确定时可先选通用版。
使用 V2Fly 内核。只有在现有配置所需的协议和传输方式得到该构建支持时,才用它替换原客户端。通用版覆盖更多架构,功能选项不会因此增加。
| 检查项 | 要求与确认方式 |
|---|---|
| 系统 | 在「关于手机」查看 Android 版本;设备须满足所选构建的最低系统要求和安装策略。 |
| 架构 | 以系统支持的应用 ABI 为准,不能仅凭芯片是 64 位就认定可安装 arm64 包。 |
| 安装 | 设备需允许所用浏览器或文件管理器发起安装;受管理设备以管理员策略为准。 |
安装授权和连接授权是两件事。 系统可能先要求允许当前下载来源安装应用;完成后可撤销这项授权。首次启动代理服务时,还可能弹出系统 VPN 连接请求。安装成功只说明应用可运行,不代表已经授权建立连接,也不代表配置已导入。
从其他构建升级时,若提示「应用未安装」,先记录系统提示,不要立即删除原应用。系统可能因架构不匹配、应用签名不同、目标版本低于已安装版本或设备策略而拒绝安装。先确认原因,再判断是换包还是备份后迁移;卸载通常会一并清除该应用的本地数据。
v2rayn_7.24.1_arm64.deb
v2rayN-7.24.1-1.el10.aarch64.rpm
Debian、Ubuntu 系通常选 DEB。使用 RPM 的系统应先检查发行版与依赖;此处的 RPM 文件名标有 el10,仅支持安装 RPM 不代表一定兼容。
| 检查项 | 要求与确认方式 |
|---|---|
| 环境 | 需要图形桌面会话,并满足所选构建的系统依赖。 |
| 架构 | uname -m 输出 x86_64 对应 x64;aarch64 对应 arm64。混合架构环境以包管理器的目标架构为准。 |
| 格式 | 根据发行版选 DEB 或 RPM,由系统的软件安装工具处理依赖。 |
架构和包格式要分别匹配。 DEB 使用 amd64 表示 x64,并非只适用于 AMD 处理器;RPM 通常写作 x86_64。同样,DEB 的 arm64 与 RPM 的 aarch64 都指 64 位 ARM,但包格式不能互换。
如果软件安装工具提示依赖不可满足,保留第一条缺失依赖或版本冲突提示,先核对发行版版本和软件源状态。不要强制跳过依赖或把其他发行版的包混装进系统。若安装成功但从应用菜单启动无响应,再检查是否处于图形会话,并区分应用启动异常与代理配置错误。
选定平台后,以按钮下方的文件名确认格式和架构。浏览器如果仍显示下载进行中,先等文件下载结束再打开。若保存结果是网页而不是安装包,回到入口重试,并记录浏览器显示的是网络错误、访问受限还是链接失效。不要单靠改后缀把网页变成安装包。
如果卡片上的清单版本与文件名不同,先区分应用级版本字段与具体下载入口。选包以该入口的文件名为参考,升级前再对照已安装版本。不要因为下载时间更近,就把刚保存的文件当作更新版本,也不要仅凭压缩包名称推断已运行的程序已经替换成功。
更换版本前,先记录当前客户端、订阅分组、默认选中的节点和自定义路由。只保存订阅地址不等于备份完整配置:手动录入的节点、本地监听端口和路由规则可能需要另行导出。订阅地址可能带有访问凭据,备份文件应留在受控设备,不要贴到公开工单或聊天群里。
安装完先看程序能否启动,再确认旧配置是否已读取。如果需要手动恢复,先导入必要配置并检查列表,不要先覆盖整个新目录。旧版或旧备份先保留,直到新版能启动、能读取配置且完成连接验证,再决定是否清理。
新装客户端时,列表为空属正常情况。把已有订阅导入相应分组并手动更新,或添加已知的服务器配置。确认节点列表加载后选中一个节点,再检查客户端日志是否有启动错误。订阅更新失败发生在取配置阶段,不等同于已导入节点无法连接,两者应分开排查。
桌面端还应区分客户端正在运行与目标应用使用了代理。先用一个已知可访问的站点验证,再检查目标应用是否遵循系统代理设置。启用 TUN 或修改路由前,先保留一组已验证可用的基础设置,每次只改一项。具体操作见订阅导入与连接教程;如果日志已指出端口占用,参见本地监听端口排查。
卡片上的版本来自应用清单,文件名对应具体入口,两者可能不同步。下载前先看所选入口的文件名;安装后要确认实际版本,请查看客户端的关于页面或系统应用信息。
不需要。新装可以先选采用跨平台界面的桌面版;熟悉经典界面或需要延续既有操作习惯,可选 WPF 版。切换前备份配置并彻底退出旧版,避免两套程序同时接管系统代理或争用本地监听端口。
只有问题出在架构适配时,换通用包才可能有用。还需检查系统版本、可用空间,以及目标应用是否已安装了签名不同或版本更高的构建。若系统明确提示签名冲突,先备份配置,再决定是否卸载旧应用。
升级前先退出客户端,再用客户端提供的导出功能保存配置,或按当前版本的说明备份数据目录。记录订阅分组、自定义路由、本地端口和代理模式。确认新版读到了配置后,再清理旧目录或旧应用。
安装包只提供客户端。需要先导入已有的订阅或服务器配置;使用订阅时,还要执行更新并检查列表是否出现节点。先确认配置已读取,再选择节点、启用所需的代理方式并测试连接。