安装包选择 / 图形客户端
先选系统，再选架构。下载 v2rayN、v2rayNG 或 v2flyNG，安装后继续导入订阅。
选择 x64 安装包。先区分界面版本，再保留现有配置。
使用 v2rayN 管理订阅分组、路由规则与本地代理入口。下面两个包都面向 Windows x64，区别主要在界面技术与桌面交互。首次安装可从 Desktop 开始；已经熟悉经典布局的用户可继续选择 WPF。
采用新一代跨平台 UI。适合首次使用，以及希望在不同桌面系统中保持相近操作习惯的用户。下载完成后先解压，再运行包内安装程序，不要在压缩包预览窗口里直接启动。
采用 Windows 经典界面，是经典稳定版。适合已经建立固定使用流程的用户。切换到另一种界面前，先备份原有订阅与设置；不要把两种版本的程序文件混放在同一目录中。
| 检查项目 | 选择依据 | 操作建议 |
|---|---|---|
| 系统与架构 | Windows x64 桌面环境 | 打开“设置 → 系统 → 关于”，查看系统类型；本页两个包均为 x64。 |
| 系统兼容性 | 优先使用仍受支持的 Windows 版本 | 旧系统能否运行取决于本次客户端及其运行依赖，不能只依据压缩包可以解压判断。 |
| 程序目录 | 当前账户可正常读写 | 解压完整文件后再安装或启动；避免把运行中的程序目录交给同步工具移动。 |
| 接入权限 | 系统代理与 TUN 分开确认 | 普通浏览器使用先测试系统代理；需要 TUN 时，再按客户端提示处理权限。 |
安装前退出正在运行的旧客户端，尤其注意托盘图标是否仍在。首次打开后先导入订阅，确认服务器列表出现有效条目，再选择服务器并设置系统代理。若提示监听端口被占用，先查找旧进程或其他代理软件，不要反复重装。测试结束后通过客户端清除系统代理，再退出程序，避免系统继续指向已经停止的本地端口。
查看 Windows 安装配置 →打开“关于本机”，按芯片信息选择 DMG。
使用跨平台桌面界面完成订阅导入和代理设置。Apple Silicon 与 Intel 两个安装包对应不同处理器，不能按电脑外观或购买年份直接判断。先读取系统给出的芯片信息，再选择下方入口。
适用于“关于本机”中显示 Apple M 系列芯片的电脑。优先使用对应架构的程序，减少兼容层带来的额外变量。完成复制后从“应用程序”中启动，而不是长期在挂载的磁盘映像内运行。
适用于处理器信息显示 Intel 的电脑。文件名中的“64”指向这一架构，不代表所有 Mac 都应选此包。若程序无法打开，先核对处理器与系统版本，再查看系统给出的具体提示。
| 检查项目 | 选择依据 | 操作建议 |
|---|---|---|
| 处理器 | Apple Silicon 或 Intel | 从苹果菜单打开“关于本机”，以“芯片”或“处理器”字段为准。 |
| 系统环境 | 满足所选发行包的运行要求 | 先安装系统可用更新；旧版系统上的兼容性需结合实际启动提示判断。 |
| 安装位置 | 应用程序目录可写 | 打开 DMG 后将应用复制到“应用程序”，完成后再推出磁盘映像。 |
| 网络权限 | 系统代理或虚拟接口权限 | 按系统提示逐项授权；首次排查时不要叠加多个网络接管工具。 |
首次启动遇到安全提示时，先确认提示的应用名称与下载来源，再从系统设置中查看允许操作的具体选项，不要批量关闭系统保护。导入配置后，先用浏览器验证系统代理是否生效。若只有某一个应用不能连接，检查该应用是否读取系统代理；这与客户端是否成功安装是两个问题。准备使用 TUN 前，先阅读权限说明，并保留恢复原网络设置的方法。
查看 macOS 安装配置 →先选 v2rayNG。按应用架构下载，首次连接确认系统 VPN 授权。
使用 Xray 内核，面向 Android 的订阅、分享链接导入与 VPN 接入。2015 年后的主流手机通常先选 arm64；少数设备虽然处理器支持 64 位，系统仍可能限制应用架构，最终应以设备实际支持情况为准。
主流 64 位 Android 设备优先选择。下载后从系统文件管理器打开 APK，按提示为当前安装来源授权；安装结束后可收回该来源的安装权限。
适合无法确认架构或需要兼顾其他支持架构的设备。通用包通常更大，但不会自动解决系统版本过旧、存储空间不足或安装签名冲突。
采用 V2Fly 内核，可作为 Android 平台的另一种选择。选择前先确认已有配置所需的协议和传输能力；不能仅凭名称相近就认定两款客户端能使用完全相同的扩展参数。
适用于支持 arm64 应用的设备。首次打开后重新检查订阅分组与路由设置，再申请 VPN 连接。切换测试时先停止其他正在运行的 VPN 应用。
在架构不明确时使用此入口。保留旧客户端之前，分别确认两款应用的配置保存位置；不要把卸载应用当作排查连接故障的第一步。
| 检查项目 | 选择依据 | 操作建议 |
|---|---|---|
| 应用架构 | arm64 或通用版 | 主流手机先选 arm64；不确定时查看设备信息或使用通用版。 |
| 系统版本 | 满足 APK 声明的最低要求 | 出现解析错误先核对系统兼容性，改用通用版不等于降低最低系统要求。 |
| 安装权限 | 允许当前来源安装应用 | 只为实际打开 APK 的浏览器或文件管理器授权，安装后可关闭。 |
| 连接权限 | 系统 VPN 授权 | 首次连接阅读系统弹窗并确认；切换客户端前先断开原有 VPN。 |
安装完成后导入有权使用的订阅或分享链接，更新服务器列表，再选择连接项。若亮屏时正常、锁屏一段时间后断开，检查电池优化和后台运行限制，按实际需要调整，不必一次性放开全部后台权限。VPN 状态表示流量接入方式，不等于远端服务一定可用；仍需通过实际访问与日志判断连接结果。
查看 Android 安装配置 →按发行版选择 deb 或 rpm，再核对 x64 与 arm64。
使用图形桌面版管理订阅与路由。Debian、Ubuntu 系通常选择 deb；Fedora、RHEL 系通常使用 rpm。包格式相同不代表依赖一定满足，安装前仍要核对发行版版本、桌面环境和处理器架构。
适用于采用 deb 包管理体系且满足运行依赖的图形桌面系统。文件名里的 amd64 对应常见 x64 架构，不限定处理器品牌。使用 ARM 桌面设备时，改选上方 arm64 入口。
适用于采用 rpm 包管理体系且满足该包依赖的桌面系统。注意本页文件名带有 el10 标识，不能据此推断它适配所有 rpm 发行版；若软件安装器报告依赖不满足，先核对系统环境。
| 检查项目 | 选择依据 | 操作建议 |
|---|---|---|
| 包管理体系 | deb 或 rpm | 在系统软件中心或发行版信息中确认，不要通过修改扩展名转换包格式。 |
| 处理器架构 | x64 或 arm64 | amd64、x86_64 对应 x64；aarch64 对应 arm64。 |
| 运行环境 | 图形桌面与所需依赖 | 通过软件安装器读取依赖提示；本页提供图形客户端，按桌面应用流程安装。 |
| 代理接入 | 桌面代理设置或 TUN | 不同桌面与应用读取系统代理的方式有差异，先选择一个浏览器验证。 |
安装时优先使用发行版的软件安装器，让系统显示依赖关系与操作结果。启动客户端后导入配置，确认本地监听成功，再检查桌面网络代理设置。某些应用不会自动遵循桌面系统代理，需要单独配置；终端与浏览器的连接表现也可能不同。启用 TUN 前先处理客户端要求的权限，并检查是否已有其他虚拟网络工具接管流量，避免把权限问题误判为订阅失效。
查看 Linux 安装配置 →把安装、导入与连接分开验证，出错时更容易定位。
自行准备有权使用的配置。客户端负责读取配置与建立连接，安装包不附带可直接使用的远端服务。复制订阅地址时检查是否夹带空格或换行，不要将包含个人访问权限的地址粘贴到公开讨论区。
桌面端先建立订阅分组，再填写地址并更新；Android 端从对应菜单导入订阅或分享链接。更新结束后确认条目确实出现在列表中。订阅请求失败与远端连接失败属于不同环节，应分别查看相关日志。
桌面端先测试系统代理，再按需求考虑 TUN；Android 端确认系统 VPN 授权。选择接入方式后，再检查路由规则。系统代理决定应用如何接入本地端口，路由规则决定流量从哪个出口发送，两者不要混为一项设置。
选择服务器后访问需要测试的页面，并对照日志中的连接结果。界面中的开关状态不能代替访问测试。若发生异常，记录错误发生时间与对应日志，先排查端口、DNS 和远端配置，再决定是否需要更新客户端。
先确定问题所在阶段，再选择对应处理方式。
首次使用可先选 v2rayN 桌面版 Desktop，它采用新一代跨平台界面。熟悉经典 Windows 界面的用户可选 WPF 版，它是经典稳定版。两个入口均为 x64 安装包；升级前先备份订阅分组、路由设置和个人配置，不要直接交叉覆盖两个版本的程序目录。
2015 年后的主流手机通常先选 arm64，但最终应以系统支持的应用架构为准。若设备采用其他架构、使用较旧的系统环境，或无法确认架构，可选择通用版。出现安装包解析错误时，还要检查系统版本、下载是否完成以及是否存在签名不同的旧安装。
需要自行准备有权使用的订阅地址、分享链接或配置文件。安装包提供图形客户端，不附带可直接连接的服务配置。安装后添加订阅分组、更新订阅、选择服务器，再设置系统代理或 VPN 接入；只安装程序不会自动建立代理连接。
先在客户端中导出配置或备份实际使用的配置目录，记录本地端口、路由模式和订阅分组，再退出客户端后升级。不要公开包含订阅地址或连接信息的备份。更新完成后先确认配置能读取，再测试连接；界面设置名称可能随版本调整。
先判断故障发生在安装、启动还是连接阶段。程序能正常打开时，优先查看订阅更新结果、服务器选择、系统代理或 VPN 状态和运行日志。连接被拒、域名解析超时与本地端口占用需要分别排查，重复下载通常不会改变这些配置问题。
首次配置时先只启用一种接入方式。桌面端可先使用系统代理，确认浏览器连接正常后，再按应用需求评估 TUN。TUN 通常涉及额外权限和虚拟网络接口；Android 客户端使用系统 VPN 授权，与桌面端系统代理的操作入口不同。