v2rayN
首推 7.24.1Windows x64 安装入口。桌面版 Desktop 使用新一代跨平台 UI;经典 WPF 版保留传统 Windows 界面,是沿用旧版操作习惯的稳定选择。
下载得到 ZIP 文件。先完整解压,再运行其中的安装程序,不要直接从压缩文件预览窗口启动。
CLIENT / PLATFORM / ARCHITECTURE
桌面端 v2rayN,安卓端 v2rayNG。
先选系统,再选处理器架构。
三款客户端均免费、代码开源。安装包用于部署客户端;订阅与服务器参数需另行准备。
选择平台与安装包 ↓这里只区分客户端、界面版本和安装架构。协议类型在导入配置后设置,不需要为每种协议分别安装一个客户端。
Windows x64 安装入口。桌面版 Desktop 使用新一代跨平台 UI;经典 WPF 版保留传统 Windows 界面,是沿用旧版操作习惯的稳定选择。
下载得到 ZIP 文件。先完整解压,再运行其中的安装程序,不要直接从压缩文件预览窗口启动。
| 检查项 | 要求或建议 | 核对位置 |
|---|---|---|
| 系统与架构 | 建议在 Windows 10 / 11 的 x64 环境使用;具体构建要求以安装程序提示为准。 | 设置 → 系统 → 系统信息 |
| 运行环境 | 出现运行库缺失提示时,安装该构建要求的 .NET 桌面运行库,并匹配 x64 架构。 | 安装程序提示或启动错误窗口 |
| 目录权限 | 安装与配置目录需要可写;不要在只读位置或未解压的压缩包内运行。 | 文件资源管理器 → 目录属性 |
| 流量接管 | 普通系统代理先按常规权限使用;TUN 可能需要管理员权限和虚拟网卡组件。 | 客户端系统代理与 TUN 设置 |
首次打开后先导入一条已知可用的配置,再设置系统代理。不要为了处理普通启动问题反复切换 TUN;运行库、目录权限与代理模式属于不同层面的检查项。
macOS 桌面图形客户端。Apple Silicon 选择 arm64,Intel 处理器选择 x64;两个入口均为 DMG 安装镜像。
打开 DMG 后按窗口指引将应用放入「应用程序」,再从「应用程序」启动。
| 检查项 | 要求或建议 | 核对位置 |
|---|---|---|
| 处理器 | Apple Silicon 使用 arm64;Intel 使用 x64。 | 苹果菜单 → 关于本机 |
| 系统版本 | 确认当前 macOS 满足所选构建要求;若提示系统过旧,先核对系统版本。 | 关于本机 → macOS 版本 |
| 安装位置 | 建议放入「应用程序」,避免长期从挂载的磁盘镜像内运行。 | 访达 → 应用程序 |
| 网络权限 | 修改系统代理或开启 TUN 时可能需要系统授权,按实际提示操作。 | 系统设置与客户端权限提示 |
更换安装架构前先退出正在运行的客户端。旧应用仍在后台时直接覆盖文件,容易让菜单栏状态与实际进程不一致。完成迁移后,重新确认系统代理所指向的本地端口。
Android 首选,使用 Xray 内核。2015 年后的主流手机通常先选 arm64;设备架构不确定,或系统不接受 arm64 包时,可考虑通用版。
选择 VLESS、REALITY 等配置前,先核对订阅字段及当前内核支持情况。
适合沿用 V2Fly 生态配置的 Android 用户。它与 v2rayNG 是不同客户端,不能仅凭名称相近就假定协议扩展、订阅解析和数据目录完全一致。
切换客户端前保留订阅来源。原应用的数据不会自动迁移到另一款应用。
| 检查项 | 要求或建议 | 核对位置 |
|---|---|---|
| 架构与系统 | arm64 需要系统支持对应 ABI;处理器支持 64 位不等于系统一定支持。 | 设备系统信息及安装程序提示 |
| 安装来源 | 允许当前用于打开 APK 的浏览器或文件管理器安装应用,完成后可收回授权。 | 设置 → 应用 → 特殊应用权限 |
| 系统兼容性 | 具体最低 Android 版本以安装包声明为准;解析失败时同时检查系统版本与架构。 | 设置 → 关于手机 |
| 连接授权 | 首次启动连接时,需要确认 Android 的 VPN 连接请求。 | 系统 VPN 授权对话框 |
| 后台运行 | 长时间连接可能受省电策略影响;仅在确有后台中断时调整该应用的电池限制。 | 设置 → 应用 → 电池 |
通用版包含更多架构适配内容,不意味着连接性能更强。安装时若提示与现有应用冲突,可能是签名或版本关系导致;先备份配置,再判断是否需要更换安装来源。不要直接卸载后才寻找原订阅。
Linux 图形桌面客户端。Debian、Ubuntu 等通常选择 DEB;采用 RPM 包管理体系的发行版选择 RPM,并继续核对发行版依赖与处理器架构。
amd64、x86_64 通常指 x64;aarch64 通常指 arm64。格式相同也不代表依赖条件相同。
| 检查项 | 要求或建议 | 核对位置 |
|---|---|---|
| 桌面环境 | 需要图形桌面会话以及该构建要求的图形运行依赖。 | 系统信息与图形软件安装器 |
| 包管理格式 | 按发行版选择 DEB 或 RPM,不混用其他发行版的依赖解决方式。 | 发行版说明与软件管理器 |
| 架构 | 常见桌面电脑选 x64;ARM 桌面设备按实际系统选 arm64。 | 设置 → 关于 → 系统架构 |
| 权限与代理 | 安装软件需相应授权;系统代理是否被应用遵循,取决于桌面与应用自身设置。 | 软件安装器、系统网络设置 |
安装后先使用单一代理方式验证浏览器连接。系统代理、应用内手动代理与 TUN 同时调整,会增加判断难度;需要更广范围的流量接管时,再单独阅读 TUN 的权限与路由说明。
安装成功、配置导入成功、流量经过代理是三个不同阶段。按顺序完成,出现问题时更容易定位。
桌面端按对应包格式安装,安卓端打开 APK 并确认安装权限。首次启动先检查是否能看到主窗口、菜单和配置列表。若此时失败,先处理系统兼容性、运行库或目录权限,不必修改服务器参数。
在 v2rayN 的订阅分组设置中添加订阅地址,再执行更新;安卓端使用订阅设置或导入入口。菜单名称可能随界面版本略有不同。导入后核对协议、地址和安全层参数,选中要使用的配置,而不是只停留在列表出现这一阶段。
桌面端先设置系统代理,安卓端启动连接并确认 VPN 授权。用浏览器验证访问,同时检查客户端日志是否有明确错误。测试配置响应只能辅助筛选,不能替代实际网页访问;遇到异常时,每次只修改一项设置。
安装包解决的是设备适配。订阅能否连接,还取决于协议、安全层与内核能力是否匹配。
v2rayN、v2rayNG、v2flyNG 提供配置管理和连接操作界面;Xray 与 V2Fly 属于实际处理连接的内核生态。Project V 是理解这一技术家族的起点,但不同分支并非所有扩展都兼容。比较安装包时,先看平台和架构;比较连接能力时,再看配置要求与内核支持。
例如,VLESS 是协议类型,REALITY 是相关传输层安全方案,二者不能互换填写。订阅中的地址、端口、用户 ID、流控和安全层参数需要成套匹配。更换安装包通常不会自动补齐缺失字段,也不能修复服务端配置错误。
首次安装建议先使用客户端常规设置,把订阅导入、配置选中和系统代理逐项完成。确认基础连接后,再调整分流、DNS 或 TUN。若应用没有遵循系统代理,需要检查该应用的代理支持,而不是立即认定客户端安装失败。
移动端还要考虑后台省电策略、网络切换和其他 VPN 应用的影响。持续运行时的电量消耗取决于流量、无线信号、传输方式和系统调度,不能仅按客户端名称排名。关于协议取舍与内核差异,可继续阅读协议与内核技术参考。
先核对安装阶段,再检查连接设置。下面的问题集中处理包格式、架构和配置迁移。
新安装可先选桌面版 Desktop,它使用新一代跨平台界面。经典 WPF 版是保留传统 Windows 界面的稳定选择,适合沿用既有操作习惯。两者不是不同协议套餐;迁移前应备份配置,不要让两个实例同时设置系统代理。
Windows 在「设置 → 系统 → 系统信息」中查看系统类型;macOS 在「关于本机」中查看芯片或处理器;Linux 在系统信息中查看架构。Apple Silicon 对应 arm64,Intel 桌面处理器通常对应 x64。
2015 年后的主流 Android 手机通常先选 arm64,但仍应以设备系统支持的架构为准,不确定时可选通用版。仅知道处理器型号,还不足以排除系统使用其他 ABI 的情况。
Android 新用户优先选择 v2rayNG,它使用 Xray 内核。需要沿用 V2Fly 配置时再考虑 v2flyNG。涉及 VLESS、REALITY 或特定传输设置时,应核对当前客户端与内核的支持情况,不能只因订阅能导入就认定全部参数兼容。
客户端是配置与连接工具,安装完成不代表已有可用连接。需要从有权使用的服务中取得订阅地址或服务器参数,完成导入、选中配置和代理模式设置。示例域名、示例用户 ID 与示例公钥不能直接用于连接。
先确认安装包与系统架构匹配。Windows ZIP 文件应先完整解压,再运行其中的安装程序;出现运行库提示时,按提示安装对应的 .NET 桌面运行库。Android 检查安装来源权限、存储空间与现有应用签名冲突;桌面系统同时检查目录写入权限和安全提示。
需要继续排查时,记录错误提示原文,再查看常见问题。配置尚未开始运行时,反复修改路由或 DNS 一般不能解决应用启动问题。
同一客户端的常规更新通常会沿用现有数据,但跨界面、跨目录或跨客户端迁移不能保证直接兼容。更新前使用客户端的备份或导出功能,保留订阅来源与自定义规则;新版本验证正常后,再清理旧目录。卸载 Android 应用前尤其要先备份本地配置。