v2rayN
首推Desktop 是新一代跨平台 UI,适合首次安装及跨桌面系统使用;WPF 是经典稳定版,适合延续已有操作习惯。先选界面,再导入配置,两种界面不需要同时运行。
下载得到 ZIP 压缩包。先完整解压,再运行包内安装程序;不要直接从压缩包预览窗口启动。
先选操作系统,再选处理器架构。桌面使用 v2rayN,Android 首选 v2rayNG,v2flyNG 作为内核兼容性备选。
三款客户端均为免费开源软件。安装完成后,仍需导入有效的订阅或服务器配置。
同一客户端,两种界面。以下入口均为 x64 安装包。
Desktop 是新一代跨平台 UI,适合首次安装及跨桌面系统使用;WPF 是经典稳定版,适合延续已有操作习惯。先选界面,再导入配置,两种界面不需要同时运行。
下载得到 ZIP 压缩包。先完整解压,再运行包内安装程序;不要直接从压缩包预览窗口启动。
| 检查项目 | 选择与要求 | 查看位置 |
|---|---|---|
| 操作系统 | 建议使用仍获安全更新的 Windows;具体最低版本以当前安装程序提示为准。 | 设置 → 系统 → 系统信息 |
| 处理器架构 | 本页提供 x64 包,安装前确认系统类型与应用兼容性。 | 系统信息 → 系统类型 |
| 运行环境 | 如提示缺少运行时,按该安装包要求补齐对应环境后重试。 | 安装提示与应用启动提示 |
安装目录应放在有读写权限的位置,避免把配置长期留在下载临时目录中。首次启动后,先确认主窗口能够正常打开,再导入订阅。系统代理会影响读取系统代理设置的应用,但并不等于所有程序都会自动使用代理;需要接管其他应用时,应在了解权限与路由影响后单独配置 TUN 模式。
从 WPF 切换到 Desktop 前,先使用客户端的导出功能保存设置,并记录本地监听端口、订阅分组和路由方案。不要直接用另一分支的程序覆盖原目录。退出旧客户端后再启动新客户端,可以避免监听端口被占用,也能减少系统代理被两个进程交替修改的情况。
在「关于本机」查看芯片信息,不按电脑外观或购买年份判断。
Apple M 系列芯片选择 Apple Silicon;显示 Intel 处理器时选择 Intel 包。优先使用与本机架构对应的版本,可以减少额外兼容层带来的启动与运行差异。
打开 DMG 后将应用复制到「应用程序」,再从应用程序目录启动;完成复制后可推出磁盘映像。
| 检查项目 | 选择与要求 | 查看位置 |
|---|---|---|
| 系统版本 | 使用仍获安全更新的 macOS,最低兼容版本以应用提示为准。 | Apple 菜单 → 关于本机 |
| 芯片架构 | Apple M 系列用 arm64;Intel 用 x64。 | 关于本机 → 芯片或处理器 |
| 网络权限 | 修改代理或启用网络接管时,按系统提示核对授权内容。 | 系统设置 → 网络 |
首次启动如果出现系统安全提示,应先确认文件来源、所选架构及提示的具体内容,再到「隐私与安全性」查看是否存在允许打开的选项。不要为了启动一个应用而关闭整个系统的安全机制;如果系统明确提示文件损坏或不兼容,重新下载对应架构的包比反复修改权限更合适。
配置系统代理后,可以在当前网络服务的代理设置中核对地址和端口是否对应客户端。切换网络、休眠唤醒或退出客户端后若浏览器无法访问,先检查是否留下失效的本地代理。日常退出应通过客户端菜单完成,更新前也应先退出旧进程,再替换应用程序中的文件。
先看架构,再看内核兼容性。2015 年后的主流手机通常优先选择 arm64。
Android 首选图形客户端。订阅管理、节点选择和连接操作集中在应用内;涉及 VLESS、REALITY 等配置时,还需核对服务端参数与当前内核的支持情况。
应用级版本文字与具体包文件名可能暂时不同;请以所选文件及安装后「关于」页面显示的运行版本为准。
适合已有配置依赖 V2Fly 行为的场景。它不是 v2rayNG 的界面皮肤,两者的内核路线和配置支持范围不同。导入前应核对协议、传输和安全字段,不应把一个客户端里的全部高级设置直接照搬。
| 检查项目 | 选择与要求 | 查看位置 |
|---|---|---|
| 系统兼容性 | 最低 Android 版本由所选 APK 决定,以安装器提示为准。 | 设置 → 关于手机 → Android 版本 |
| 设备架构 | 2015 年后的主流手机通常选 arm64;旧设备或架构不明时选通用版。 | 设备信息或厂商处理器规格 |
| 必要授权 | 安装时允许当前来源安装应用;连接时确认系统 VPN 请求。 | 应用安装器与系统 VPN 对话框 |
年份只是初步判断,部分设备虽然采用 64 位处理器,系统仍可能使用不同的应用运行环境,最终应以设备信息和安装结果为准。出现「应用未安装」时,先检查剩余空间、文件是否下载完成,以及是否存在同名应用的签名冲突。不要把所有安装错误都归因于处理器架构。
首次连接会出现系统 VPN 授权。授权建立的是本地流量接管入口,并不代表服务器已连接成功。测试时只保留一个需要占用系统 VPN 通道的应用运行;若切到后台后连接中断,再按设备厂商的电池管理设置检查后台限制,而不是一开始就开放所有权限。
按发行版的包管理体系选择 deb 或 rpm,再确认 x64 与 arm64。
Linux 桌面版提供图形配置界面。Debian、Ubuntu 系通常使用 deb;Fedora、RHEL 系通常使用 rpm。包格式只是第一步,同格式的不同发行版仍可能存在运行库版本差异。
amd64、x86_64 对应这里的 x64;aarch64 对应 arm64。文件名带有发行版标记时,应进一步确认目标系统是否满足依赖。
| 检查项目 | 选择与要求 | 查看位置 |
|---|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话。 | 系统设置 → 关于 |
| 包格式与架构 | deb / rpm 与发行版匹配,x64 / arm64 与处理器匹配。 | 系统信息与图形软件包管理器 |
| 依赖与权限 | 由包管理器检查依赖;网络接管的额外权限按功能需要配置。 | 软件安装器提示与客户端设置 |
双击软件包后,通过发行版的图形软件安装器查看依赖与安装结果。如果提示依赖版本不足,不要强制忽略;应先确认该包的目标发行版和当前系统版本。安装成功但无法启动时,记录错误信息中的库名称与版本,再到故障排查页定位问题,重复安装通常不能解决依赖不满足。
Linux 的系统代理设置取决于桌面环境,不同应用读取代理设置的方式也可能不同。浏览器可用而其他程序不通时,先核对应用自己的网络设置。不要为了让普通代理功能运行而长期使用高权限启动整个图形客户端;TUN 等功能所需权限应按客户端说明单独处理。
安装 → 导入配置 → 选择节点 → 验证代理
先确认应用能正常打开。系统代理、VPN 或网络接管需要的授权只在相应功能启用时处理,安装成功并不要求提前开放所有权限。
导入有效的订阅地址或服务器配置,检查协议和传输字段是否被客户端识别。客户端本身不提供账号、订阅和线路。
选择一个节点进行真连接测试,再启用需要的代理模式。用浏览器验证访问结果,并结合日志判断失败发生在解析、握手还是路由阶段。
更新前保留可恢复的配置,更新后先做小范围验证。
导出配置时,应确认备份涵盖订阅分组、自定义路由、本地端口和应用偏好。有些内容可能保存在独立文件中,不能只复制主程序。备份中可能包含订阅地址和服务器身份信息,应保存在个人可控的位置,不要粘贴到公开讨论区,也不要把完整配置截图作为普通报错附件。
安装新版本前退出正在运行的客户端。桌面系统还应查看托盘或菜单栏,确认后台进程已结束;Android 覆盖安装时则应保留原应用数据。跨安装来源更新可能受到签名限制,跨界面或跨内核迁移也可能遇到配置字段差异。遇到冲突时先保存原配置,再决定是否重装,不要直接清空数据尝试。
更新完成后,先核对「关于」页面的运行版本,选择一个已知可用的配置测试连接。确认系统代理地址、监听端口和路由方案没有发生意外变化后,再恢复自动订阅更新。如果问题只在新版本出现,可记录系统、架构、包名和错误提示,按故障排查流程逐项定位。
先区分选包错误、系统安装限制与连接配置问题。
首次使用优先选择 Desktop 桌面版,它采用新一代跨平台界面。习惯经典界面或已有 WPF 使用流程时,可以选择经典稳定的 WPF 版。两者是界面方案的区别,不代表节点服务或网络线路的区别。迁移前先导出配置,避免直接混用程序目录。
Windows 在设置的系统信息中查看系统类型;Mac 在「关于本机」中查看芯片,Apple M 系列选 Apple Silicon,Intel 处理器选 Intel;Linux 查看系统关于页面中的硬件架构。Android 在设备信息中确认处理器,2015 年后的主流手机通常优先 arm64,不能确定时选择通用版。
先检查存储空间、系统安装权限和安装包架构。若已有同名应用,还需考虑签名来源不同或正在安装较旧版本。不要直接卸载;先导出配置并确认备份可用,再按实际错误提示处理。不同来源的包不一定能覆盖安装。
客户端只提供配置管理和流量转发功能,不附带节点服务。需要导入有效的订阅或服务器配置,选择节点并启动连接,再确认系统代理或 VPN 授权是否生效。仍然失败时,应按节点可用性、路由和 DNS 的顺序检查。
正常覆盖更新通常会保留应用数据,但更换界面分支、安装来源或主版本时,不能假定配置完全兼容。更新前从客户端导出配置,记录订阅分组、路由方案和本地端口。更新后先验证一个节点,再恢复自动更新和自定义路由。
版本文字来自应用级更新信息,具体安装包有独立的文件名,两者可能暂时不同。下载时确认所选平台、架构和实际文件名,安装后在客户端「关于」页面查看运行版本。不要手动修改下载地址中的数字来猜测其他安装包。