v2rayN
首推桌面版 Desktop 采用新一代跨平台 UI;经典 WPF 版保留熟悉的 Windows 界面,是适合既有使用习惯的经典稳定版。
下载得到 ZIP 文件后,先完整解压到独立目录,再运行其中的安装程序。不要直接在压缩文件预览窗口中启动,以免安装程序读取不到同目录资源。
首次使用选择其中一个版本即可。两版的菜单布局和设置入口可能不同,教程中的功能名称可作为定位依据,不必逐项寻找完全相同的位置。
先选操作系统,再选处理器架构。桌面使用 v2rayN,安卓优先使用 v2rayNG;已有 V2Fly 配置时可选 v2flyNG。
首次安装与订阅导入教程两个入口均为 x64 安装包,首次安装优先选择桌面版。
桌面版 Desktop 采用新一代跨平台 UI;经典 WPF 版保留熟悉的 Windows 界面,是适合既有使用习惯的经典稳定版。
下载得到 ZIP 文件后,先完整解压到独立目录,再运行其中的安装程序。不要直接在压缩文件预览窗口中启动,以免安装程序读取不到同目录资源。
首次使用选择其中一个版本即可。两版的菜单布局和设置入口可能不同,教程中的功能名称可作为定位依据,不必逐项寻找完全相同的位置。
已经使用经典界面的用户,可以继续选择 WPF 版;希望在不同桌面系统上保持相近操作方式时,可选择 Desktop。版本选择主要影响界面与运行环境,并不代表安装后就具备可用的服务器。订阅、当前服务器和路由模式仍需要单独配置。
切换版本前,先导出已有服务器、订阅分组和自定义路由,退出旧程序,再启动新版本。两个客户端同时运行,可能竞争本地监听端口,也可能相互覆盖系统代理。若出现端口占用,先确认旧实例是否仍在托盘中运行,而不是立即修改所有端口。
在“关于本机”查看芯片信息,选择对应的 DMG 安装包。
芯片一栏显示 Apple M 系列时选择 Apple Silicon;显示 Intel 处理器时选择 Intel。两个入口对应不同架构,不需要同时安装。
打开 DMG 后,将应用复制到“应用程序”目录,再从该目录启动。复制完成后可以推出磁盘映像,避免一直从临时挂载位置运行。
优先使用与芯片一致的原生架构包,不要把兼容性转换当作默认安装方式。若出现架构不匹配提示,重新查看芯片信息并选择另一个入口。
首次打开后先完成订阅导入,确认列表内已经出现服务器,再选择当前服务器并启用系统代理。仅打开应用窗口不等于代理已经生效;有些应用会忽略系统代理,需要在应用自身设置中指定代理,或在理解影响范围后考虑 TUN 模式。
准备退出客户端时,先清除系统代理,再退出程序。如果客户端已经关闭而浏览器仍尝试连接本地代理端口,可能出现普通网页也无法访问的情况。此时应检查系统网络设置中的代理项目,而不是直接认定服务器失效。配置变更较多时,先恢复到普通系统代理模式,再逐项验证。
优先选择 v2rayNG;需要 V2Fly 内核时再选择 v2flyNG。
适合安卓日常使用,支持订阅管理与规则分流。2015 年后的主流手机优先选择 arm64,系统架构不明确时可选通用版。
通用版包含多种处理器架构,通常体积更大。部分较早设备或采用特殊系统的手机,即使处理器支持 64 位,也可能运行 32 位系统,应以实际系统兼容性为准。
适合已有 V2Fly 配置或需要相应内核行为的用户。安装前先确认服务器协议与传输配置兼容,不要仅依据客户端名称判断支持范围。
与 v2rayNG 使用不同内核,配置字段和协议能力并非完全一致。迁移前先保存原订阅和自定义规则,导入后用单个服务器验证,再恢复复杂分流设置。
| 检查项 | 选择与说明 | 遇到问题时 |
|---|---|---|
| 处理器架构 | 多数现代手机选 arm64;不确定时选通用版。 | 安装提示不兼容时,先核对系统架构。 |
| 系统版本 | 最低版本由当前 APK 决定,以系统安装器提示为准。 | 旧系统可能需要升级,通用版不能解决系统版本过低。 |
| 安装授权 | 为实际打开 APK 的浏览器或文件管理器授权。 | 安装完成后可关闭该来源的安装权限。 |
| 连接授权 | 启动连接时确认系统 VPN 授权提示。 | 检查其他 VPN 应用是否占用了同一连接位置。 |
下载完成后,从浏览器下载记录或文件管理器中打开 APK。安卓对应用来源的授权通常按应用分别管理,授权浏览器并不代表文件管理器也已获准。若安装器提示签名冲突,先保存原有配置并确认已安装应用的来源,不要在没有备份的情况下直接卸载。
首次连接会出现系统 VPN 授权,这是客户端在安卓上接管流量所需的系统接口,不代表导入的服务器已经可用。连接成功后仍需用实际应用验证。如果锁屏后连接经常中断,可检查电池优化、后台运行和省电模式;一次只调整一个选项,观察是否改善,避免同时改动订阅、路由和后台策略。
先按发行版选择 deb 或 rpm,再确认处理器为 x64 还是 arm64。
常见 Intel 与 AMD 桌面设备选择 x64。Debian、Ubuntu 系通常使用 deb;Fedora、RHEL 系通常使用 rpm,具体依赖仍需由发行版包管理器确认。
使用系统软件安装器打开软件包,查看依赖和安装提示后继续。包格式匹配不等于所有发行版都满足依赖;若安装器报告缺少组件,应先确认发行版版本是否适合当前包。
Linux 桌面环境对系统代理的实现存在差异。客户端启动并监听本地端口后,部分应用仍可能需要手动填写代理地址与端口。先用一个明确支持代理设置的应用验证,再判断是否需要 TUN;不要只看桌面代理开关就认定所有程序都已接入。
普通图形界面优先以日常用户身份运行,避免因使用高权限账户启动而产生配置目录归属问题。若确实需要 TUN,按客户端提示授予所需权限。更新前退出旧实例,确认软件包架构与已安装版本一致;安装后检查订阅分组、路由规则及本地端口是否按预期保留。
安装包解决的是客户端部署;服务器配置、代理模式和网络验证需要接着完成。按下面的顺序检查,更容易区分问题出在安装还是连接。
先确认操作系统,再看架构与文件类型。Windows 的 ZIP 需要先解压,macOS 使用 DMG,安卓使用 APK,Linux 使用发行版匹配的软件包。不要通过重命名扩展名让文件“适配”另一个系统;下载完成后浏览器仍显示进行中时,也不要提前打开临时文件。
客户端本身不附带可用服务器。将已有订阅地址粘贴到订阅管理中,保存分组并执行更新;如果使用单个服务器分享链接,则从剪贴板导入。列表出现记录后,明确选择一个作为当前服务器。订阅更新成功只能说明配置已获取,不代表每个服务器都能正常建立连接。
桌面首次使用可先从系统代理开始,安卓按提示启动 VPN 连接。先保持默认规则分流,用实际网页或应用测试,再考虑调整 TUN、DNS 和自定义路由。测试时同时观察日志:本地监听失败与远端连接超时属于不同阶段,不应通过同一种修改方式反复尝试。
确认能够连接后,导出服务器与自定义设置,记录当前代理方式和本地端口。订阅地址、分享链接以及导出文件可能包含认证信息,不要放进公开截图或交流记录。需要求助时只保留错误信息与必要环境说明,先移除服务器地址、用户标识和订阅参数。
安装更新前,先使用客户端提供的导出功能保存配置。不要假定程序目录与配置目录始终相同,也不要把覆盖安装理解成配置一定会自动迁移。系统安装包、便携运行方式和不同界面版本的保存位置可能不同,只有确认能够恢复后,才适合清理旧目录。
更新完成后,先核对当前服务器、订阅分组和本地监听端口,再启用代理。若新版本无法启动,保留系统错误提示与日志,不要连续卸载重装。页面中的版本信息用于识别客户端发布记录,具体下载文件以按钮指向的安装包为准;安装后的实际版本可在客户端“关于”页面查看。
以下问题主要用于选择安装包。已安装但无法连接时,可继续查看帮助中心。
Windows、macOS 与 Linux 桌面使用 v2rayN;Android 优先选择采用 Xray 内核的 v2rayNG。已有 V2Fly 配置或需要该内核行为的安卓用户,可以选择 v2flyNG。三款客户端均需自行导入可用的服务器配置或订阅。
桌面版 Desktop 使用新一代跨平台界面,适合首次安装及希望保持桌面平台操作习惯一致的用户;经典 WPF 版是 Windows 经典稳定版,适合熟悉原有界面的用户。两个入口均为 x64 包,首次使用选择一个即可,切换前应导出配置。
2015 年后主流手机通常优先选择 arm64,但仍需确认系统支持 64 位应用。如果设备架构不明确或安装提示不兼容,可选择通用版。通用版包含多种架构,通常文件更大;同一客户端不需要同时安装两个包。
客户端本身不附带可用服务器。安装后需要导入有效订阅或服务器配置,更新订阅并选择当前服务器,再启用系统代理或安卓 VPN 连接。仍然失败时,应按本地端口、服务器参数、系统时间和运行日志的顺序排查。
先导出服务器配置、订阅分组和自定义路由,记录本地监听端口与代理模式,然后退出旧客户端。不同平台和版本的配置位置可能不同,应使用客户端提供的导出功能。备份可能包含订阅地址与认证信息,应妥善保管,更新后先验证再清理旧配置。
下载失败时先检查浏览器下载记录、磁盘空间与当前网络,再刷新页面重试。安装失败时确认文件已下载完成、扩展名与平台相符,并检查架构、安装权限及系统提示。不要通过改文件扩展名解决兼容问题;打开客户端后可在关于页面确认实际安装版本。