客户端 / 安装包选择
桌面选 v2rayN，Android 首选 v2rayNG。先确认系统与芯片，再选择安装包。
同一款 v2rayN，两种桌面界面。以下入口适用于 x64 设备。
Windows 桌面客户端 · 7.24.1
新一代跨平台 UI · x64 · ZIP
经典稳定版 · x64 · ZIP
Desktop 使用新一代跨平台界面，适合首次安装或希望沿用跨系统操作习惯的用户；WPF 保留经典 Windows 界面，适合已经熟悉原有菜单和窗口布局的用户。选择重点是界面习惯与运行环境，不是根据包名判断连接速度。两版都需要先导入配置，再选择适合当前应用的代理方式。
下载的是压缩包：先解压整个目录，再运行其中的程序。不要在压缩软件预览窗口里直接启动。
| 检查项 | 适用条件 | 安装前操作 |
|---|---|---|
| 处理器架构 | x64 Windows | 在系统设置的“关于”中查看系统类型；不要仅按电脑品牌选择。 |
| 运行环境 | 以当前包的启动提示为准 | 出现 .NET 运行环境提示时，核对提示中的版本与架构。 |
| 程序目录 | 可写入、可保留的本地目录 | 完整解压，避免临时目录；保留程序与附带文件的相对位置。 |
| 代理权限 | 系统代理与 TUN 的权限要求不同 | 先用普通权限完成配置；需要 TUN 时再按客户端提示处理权限。 |
安装时先建立独立目录，保留下载包解压后的文件结构。若设备上已有 v2rayN，不要把 Desktop 与 WPF 的文件混放在一个目录里。先从旧客户端备份订阅分组和手动节点，再使用新目录启动；确认设置能够迁移后，才清理旧目录。运行库缺失、端口占用、程序文件被隔离是不同问题，应根据具体报错处理，而不是反复更换订阅。
首次连接建议从系统代理开始：保存订阅地址、更新分组、选择节点，再启用系统代理，并用浏览器验证。部分命令行工具不会读取系统代理，需要另设代理环境变量。v2rayN TUN 模式适合需要接管更多应用流量的场景，但仍受路由规则、DNS 设置和系统权限影响；不要把开启开关等同于所有连接都已经经过代理。
先打开“关于本机”查看芯片。Apple M 系列与 Intel 对应不同安装包。
macOS 桌面客户端 · 7.24.1
Apple M 系列 · arm64 · DMG
Intel 处理器 · x64 · DMG
芯片名称显示 Apple M 系列时选择 Apple Silicon；显示 Intel 处理器时选择 Intel。不要用购买年份替代芯片判断，同一年可能存在不同架构的设备。优先使用与设备一致的原生包，遇到无法打开应用的提示时，先核对系统版本、架构和系统安全提示，再判断是否需要其他运行环境。
打开 DMG 后按安装界面将应用放入“应用程序”目录，再从该目录启动并完成首次设置。
| 检查项 | 适用条件 | 安装前操作 |
|---|---|---|
| 芯片 | Apple Silicon 或 Intel | 在“关于本机”中查看芯片或处理器字段。 |
| 系统版本 | 以当前应用包兼容要求为准 | 记录 macOS 版本，遇到启动提示时逐项对照。 |
| 安装位置 | 应用程序目录 | 完成复制后启动，避免长期从磁盘映像中运行。 |
| 网络设置 | 系统代理或客户端支持的接管方式 | 留意其他代理工具是否已经修改同一网络服务的设置。 |
第一次启动可能出现系统安全提示，应先阅读提示内容，确认正在打开的是刚安装的应用，再在系统设置中处理对应授权。不要为了启动一个程序而关闭整套系统安全机制。若应用能够启动但网页连接异常，应转向代理模式、节点与 DNS 排查；安装权限问题通常发生在程序启动阶段，与订阅中的节点是否在线是两条不同的排查路径。
使用系统代理时，检查当前正在使用的网络服务，例如无线网络或有线网络。切换网络后，原先的代理设置未必适用于新的服务。退出客户端前，按客户端提供的方式清除系统代理，避免留下指向已停止本地端口的设置。升级应用前保留订阅与自定义路由；替换程序后，先检查本地监听端口和代理状态，再进行日常访问。
v2rayNG 使用 Xray 内核；v2flyNG 作为 V2Fly 内核备选。两款客户端分别安装、分别管理配置。
Android · Xray 内核 · 2.2.6
主流 64 位设备 · APK
多架构打包 · APK
2015 年后的主流手机通常先选 arm64，但个别设备的系统环境仍可能不同，应以实际兼容情况为准。无法确定架构，或安装时明确提示包不兼容，可以选择通用版。两种包是同一客户端的架构分发方式，不是功能高低不同的版本。v2rayNG 适合使用 Xray 配置与相关协议组合的用户，具体能力仍以所装版本为准。
第一次连接需要确认系统 VPN 授权。安装完成后先导入配置，再启动连接。
Android · V2Fly 内核 · 1.10.31
64 位设备 · APK
多架构打包 · APK
v2flyNG 面向希望使用 V2Fly 内核的 Android 用户。选择它之前，应确认订阅提供的协议与传输设置能够被当前版本识别，不要假定另一个客户端支持的所有参数都能直接迁移。两款应用可以保留各自配置，但测试连接时应先停止正在运行的 VPN 会话，再启动另一个客户端，避免把系统接管冲突误认为节点问题。
已有配置不会因为安装另一款客户端而自动同步；迁移时重新导入订阅，并检查自定义设置。
| 检查项 | 适用条件 | 安装前操作 |
|---|---|---|
| 设备架构 | arm64 或通用包覆盖的架构 | 优先核对设备信息，无法确认时使用通用版。 |
| 系统兼容性 | 以 APK 的安装要求为准 | 若系统提示版本不兼容，记录 Android 版本和错误文本。 |
| 安装来源 | 允许当前下载或文件管理应用安装 | 按系统提示仅授权此次使用的安装来源。 |
| 连接权限 | 系统 VPN 授权 | 首次启动连接时确认授权，检查是否有其他 VPN 会话。 |
| 后台运行 | 按设备电池策略设置 | 锁屏后连接中断时，检查应用后台与电池限制。 |
安装 APK 与连接 VPN 是两个步骤。系统允许安装来源，只代表应用能够安装；启动连接时仍需单独确认 VPN 权限。升级时若提示应用签名不同，不要急于卸载，因为卸载可能清除本地节点和设置。先备份配置，再核对原有安装来源与新包是否属于可直接覆盖的分发方式，必要时按迁移流程重新安装。
v2rayNG 订阅导入应先创建订阅分组，填写地址并保存，再执行更新订阅。更新成功后选择一条节点，启动连接并检查浏览器访问。若锁屏后中断，先检查后台限制；若只有某个应用异常，再检查分应用代理列表。客户端的测试结果用于帮助筛选节点，不代表所有应用访问目标的体验都相同。
按发行版的软件包体系选择 deb 或 rpm，再核对 x64 与 arm64 架构。
Linux 桌面客户端 · 7.24.1
Debian 系包格式 · x64
RPM 系包格式 · x64
deb 通常用于 Debian、Ubuntu 等采用该包体系的发行版；rpm 用于采用 RPM 包体系的发行版。包格式相同并不意味着每个发行版版本都满足依赖条件，安装前仍需查看包管理器提示。x64 包中的 amd64 或 x86_64 是架构标记，arm64 包中的 arm64 或 aarch64 则对应另一类处理器，不能互相替代。
这里提供图形桌面客户端。选择包时同时考虑桌面环境、发行版依赖与处理器架构。
| 检查项 | 适用条件 | 安装前操作 |
|---|---|---|
| 软件包体系 | deb 或 rpm | 在发行版的软件安装工具中确认可安装的包格式。 |
| 处理器架构 | x64 或 arm64 | 通过系统信息核对架构，不按软件包后缀猜测。 |
| 桌面环境 | 可运行图形应用的桌面会话 | 确认应用菜单与图形安装工具可用。 |
| 依赖与权限 | 满足当前包的依赖要求 | 按包管理器提示解决依赖；代理接管权限另行配置。 |
建议通过发行版的图形软件安装工具打开软件包，查看依赖和安装结果。安装工具报错时先记录具体依赖名称与系统版本，不要反复打开同一个包。若已安装其他来源的同名应用，先确认当前配置保存位置和包管理状态，避免把程序文件替换与用户设置迁移混为一谈。升级前保留自定义路由和订阅，完成安装后再检查连接。
Linux 桌面系统代理、浏览器自身代理和终端环境变量可能分别生效。客户端显示已启动，只表示本地服务已经运行，不意味着每个应用都会读取代理设置。先用一个明确采用系统代理的应用验证，再逐个检查其他程序。需要更广范围的流量接管时，应查看客户端支持的模式、权限与 DNS 配置，不要同时开启多套相互竞争的接管规则。
先查看系统类型、处理器架构以及已有客户端的安装位置。安装包格式用于决定如何安装，架构用于决定程序能否运行，两者都正确后才进入下一步。已经使用客户端的设备，应先备份订阅分组、手动添加的节点、自定义路由和本地端口设置。订阅能重新更新，不代表所有手动设置都会随之恢复。
第一次安装可以直接按平台选择入口；更换界面版本或客户端时，则需要把迁移当作独立步骤。尤其是桌面端不同程序目录、Android 两款应用之间，不应默认配置自动共享。遇到错误时保留原始提示和当前系统信息，有助于区分安装问题、权限问题与连接问题。
客户端是配置管理与连接入口，安装包本身不提供订阅。准备好有权使用的订阅地址后，在分组设置中填写地址、保存并更新。订阅地址可能包含访问凭据，截图、求助或同步笔记时应隐藏完整链接。更新后检查协议类型和节点备注，选择节点，再开启对应的系统代理或 VPN 模式。
V2Ray 节点测速应与实际访问验证结合。测试失败可能来自测试目标、DNS 或网络环境，不宜仅凭一次结果删除整个分组。需要理解 VLESS 协议与其他传输搭配时，查看配置说明；V2Ray 协议选择最终必须与服务端提供的参数保持一致。
V2Ray 客户端负责订阅、节点列表、路由设置与启动控制；内核负责按配置处理连接。Project V 是理解这一生态的背景，V2Fly 与 Xray 属于相关内核家族，不是操作系统名称。下载时先按设备选择图形客户端，配置时再关注订阅要求的协议与传输能力，这样能避免把内核名称当作安装包架构来选择。
v2rayN 用于桌面平台，可在客户端支持的范围内管理相关内核与配置；v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 面向 Android，使用 V2Fly 内核。三款客户端的配置界面和可接受参数不必完全一致，订阅能否导入也需要结合当前版本判断。遇到某种协议无法识别时，先确认订阅格式和客户端能力，再考虑调整选择。
代码开源说明项目可以被研究与改进，但具体安装仍需关注系统兼容性和升级迁移。日常使用不必追逐每一个界面改动；只有当前功能需求、兼容问题或修复内容与设备有关时，升级才有明确目标。升级后先检查订阅分组与路由是否保留，再进行实际访问测试，避免把升级后的默认设置误当作原有设置。
首次安装可先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合习惯原有 Windows 界面的用户。两种安装包都应先完整解压，迁移前备份现有配置，不要直接混合覆盖两个版本的程序目录。
打开系统菜单中的“关于本机”。芯片显示 Apple M 系列时选 Apple Silicon，处理器显示 Intel 时选 Intel。安装包名称中的 arm64 对应 Apple Silicon，64 对应此处的 Intel 入口。
2015 年后的主流手机通常先选 arm64，但仍需以设备实际架构为准。通用版包含多种架构，适合架构不明确或 arm64 包提示不兼容的设备。两者是同一客户端的不同打包方式，不代表节点或协议能力的等级差异。
安装包提供客户端程序，不等于已经配置连接。启动后需要导入有权使用的订阅地址或节点配置，更新订阅并选择节点，再设置系统代理或 VPN 接管方式。订阅地址可能包含访问凭据，不要公开分享完整链接。
先备份订阅分组、手动节点、自定义路由和相关设置，并记录当前使用的代理模式与本地端口。退出旧程序后再安装或解压新包。首次启动确认分组和路由正常，再更新订阅；不要同时运行两个占用相同本地端口的客户端。
先核对系统与处理器架构，再确认压缩包已经完整解压。Windows 按启动提示检查所需运行环境，macOS 查看系统安全提示，Android 检查安装来源授权与签名冲突，Linux 查看软件包依赖提示。保留具体错误信息，再按对应平台排查。