v2rayN
7.24.1
Windows x64 安装包。桌面版使用新一代跨平台 UI；经典 WPF 版保留传统 Windows 界面，是熟悉旧布局用户的稳定选择。
下载的是 ZIP 压缩包。先完整解压，再运行其中的安装程序，不要在压缩包预览窗口内直接启动。
v2rayN / v2rayNG / v2flyNG
V2Ray 客户端下载
按系统与架构选包
桌面平台选 v2rayN，Android 首选 v2rayNG。先确认操作系统，再确认处理器架构；安装完成后，继续导入订阅与设置代理。
- 4 个平台
- Xray / V2Fly
- GPL-3.0 开源协议
选择操作系统
按钮对应安装包；版本文字随清单更新。
Windows 系统要求与包选择
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 系统环境 | 可运行当前客户端的 Windows 桌面环境 | 安装前阅读安装程序的兼容性提示；旧系统不要默认兼容当前构建。 |
| 处理器 | x64 系统 | 以系统信息中的系统类型为准，不只看电脑品牌。 |
| 安装权限 | 安装目录可写；依赖可正常安装 | 缺少运行组件时按明确提示补齐，不要反复更换订阅。 |
| 流量接管 | 系统代理或 TUN | 先测试系统代理；TUN 需额外确认权限与网卡状态。 |
两种界面都需要有效节点配置。导入订阅后，先更新订阅并选中一个节点，再从托盘菜单选择“系统代理 → 自动配置系统代理”。浏览器能否使用代理，还取决于它是否跟随系统设置。关闭客户端前，可先选择“清除系统代理”，避免系统仍指向已经停止的本地端口。
若运行后没有主窗口，先查看任务栏右侧托盘及隐藏图标区域。若提示缺少运行环境，记录完整提示再处理；安装成功、内核启动成功和网站访问成功是三个不同阶段，应分别确认，不要仅凭托盘图标判断连接状态。
v2rayN
7.24.1
按 Mac 芯片选择 DMG。Apple Silicon 使用 arm64，Intel 处理器使用 x64；优先安装与本机架构一致的构建。
打开苹果菜单中的“关于本机”：显示“芯片”及 M 系列名称，选 Apple Silicon；显示 Intel 处理器，选 Intel。
macOS 系统要求与包选择
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 系统环境 | 当前构建支持的 macOS 桌面环境 | 以应用启动提示及构建要求为准，较旧系统需特别确认兼容性。 |
| Apple Silicon | M 系列芯片，arm64 | 选择 Apple Silicon DMG，不必先尝试 Intel 包。 |
| Intel | Intel 处理器，x64 | 选择 Intel DMG，不能运行仅为 arm64 构建的应用。 |
| 代理权限 | 系统允许修改网络代理设置 | 按授权提示操作；TUN 还需对应的网络与权限配置。 |
安装之后先添加订阅，再检查系统代理是否写入当前使用的网络服务。切换有线网络与无线网络后，代理状态可能需要重新确认。应用如果自带独立的代理设置，也可能不跟随系统代理；此时应检查应用自身选项，而不是立即修改节点参数。
更新前退出正在运行的客户端，再替换应用。若关闭后网络异常，到系统网络设置中检查是否残留本地代理地址。TUN 不应作为所有问题的默认解法：先让普通系统代理正常工作，再判断是否确有接管其他程序流量的需要。
v2rayNG
2.2.6
Android 首选客户端。2015 年后的主流手机通常选择 arm64；设备架构不明或 arm64 无法安装时，再检查是否需要通用版。
通用版覆盖多种处理器架构，体积通常更大。版本文字和文件路径来自清单的不同字段，可能暂不同步；安装时查看系统显示的应用信息。
v2flyNG
1.10.31
需要 V2Fly 内核兼容性时的备选。先确认配置使用的协议与传输受支持，不要仅因为名称接近就认为两款客户端支持的参数完全一致。
两款客户端分别保存配置。切换前先备份订阅，测试时只启动其中一款，避免多个应用争用系统 VPN 通道。
Android 系统要求与安装权限
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 系统兼容性 | 设备满足所选 APK 的最低系统要求 | 由安装器判断兼容性；架构正确不代表系统版本一定满足要求。 |
| 处理器架构 | arm64 或通用版 | 主流手机先选 arm64，其他设备以系统信息为准。 |
| 安装权限 | 允许当前来源安装应用 | 只对本次使用的浏览器或文件管理器按需授权。 |
| 连接权限 | 系统 VPN 授权 | 首次连接阅读并确认授权；检查其他 VPN 应用是否正在运行。 |
安装 APK 前，留意系统提示的是“版本不兼容”“签名冲突”还是“安装来源未获授权”。这几类问题处理方式不同，反复下载同一个包往往没有帮助。若已有同名应用，覆盖安装还要求包名与签名匹配；不要直接卸载旧版，先确认订阅与自定义规则已经备份。
首次打开后，在订阅设置中添加有效订阅地址并执行更新。选中节点，再点击连接按钮并同意系统 VPN 请求。手机状态栏的 VPN 标记只表示流量接管已建立，不代表远端连接一定成功；还需测试实际网页访问，并在异常时查看日志。
部分系统会限制后台活动。只有在连接被反复中断、锁屏后失效时，才按设备设置检查电池优化与后台运行权限。工作资料、应用分身和按应用代理也会影响流量范围，排查时先使用默认范围，避免同时更改多个变量。
v2rayN
7.24.1
Linux 图形桌面客户端。Debian、Ubuntu 系发行版通常选择 deb；Fedora、RHEL 系发行版通常选择 rpm，同时确认包依赖与发行版兼容性。
Linux 系统要求与桌面环境
| 检查项 | 选择依据 | 操作建议 |
|---|---|---|
| 包管理体系 | deb 或 rpm | 按发行版选择；安装器提示依赖冲突时，不要强行忽略。 |
| 处理器 | x64 或 arm64 | amd64、x86_64 对应 x64；aarch64 通常对应 arm64。 |
| 桌面会话 | 可用的图形桌面与所需运行依赖 | 托盘不可见时，先检查桌面是否提供相应支持。 |
| 网络权限 | 普通代理与 TUN 的要求不同 | 先完成系统代理验证，TUN 再按文档配置所需权限。 |
使用发行版的软件安装器打开包，先查看依赖和目标架构。rpm 文件名中的构建标记也应纳入兼容性判断，不能认为所有 rpm 发行版都能直接安装同一构建。遇到依赖无法满足时，保留错误信息，并对照发行版与客户端运行要求处理。
GNOME、KDE 等桌面环境的系统代理行为不同，某些程序还只读取自身代理选项或环境变量。“自动配置系统代理”生效后，应分别验证浏览器与目标程序。若浏览器正常而其他程序失败，优先检查程序是否读取系统代理，不要立刻重装客户端。
启用 TUN 前，先确认虚拟网络接口权限、路由与 DNS 设置，避免与其他网络接管工具同时运行。日常更新保留订阅及规则备份；退出客户端前清除不再使用的系统代理设置，可减少下次登录时网络仍指向本地端口的情况。
安装后的三步检查
安装包选对之后，连接是否正常取决于配置、节点与接管方式。
-
导入订阅
准备有效订阅地址，添加到订阅分组并更新。地址可能包含个人访问凭据，排查时不要把完整链接发到公开页面。更新失败先检查地址是否完整、当前网络能否访问订阅服务，再决定使用哪种更新方式。
-
选择接管方式
桌面端先从系统代理开始，Android 按提示授予 VPN 权限。TUN 适合需要更广流量接管的场景，但仍依赖正确路由与 DNS。系统代理与 TUN 都不是节点本身，切换模式不能修复失效的远端配置。
-
验证实际访问
选中节点并启动连接，测试目标网页，再看日志中的具体错误。一次只调整一个选项，记录修改前后的表现。订阅导入成功只表示配置已经读取，不能替代实际连接测试。
下载与安装常见问题
先分清安装问题与连接问题，再对照处理。
下载客户端后，是否就能直接连接？
还需要有效的订阅地址或节点配置。客户端负责读取配置、启动内核与接管流量，安装包本身不附带可用节点。导入订阅并更新成功后，选择节点，再设置系统代理或启用相应的流量接管模式。
Windows 桌面版与经典 WPF 版怎么选？
初次安装可先选桌面版 Desktop，它使用新一代跨平台界面；习惯传统 Windows 操作布局的用户可选经典稳定的 WPF 版。两个入口都是 v2rayN，菜单位置和界面实现不同，不代表同一节点的连接速度会因此翻倍。
Android 应该选 arm64 还是通用版？
2015 年后的主流手机通常可先选 arm64，但最终以设备实际支持的应用架构为准。遇到架构不兼容或不确定设备类型时，可改选通用版。通用版包含多种架构，下载体积通常更大，并不意味着代理功能更多。
为什么版本文字与下载文件名可能不同？
版本文字与下载路径是版本清单中的独立字段，更新节奏可能不同。按钮使用清单给出的包路径，不会根据版本文字自行拼接文件名。若两者不同，安装前查看系统安装界面显示的应用信息，安装后以客户端关于页面为准。
更新客户端之前需要卸载旧版本吗？
先备份订阅分组、路由规则及自定义设置，再按对应平台的安装方式更新。Android 通常要求包名与签名一致才能覆盖安装；切换客户端或不同分发包时，不要假设可以直接覆盖。遇到冲突先保留旧配置，不要为了继续安装而直接清除数据。
安装成功却无法上网，先检查哪一步？
先确认订阅更新成功、已选中可用节点且系统时间正确，再查看客户端日志。桌面端检查系统代理是否已自动配置，Android 检查 VPN 授权与其他 VPN 应用冲突。只让一个客户端接管流量，先验证基本连接，再添加复杂路由或 TUN 设置。