v2rayN 首推
7.24.1桌面版 Desktop 使用新一代跨平台 UI;经典 WPF 版使用经典稳定的 Windows 界面。两者都是图形客户端,订阅导入、系统代理和路由设置的入口位置可能不同。
两个入口均为 ZIP 压缩包。下载完成后先解压,再查看包内安装入口与说明,不要直接在压缩包预览窗口中启动。
v2rayN · v2rayNG · v2flyNG
桌面选择 v2rayN,Android 首选 v2rayNG。先确认操作系统,再按处理器架构选择安装包。
两个 x64 界面分支,按操作习惯选择;首次安装不必同时下载两版。
桌面版 Desktop 使用新一代跨平台 UI;经典 WPF 版使用经典稳定的 Windows 界面。两者都是图形客户端,订阅导入、系统代理和路由设置的入口位置可能不同。
两个入口均为 ZIP 压缩包。下载完成后先解压,再查看包内安装入口与说明,不要直接在压缩包预览窗口中启动。
| 检查项 | 选择与处理 |
|---|---|
| 处理器架构 | 本页两个包均为 x64。在“设置 → 系统 → 系统信息”查看“系统类型”,确认不是 32 位系统。 |
| 系统兼容性 | 建议使用仍获系统维护的 64 位 Windows;具体最低版本与运行环境以所选发行包的说明、安装提示为准。 |
| 运行环境 | 启动时如提示缺少 .NET 桌面运行环境,按当前分支的安装提示补齐对应环境,不要只根据名称安装其他主版本。 |
| 使用权限 | 普通系统代理先以常规权限运行;启用 Tun 时,再按客户端提示检查管理员权限与虚拟网卡组件。 |
首次选择可从桌面版开始;已经熟悉 WPF 菜单布局的用户可以继续使用经典版。界面分支并不等于协议分支,服务器能否连接还取决于配置字段、内核支持和服务端设置,不能单凭窗口外观判断兼容性。
解压目录建议使用独立、可写入的位置,避免放进需要额外授权的系统目录。安装后先打开主窗口,确认“订阅分组”“设置”等入口能够正常显示,再导入配置。如果启动后窗口立刻关闭,先记录错误提示,不要反复覆盖原目录。
首次连接时,在“订阅分组”中添加订阅并执行更新,选中一条有权使用的配置,再在系统代理菜单中选择“自动配置系统代理”。先保留默认路由,暂不启用 Tun,可减少同时排查多个设置的成本。需要逐步操作时,查看入门指南。
先打开“关于本机”,按“芯片”或“处理器”字段选择对应包。
macOS 使用 v2rayN 跨平台桌面界面。Apple Silicon 设备选择 arm64,Intel 设备选择 x64;架构应以“关于本机”的信息为准,不按购买年份猜测。
打开 DMG 后,按磁盘映像中的提示将应用放入“应用程序”,再从“应用程序”启动。
| 检查项 | 选择与处理 |
|---|---|
| Apple Silicon | “关于本机”显示 Apple 系列芯片时,选择 arm64 DMG,优先使用原生架构包。 |
| Intel 处理器 | “关于本机”显示 Intel 处理器时,选择 x64 DMG,不能使用 arm64 包替代。 |
| 系统版本 | 使用仍获系统维护的 macOS;具体最低版本以当前发行说明与系统安装提示为准。 |
| 网络设置 | 修改系统代理或启用 Tun 可能请求系统授权;操作前先保存其他网络工具的现有设置。 |
将应用复制到“应用程序”后,可以先退出磁盘映像,避免以后一直从下载目录或挂载卷中打开。首次启动若被系统拦截,先核对下载来源、应用名称及系统提示,再到“系统设置 → 隐私与安全性”查看对应操作,不要为单个应用关闭整套系统安全机制。
桌面客户端打开后,先导入订阅并选择配置,再开启系统代理。系统代理只对采用相应系统设置的应用生效;命令行工具或自行管理代理的应用可能仍需单独配置,这不一定表示安装失败。测试前退出其他会修改系统代理的工具,以免设置被交替覆盖。
从 Intel 设备迁移到 Apple Silicon 设备时,建议重新下载匹配架构的应用,再导入备份配置,而不是把整个旧程序目录直接复制过去。迁移后重点检查本地监听端口、文件路径及自定义路由;这些项目可能依赖旧设备环境,不能仅凭订阅已经出现就认定迁移完成。
首选 v2rayNG;需要 V2Fly 配置兼容性时,再核对 v2flyNG 的适用范围。
使用 Xray 内核的 Android 图形客户端,支持导入分享链接、订阅管理与路由设置。2015 年后的主流手机通常优先选 arm64;仍需确认系统支持 64 位应用。
清单版本字段当前为 2.2.6,安装包文件名为 2.3.11。两者更新节奏不同,安装后可在“关于”中确认实际版本。
使用 V2Fly 内核的 Android 图形客户端。已有配置依赖 V2Fly 生态时,可按协议与传输要求选择;不要假定 Xray 专有配置能够直接迁移。
通用包用于架构不确定或需要其他受支持架构的设备;是否能安装仍取决于系统版本与包本身的兼容范围。
| 检查项 | 选择与处理 |
|---|---|
| arm64 | 适合支持 64 位应用的 ARM 设备;手机较新不代表系统一定提供 64 位运行环境。 |
| 通用版 | 无法确认架构时可优先尝试,体积通常较大;不代表能绕过最低系统版本要求。 |
| 安装权限 | 在系统提示中,只为本次使用的浏览器或文件管理器允许“安装未知应用”。不同系统的菜单名称可能略有差异。 |
| 连接权限 | 首次连接需批准系统 VPN 请求;已有其他 VPN 连接时,应先断开,避免相互接管。 |
下载完成后,从浏览器下载记录或文件管理器打开 APK。若系统提示“应用未安装”,先检查剩余空间、处理器架构和系统版本,再确认是否已有不同签名的同名应用。不要把所有安装失败都归因于架构,也不要在没有备份的情况下直接卸载旧版。
打开 v2rayNG 后,可通过右上角添加入口从剪贴板导入分享链接,或在“订阅分组设置”中添加订阅地址。订阅链接可能包含个人访问权限,不应发送到公开讨论区或截图中。导入后选择配置,点击连接按钮并确认系统 VPN 请求,再进行实际访问测试。
连接后很快中断时,检查系统对应用的电池管理限制与后台运行权限。建议先保持屏幕亮起验证配置,再观察锁屏后的表现;如果仅锁屏后断开,更应检查后台策略,而不是先修改服务器参数。DNS、Fake DNS 与路由策略留到基础连接正常后逐项调整。
先确认发行版的包格式,再确认 x64 或 arm64,两个条件都要匹配。
Linux 提供 v2rayN 桌面图形客户端。常见 x64 桌面按发行版选择 deb 或 rpm;ARM 桌面设备使用下方对应的 arm64 包。
rpm 文件名包含 el10 构建标识,不能据此推断所有 rpm 发行版都兼容;安装前需核对系统依赖。
| 检查项 | 选择与处理 |
|---|---|
| deb 系统 | Debian、Ubuntu 等使用 deb 包管理的发行版选择 deb,并核对当前发行版能否满足依赖。 |
| rpm 系统 | 使用 rpm 包管理的发行版选择 rpm;包格式相同不代表系统库版本和构建目标完全相同。 |
| 处理器架构 | 系统信息中的 x86_64 对应 x64、amd64;aarch64 对应 arm64,不按设备外观选择。 |
| 桌面与权限 | 需要可用的图形桌面环境;安装由系统包管理器处理依赖,启用 Tun 再检查相关权限。 |
可以在文件管理器中打开安装包,由系统的软件安装程序显示依赖与兼容性结果。出现缺少依赖时,先阅读包管理器给出的具体名称;不要通过强制忽略依赖继续安装,也不要把另一种包格式重命名后尝试打开。
安装完成后,从应用菜单启动 v2rayN。先确认窗口、托盘入口与设置页显示正常,再导入订阅。不同桌面环境对系统代理的读取方式可能不同,浏览器也可能使用自己的代理设置,因此首次测试应明确检查所用应用是否遵循系统代理。
需要开启 Tun 时,再核对权限、虚拟网络接口与现有网络管理工具。普通系统代理能够满足当前使用需求时,可以先保持该方式;在多个网络工具同时修改路由的环境下,贸然启用 Tun 容易使故障来源难以分辨。详细规则编写见进阶配置。
安装包负责提供客户端程序,不包含可用服务器配置。首次使用需要准备有权使用的订阅地址或分享链接;订阅属于配置来源,客户端属于本地运行工具,两者更新也互相独立。重新安装客户端通常不能修复已经过期的订阅地址。
升级前,先使用客户端现有的导出或备份功能保存配置,并确认备份文件能找到。退出旧程序后再运行安装包;桌面端还应确认托盘中的进程已经结束。新旧程序同时运行时,可能争用监听端口或反复改写系统代理,表现为“已连接但应用打不开”。
同一客户端的常规升级,与从 v2rayNG 切换到 v2flyNG、从 WPF 切换到桌面版并不是同一件事。跨客户端或跨分支操作前,先确认支持的导入格式,优先用订阅或标准分享链接重新导入;不要直接覆盖另一客户端的数据目录。自定义路由、DNS 与出站配置应单独记录并逐项恢复。
如果只需要恢复日常连接,先保留最少配置,确认基础连接可用,再恢复复杂规则。遇到证书报错应检查系统时间和服务器名称,遇到订阅解析失败应检查地址与格式;这些问题通常需要针对错误信息排查,而不是不断更换安装包。可继续阅读疑难解答或入门指南。
先分清包选择、安装过程与连接配置,再按对应步骤处理。
首次使用可先选择桌面版,它使用新一代跨平台界面;习惯经典 Windows 操作方式可选择 WPF 版,它是经典稳定界面分支。两版的菜单位置和运行环境可能不同,切换前先导出配置,首次测试只运行其中一个。
2015 年后的主流手机通常优先选择 arm64,但仍需确认系统支持 64 位应用。无法确定处理器架构,或 arm64 包提示不兼容时,可尝试通用版。安装失败还应检查系统版本、剩余存储空间和已有应用的签名冲突。
卡片版本号与各架构文件链接来自清单的不同字段,更新节奏可能不同。当前 v2rayNG 的版本字段为 2.2.6,文件名为 2.3.11;应结合实际下载文件与安装后“关于”页面确认版本,不要仅按卡片数字判断包是否适用。
客户端安装包不包含可用服务器配置。需要准备有权使用的订阅链接或分享链接,在客户端导入后选择配置,再设置系统代理或批准 Android VPN 连接。首次连接先使用默认路由,确认可用后再调整 DNS 与 TUN。
通常先备份配置,再退出旧版,优先采用同来源、同签名的覆盖升级方式。更换客户端、界面分支或安装来源时,先确认数据目录与导入格式。Android 遇到签名冲突时不要直接清除数据,应先导出可恢复的配置。
先查看浏览器下载记录,区分下载未开始、下载中断和安装失败。确认网络可用后重新打开本页再试;若已有代理影响下载,可退出客户端并恢复正常网络设置。不要通过改写文件名猜测其他安装包地址。