客户端 / 平台与架构选择

V2Ray 客户端下载
v2rayN 与 v2rayNG

桌面端选 v2rayN，安卓优先选 v2rayNG。先确认系统与芯片架构，再选择安装包；协议和订阅配置在安装后完成。

下载入口按平台整理。客户端本身不提供服务器或订阅；已有订阅的用户，安装后可直接参考订阅配置教程。

Windows：v2rayN x64

桌面版与经典 WPF 版二选一，不需要同时安装。

v2rayN

7.24.1
首推

桌面版 Desktop 使用新一代跨平台 UI，适合首次使用或希望统一桌面操作习惯的用户；WPF 版保留经典 Windows 界面，是熟悉原有布局用户的稳定选择。

下载桌面版 Desktop · x64 下载经典 WPF 版 · x64

两个入口均为 ZIP 压缩包。下载后先完整解压，再按包内文件完成安装；不要直接在压缩软件的预览窗口里启动程序。

桌面版与 WPF 版的配置迁移

两个界面版本的差别主要在操作布局和桌面技术栈，不能据此判断同一服务器的连接质量。首次运行时，先导入订阅、选中服务器，再设置系统代理。只有需要接管不遵循系统代理的程序时，才进一步考虑 TUN 模式。不要把“能打开设置窗”当作代理已经生效的依据。

从旧版迁移时先导出配置，记录自定义路由和本地端口，然后退出旧程序。两份客户端同时运行可能争用监听端口，也可能互相覆盖系统代理设置。新界面中的菜单位置可能变化，导入完成后应核对订阅分组、内核选择和路由预设，而不是直接复制整套旧程序目录。

查看 v2rayN 订阅导入步骤 →

CONFIGURATION / 安装后的配置边界

安装包选架构，连接配置选协议

下载了正确安装包，只解决“能否在设备上运行”。是否能够建立连接，还取决于订阅字段、内核功能、服务端参数与本地代理模式。排查时把这两层分开，避免反复重装。

客户端与内核不是同一个概念

Project V 生态中的图形客户端主要负责管理配置、订阅和系统集成；具体协议处理由内核承担。V2Fly 与 Xray 有共同的技术渊源，但后续功能演进并不完全相同。v2rayNG 与 v2flyNG 的选型因此不能只看界面是否相似，还要看配置所需功能。

REALITY 是安全层机制，不是独立出站协议。看到订阅里有 VLESS，不代表已经具备全部连接条件；传输方式、安全层和认证参数都要匹配。需要理解 VMess 与 VLESS 的差异时，可继续阅读协议技术参考。

先建立最小可用配置

首次测试只保留一个客户端、一份已知有效配置和一种代理模式。先确认系统时间正确、订阅更新成功、配置已选中，再进行访问验证。不要同时切换协议、DNS、路由与 TUN，否则即使连接恢复，也很难确定是哪一项起了作用。

REALITY 配置需与服务端同步核对 publicKey、shortId 等字段；切换安装包不会自动补齐这些参数。

安装后：订阅、代理模式与升级

客户端可以免费使用，但连接资源需要单独配置。以下顺序适合首次安装，也适合更换设备后的重新设置。

导入订阅，核对配置是否完整

订阅地址通常带有访问凭据，应完整复制到客户端的订阅分组中，避免把网页分享页地址当成订阅链接。添加地址后仍需执行更新，列表中出现配置后再选中使用。若更新成功但列表为空，先核对订阅有效期、返回格式和协议兼容性，不要立即把链接交给陌生的在线转换服务。

分享问题截图前，应遮住订阅地址、账号标识和认证参数。导出配置与备份也可能包含这些内容。需要跨客户端迁移时，优先重新导入原始订阅；不同客户端的自定义 JSON、路由文件与菜单选项不一定可以直接互换。

确认应用实际经过哪种代理路径

桌面端通常先使用系统代理；Android 则通过系统授权的 VPN 通道接管流量。客户端显示运行状态，只说明本地服务已启动，不代表目标网站访问一定成功。验证时同时关注应用行为和日志错误，区分服务器连接失败、域名解析失败与目标应用未走代理这几种情况。

TUN 适合需要接管更多应用流量的场景，但也增加虚拟网卡、DNS 与路由方面的配置要求。若基础代理可用而 TUN 不可用，应沿着权限和网络设置排查，而不是重新导入所有订阅。退出客户端前注意恢复代理设置，避免系统仍指向已经停止监听的本地端口。

升级前保留可恢复的配置

升级程序与更新订阅是不同操作：前者改变客户端及相关组件，后者刷新服务器列表。升级前先备份，完成后检查订阅、路由、DNS 和内核选项。清单版本标记与安装文件名可能分别维护；遇到两者不一致时，不要仅凭文件名判断功能，安装后可在客户端关于页面确认实际版本。

如果新版出现异常，先记录系统环境、客户端界面版本与具体日志，避免直接删除原配置目录。配置格式可能随版本调整，因此应保存升级前的独立备份，而不是只保留已被新程序写入的目录。更多安装后的操作说明见客户端使用教程，订阅解析与转换问题见疑难解答。

下载与安装常见问题

先分清包选择、程序启动与连接配置三个阶段，再决定下一步检查内容。

Windows 应该下载桌面版还是经典 WPF 版？

首次使用可先选桌面版 Desktop，它使用新一代跨平台界面；熟悉原有操作布局的用户可以选择经典稳定的 WPF 版。两者都是 v2rayN 客户端，订阅能否正常使用还取决于内核与配置字段。切换界面版本前先备份配置，不要让两份程序同时修改系统代理。

Android 的 arm64 与通用版怎么选？

2015 年后的主流手机通常优先选择 arm64，但最终应以设备实际支持的应用架构为准。老设备、仅支持较旧应用架构的系统，或无法确认架构时，可选择通用版。通用版包含多种架构组件，文件通常更大，不代表连接能力更强。

安装客户端后会自动出现订阅和服务器吗？

不会。客户端负责保存配置、启动连接和管理路由，安装包不包含可直接使用的订阅或服务器账号。需要导入有权使用的订阅链接或手动添加服务器参数，再更新订阅并选择配置。订阅链接可能携带访问凭据，不应公开分享。

升级客户端前需要备份哪些内容？

先保存订阅分组、自定义路由、DNS 设置和必要的手动服务器配置，再退出旧客户端。优先使用客户端提供的导出或备份功能，迁移后核对配置是否完整。备份中可能包含访问凭据，应保存在可信位置。不要直接用旧目录覆盖新程序的全部文件。

安装时提示架构不兼容或缺少运行环境怎么办？

先核对系统架构与安装包架构，再查看系统提示中明确列出的缺失依赖。Windows 区分 x64 与其他架构，macOS 区分 Apple Silicon 与 Intel，Linux 还要区分 deb 与 rpm。运行环境要求随构建变化，以当前安装提示为准，不要反复安装来源不明的修复工具。

下载完成但无法连接，是否应该换另一个安装包？

不宜先换包。客户端能正常启动时，应先检查订阅是否有效、服务器配置是否选中、系统时间是否准确，以及系统代理或 VPN 权限是否生效。REALITY 还要核对 publicKey、shortId 与服务端配置。按日志逐项定位，比同时更换客户端、协议和 DNS 更容易找到原因。