v2rayN
7.24.1Desktop 采用新一代跨平台界面,适合首次安装或从其他桌面系统切换过来。
WPF 是 Windows 上的经典稳定版,适合沿用原有菜单和托盘操作习惯。
客户端 / 安装包选型
桌面选 v2rayN,安卓优先选 v2rayNG。先选系统,再核对处理器架构与安装包格式。
Desktop 采用新一代跨平台界面,适合首次安装或从其他桌面系统切换过来。
WPF 是 Windows 上的经典稳定版,适合沿用原有菜单和托盘操作习惯。
| 项目 | 本页提供 | 安装前确认 |
|---|---|---|
| 系统与架构 | Windows x64 | 在“设置 → 系统 → 关于”查看系统类型,确认是 64 位系统和 x64 处理器。 |
| 文件格式 | ZIP,内含安装程序 | 整包解压到本地目录,再从解压目录运行安装程序。 |
| 运行组件 | 依发行包而异 | 若明确提示缺少 .NET 运行环境,按提示核对运行时类型、版本与架构。 |
不要直接在压缩文件预览窗口内双击安装程序。完整解压后安装,首次启动先确认主窗口能打开、托盘菜单能响应。只在托盘看到图标不一定代表启动失败,先从托盘打开主窗口。安装和启动是两件事:若安装器已完成,之后应用报错,应保留具体提示,而不是反复下载同一个包。
若此前运行过另一个代理客户端,先从托盘退出它,再启动新版。两个程序可能尝试占用同一本地端口,也可能先后写入系统代理,导致浏览器用到的不是当前窗口里的配置。准备换版本前记下现有订阅分组、路由规则与端口;配置备份应存放在私人目录,不要把订阅链接贴到公开截图里。
主窗口工作正常后再导入订阅。首次验证时先用会读取系统代理的浏览器测试,确认节点、路由和代理状态都符合预期。只在需要接管不读取系统代理的应用时考虑 TUN,避免安装、订阅和流量接管三个环节同时改动。
“关于本机”显示 Apple M 系列芯片时,选原生 arm64 包。
“关于本机”显示 Intel 处理器时,选 x64 包;文件名中的 64 指这个入口。
| 项目 | 本页提供 | 安装前确认 |
|---|---|---|
| 芯片 | Apple Silicon / Intel | 以“苹果菜单 → 关于本机”中的芯片或处理器名称为准。 |
| 系统版本 | 随发行版本而异 | 旧系统先核对该版本的最低要求;芯片匹配不代表系统版本也匹配。 |
| 文件格式 | .dmg | 挂载磁盘映像后将应用复制到“应用程序”,从目标目录启动。 |
打开 DMG 后,按磁盘映像窗口中的说明把应用复制到“应用程序”。复制完成后关闭窗口并推出磁盘映像,再从“应用程序”启动。这样升级时可以明确找到正在使用的那一份,避免从下载目录、磁盘映像和应用目录分别启动几个副本。
若出现系统兼容性提示,先区分处理器不匹配、系统版本过低和安全提示。前两类应回到包型与系统要求核对;对来源或提示内容不确定时,暂停安装,不要把降低系统安全设置当成通用处理方法。受组织管理的设备还可能限制应用安装,应遵循管理员提供的流程。
应用启动后,在当前使用的网络服务下核对系统代理,例如当前连的是 Wi-Fi 还是有线网络。换网络后行为不同,先比较活动网络的代理设置,而不是重新装包。已有手工代理或自动配置地址的设备,启用客户端前先记下原设置,以便退出后恢复。
使用 Xray 内核。2015 年后的主流手机优先选 arm64,前提是系统支持 arm64-v8a。
不确定系统支持哪种应用架构时,先选通用包。它包含多种架构的组件,文件通常更大。
使用 V2Fly 内核。已有明确的 V2Fly 配置要求时,先确认订阅所用协议和传输选项是否适配。
需要 v2flyNG 且暂时无法确认应用架构时,选这个入口。
| 项目 | 本页提供 | 安装前确认 |
|---|---|---|
| 应用架构 | arm64-v8a / 通用版 | 硬件是 64 位不代表系统一定支持 64 位应用,按系统支持的架构选。 |
| 安装权限 | .apk | 需允许当前打开文件的应用发起安装;装完可收回该权限。 |
| 连接权限 | Android VPN 服务 | 首次启动连接时确认系统授权;测试前先断开其他正在运行的 VPN。 |
下载后从系统下载列表或文件管理器打开 APK。若系统要求允许来自当前来源的安装,先确认弹窗所指的应用就是刚才打开文件的浏览器或文件管理器。授权安装只决定 APK 能否交给系统安装器,与客户端能否建立连接无关。若没有安装入口,先检查下载是否完成、文件名是否仍以 .apk 结尾。
覆盖升级时,应用名称相同不代表签名相同。若系统拒绝覆盖,先确认旧版来自哪里,保留原配置,再选择同一发行来源的兼容更新。更换客户端时也不要假设路由、应用分流名单和订阅刷新设置会自动迁移:应分别核对,先验证一个节点,再逐项恢复自定义选项。
安装后添加并更新订阅,选中节点再启动连接。授权完成后,用同一个应用做一次连接前后的对照测试。如果刚启动可用、锁屏后却断开,检查电池管理和后台活动权限;如果一开始就连不上,先看订阅是否更新成功、是否选中了有效节点,不必马上更换安装包。
Debian、Ubuntu 等采用 DEB 包的 x86-64 桌面系统。
使用 RPM 的 x86-64 桌面系统。先核对构建目标与发行版依赖。
| 项目 | 本页提供 | 安装前确认 |
|---|---|---|
| 包格式 | DEB / RPM | 按发行版使用的包管理器选择;扩展名相同不保证依赖兼容。 |
| 架构 | amd64 / x86_64、arm64 / aarch64 | 运行 uname -m 查看当前系统架构,再对照包名。 |
| 桌面会话 | 图形客户端 | 从本地图形会话启动;系统代理是否生效也取决于桌面环境和目标应用。 |
架构匹配后还要看包的构建环境。本页 RPM 文件名带 el10,这是构建目标标记,不代表所有能读取 RPM 的发行版都能直接安装。用发行版的软件包管理器打开本地文件,先检查依赖是否能够解析;若缺少库或要求的版本高于系统提供版本,不要用强制安装跳过检查。
安装完成后,用当前登录桌面的普通用户从应用菜单启动。若图标不在菜单里,先在包管理器确认安装事务确实完成,再检查启动项,而不是连续点装多个架构的包。若应用只在别的用户会话运行,当前用户看到的订阅和代理设置可能不同,排查时应始终使用同一账号。
在 GNOME 或 KDE 下,桌面网络设置与应用自身的代理设置可能并存。先任选一个明确遵循桌面代理的应用完成连接验证,再单独处理不继承设置的程序。确认手动启动和正常退出都没有问题后,再考虑开机自启或启用 TUN。
下载与升级
选一个即可。首次安装可以从桌面版开始;已有 WPF 使用习惯则可继续选 WPF。更换发行形态前先备份配置,测试时只运行一个客户端,避免本地端口冲突。
x64、amd64 和 x86_64 通常指同一种 64 位 x86 架构;arm64 和 aarch64 指 64 位 ARM 架构。两者都叫 64 位,但不能据此互换安装包。
只有问题与处理器架构有关时,换通用版才可能有帮助。若系统提示签名冲突、版本降级或系统不兼容,应按提示核对现有应用的安装来源、版本和系统要求,不要直接卸载旧版。
卡片版本号来自发布清单的应用级字段,可能与某个平台的包名不同。确认具体包时看该入口提供的文件名;确认已经安装的版本时看客户端的关于页面。
先导入订阅并更新分组,再选中节点。桌面端先用读取系统代理的应用验证,按需启用 TUN;安卓端则在选中节点后启动连接,并处理系统的 VPN 授权提示。
确认客户端能正常启动后,按上手教程导入订阅、更新分组并验证连接。需要迁移配置、处理端口占用或检查桌面代理设置时,按系统查阅全平台指南。