v2rayN
7.24.1桌面版采用新一代跨平台 UI；经典 WPF 版保留熟悉的 Windows 界面。两个入口均为 x64 压缩包，下载后先解压，再运行包内安装程序。
首次安装可选 Desktop；需要传统布局可选经典稳定的 WPF 版。不要同时启动两套客户端，以免本地监听端口冲突。
- 免费开源客户端
- 安装包与架构选择
V2Ray 客户端下载
v2rayN 与 Android 客户端
先选操作系统，再核对处理器架构。桌面使用 v2rayN，Android 优先选择 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。
安装完成后还需导入订阅或服务器配置。首次使用可先阅读使用文档 →
选择系统与安装包
主入口对应常用架构；其他架构与界面版本紧邻列出。
Windows：v2rayN
系统要求与选择依据
| 检查项目 | 安装前确认 |
|---|---|
| 系统环境 | 建议使用仍获系统更新的 Windows 10 或 Windows 11。 |
| 处理器 | 本页提供 x64 安装包；ARM 设备须另行确认兼容性。 |
| 运行组件 | 若安装程序提示缺少运行时，按提示补齐对应组件。 |
| 权限 | 常规系统代理与 TUN 模式权限要求不同，按需启用。 |
打开「设置 → 系统 → 系统信息」，查看系统类型，不要只凭设备品牌判断架构。安装目录应保留写入空间，解压后不要直接在压缩包浏览窗口中启动程序。
安装与首次启动
先退出正在运行的旧客户端，再解压下载的文件并打开安装程序。按向导选择安装位置，完成后从开始菜单启动 v2rayN。若系统弹出安全提示，先核对文件来源与提示内容，不要为了继续安装而关闭整套系统防护。遇到缺少运行组件的提示，记下组件名称与架构，再按安装程序说明处理。
进入主窗口后，先打开「订阅分组 → 订阅分组设置」，填写别名与订阅地址，保存后执行当前分组的订阅更新。列表出现条目只表示导入完成，还需要选择可用服务器并设置「自动配置系统代理」。具体菜单位置可能随界面版本调整，遇到差异可对照订阅导入教程逐项确认。
从 WPF 版切换到 Desktop 前，先备份已有分组、自定义路由与其他个人设置。不要默认两套程序一定共用同一份用户数据。首次启动新界面时，逐项检查订阅是否齐全、当前服务器是否正确、系统代理模式是否符合预期，再退出旧程序并恢复日常使用。
macOS：v2rayN
v2rayN
7.24.1按芯片选择 DMG。M 系列芯片使用 Apple Silicon 安装包；「关于本机」显示 Intel 处理器时，使用 Intel 安装包。
点击苹果菜单中的「关于本机」查看芯片类型。同一系统名称不代表相同的处理器架构。
系统要求与选择依据
| 检查项目 | 安装前确认 |
|---|---|
| 系统版本 | 使用仍获更新的 macOS；最低版本以当前应用安装提示为准。 |
| Apple Silicon | M 系列芯片对应 arm64 DMG。 |
| Intel | Intel 处理器对应 x64 DMG。 |
| 系统授权 | 首次使用相关网络功能时，阅读并确认系统权限提示。 |
优先选择与芯片原生匹配的包，不要把转译运行当作默认方案。若应用无法启动，先核对架构、系统版本与系统给出的具体提示。
安装位置与网络权限
下载后打开 DMG，按窗口提示将应用放入「应用程序」，再从该目录启动。不要长期从磁盘映像内部运行。安装结束后可以推出磁盘映像，避免之后误开旧副本。若已安装另一个版本，先退出原应用并备份配置，再进行替换。
首次启动若被系统拦截，先阅读弹窗，再到「系统设置 → 隐私与安全性」查看对应记录；仅在确认应用来源可信后按系统提供的方式继续。不要使用来历不明的命令批量修改安全设置，也不要把系统级网络授权与订阅账号混为一谈。
导入订阅后先用普通系统代理验证浏览器访问，再考虑 TUN 等需要额外权限的功能。若浏览器可用而其他应用不可用，应先确认应用是否遵循系统代理，而不是反复重装。桌面界面的操作逻辑可参考完整手册中的代理模式章节。
Android：v2rayNG 与 v2flyNG
v2rayNG
2.2.6使用 Xray 内核的 Android 图形客户端。2015 年后的主流手机通常优先选择 arm64；设备架构不明确或专用包不适用时，再考虑通用版。
通用版覆盖更多架构，文件通常更大。实际兼容性仍取决于系统版本及设备的应用运行环境。
v2flyNG
1.10.31适合明确需要 V2Fly 内核的配置环境。选择前先确认服务端使用的协议与传输方式；两款 Android 客户端不能仅凭界面相似就视为完全等价。
先确认配置兼容，再决定是否切换。使用依赖 Xray 特性的配置时，应核对内核支持情况。
系统要求与安装前检查
| 检查项目 | 选择建议 | 常见影响 |
|---|---|---|
| 系统版本 | 以当前 APK 安装器提示的最低要求为准。 | 较旧系统可能无法解析安装包。 |
| 架构 | 主流 64 位设备优先 arm64，不确定时核对规格。 | 架构不匹配可能导致安装失败。 |
| 安装权限 | 仅为本次使用的浏览器或文件管理器按需授权。 | 权限按应用来源分别管理。 |
| 网络连接权限 | 首次连接时阅读系统 VPN 连接请求。 | 其他 VPN 类应用可能占用同一连接通道。 |
APK 安装与首次连接
下载完成后从文件管理器打开 APK，按系统提示允许当前来源安装应用。授权应限于实际使用的来源，不需要扩大到其他应用。安装完成后打开客户端，导入可信来源提供的订阅或分享链接。首次启动连接时，系统会显示 VPN 连接请求，确认后才会建立本地接管通道。
如果安装器提示签名不一致，先确认设备上是否已有来自其他发行渠道的同名应用。不要直接卸载来绕过提示，因为卸载可能清除本地配置。先备份订阅和个人规则，再决定保留原渠道更新，还是迁移到新安装包。通用版可以解决部分架构选择问题，但不能解决签名冲突或系统版本过低。
连接成功后若切到后台很快断开，查看系统电池管理是否限制了客户端后台活动，再确认是否同时运行其他 VPN 类工具。v2rayNG 与 v2flyNG 都是配置与连接管理工具，不提供订阅服务。选择时应看内核与现有配置的匹配程度，详细区别可阅读客户端选型指南。
Linux：v2rayN
v2rayN
7.24.1先按发行版选择 deb 或 rpm，再匹配处理器架构。普通 Intel、AMD 桌面设备通常选择 x64；ARM 桌面设备使用下方 arm64 入口。
deb 与 rpm 是软件包格式，不是两种代理模式。请交给发行版的软件安装器处理依赖。
系统要求与选择依据
| 检查项目 | 安装前确认 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话。 |
| deb 软件包 | 适用于采用 deb 包管理的兼容发行版。 |
| rpm 软件包 | 需要发行版与软件包依赖、运行库要求匹配。 |
| 处理器 | amd64、x86_64 对应 x64；aarch64 对应 arm64。 |
软件包后缀相同不代表所有发行版都兼容。安装器报告依赖不满足时，先记录缺失组件与系统版本，不要强制忽略依赖继续安装。
图形安装与代理范围
打开系统设置中的「关于」，确认处理器与发行版信息。下载合适的软件包后，用系统软件安装器打开并完成安装。安装器要求管理员授权是写入系统软件目录的正常步骤，但日常使用不应为了方便而始终以管理员身份启动整个图形客户端。
启动后先导入配置，再检查桌面环境中的网络代理设置。不同桌面环境对系统代理的支持范围不同，浏览器、桌面应用和终端也未必采用同一套代理设置。因此，浏览器访问正常而终端连接失败，并不能直接说明服务器不可用。先确认请求是否进入客户端，再检查路由与远端连接。
TUN 模式涉及系统网络接口与权限，建议在普通代理验证通过后单独启用。调整前记录原有设置，避免与已有网络管理工具同时修改路由。若目标只是让常用浏览器使用代理，先完成基础配置即可，不必在安装阶段一次性打开所有功能。
安装后的配置顺序
把安装、导入、验证分开处理，出现问题时更容易定位。
-
保存订阅来源
在可信来源取得订阅地址，再填入订阅分组。订阅链接可能包含访问凭据，不要把完整链接贴到公开讨论区或截图中。保存后执行更新，观察日志是否返回成功结果；列表为空时先核对地址和更新状态。
查看订阅导入路径 → -
选择代理模式
先选中可用服务器，再启用系统代理。系统代理负责把遵循系统设置的应用流量送入客户端，路由规则负责决定进入后的连接走向。两者不是同一个开关，也不能仅凭托盘图标判断全部应用都已接管。
区分系统代理与路由 → -
验证实际连接
用浏览器访问目标服务，同时查看客户端日志。延迟测试只反映特定测试条件，不等于业务访问一定正常。若请求没有进入日志，先查本机代理设置；若已进入但报错，再排查配置参数与服务端状态。
查看连接验证步骤 →
下载与安装常见问题
先核对安装包，再处理配置与网络。
Windows 桌面版与经典 WPF 版怎么选？
首次安装可先选 Desktop 桌面版，它采用新一代跨平台界面；熟悉传统布局的用户可选经典稳定的 WPF 版。两者都需要导入有效配置。切换前先备份配置，不要同时运行两个实例争用本地端口。
怎样确认处理器应该选 x64 还是 arm64？
Windows 在设置、系统、系统信息中查看系统类型；macOS 在苹果菜单的关于本机中查看芯片；Android 可查看设备规格，2015 年后的主流手机通常选择 arm64；Linux 在系统设置的关于页面查看处理器架构。以设备实际信息为准。
下载完成后为什么还不能直接连接？
客户端安装包不包含可用的服务端连接配置。请从可信来源取得订阅地址或分享链接，在订阅分组设置中保存并更新订阅，选中服务器后再设置系统代理，最后检查日志与实际访问结果。
Android 提示无法安装，应该检查什么？
先确认安装包架构与设备匹配，再检查剩余存储空间及当前安装来源的权限。若提示签名冲突，先备份现有配置并核对已安装应用的来源，不要直接卸载。arm64 包不适用时，可尝试通用版。
更新客户端会删除订阅和路由设置吗？
更新前应主动备份订阅分组、路由规则和自定义设置。同一来源的正常升级通常会保留配置，但更换安装方式、用户目录或应用签名可能改变数据位置。升级后先检查订阅分组与代理模式，再恢复日常使用。
安装包文件名与版本文字不一致，以哪里为准？
版本文字与文件入口可能分别更新。页面版本文字用于浏览参考，不应只靠它判断实际安装版本。安装后打开客户端的关于信息确认版本；需要保留旧环境时，先备份配置并记录当前版本，再决定是否升级。