桌面平台选 v2rayN，Android 首选 v2rayNG。先选操作系统，再核对处理器架构。
安装包只包含客户端。使用前需准备有效订阅地址或分享链接；首次配置可参照使用文档。
两个安装入口均面向 x64 系统。选择熟悉的界面，不必同时安装两版。
桌面版采用新一代跨平台 UI；经典 WPF 版保留 Windows 传统界面。两版都以图形界面管理配置，首次使用可从桌面版开始。
新一代跨平台界面。适合首次安装，或希望在不同桌面平台间保持相近操作习惯的用户。
经典稳定版界面。适合熟悉原有菜单与窗口布局、希望延续既有操作路径的用户。
| 检查项 | 要求与处理 |
|---|---|
| 系统架构 | 本页提供 x64 包。在“设置 → 系统 → 系统信息”中核对系统类型，32 位系统不能使用这两个入口。 |
| 系统版本 | 优先使用仍获安全更新的 Windows 版本；具体最低要求以当前包的安装提示为准。 |
| 运行环境 | 若启动时提示缺少 .NET 桌面运行时，按提示确认所需版本与 x64 架构，不以随意复制 DLL 的方式处理。 |
| 存储与权限 | 下载后完整解压 ZIP，再运行包内安装程序或启动文件。配置目录需可写，安装目录由安装向导确认。 |
不要直接在压缩文件预览窗口内启动程序。先把整个压缩包解压到独立目录，再查看其中的安装入口。安装或首次启动遇到系统安全提示时，先核对下载文件与所选入口是否一致，再按系统给出的说明处理；不要为启动客户端而长期关闭系统防护。
从 WPF 版迁移到桌面版时，先在旧客户端备份配置，记录订阅分组、路由模式和本地监听端口。退出旧实例后再打开新版，确认导入结果。两版同时运行可能争用本地端口，也可能相互覆盖系统代理设置；界面能打开，并不能说明代理接管已经正确完成。
完成安装后，在“订阅分组设置”保存订阅地址，再从订阅菜单执行更新。选中需要使用的配置后设置路由模式，最后通过托盘菜单选择“自动配置系统代理”。系统代理只影响遵循该设置的应用；个别程序仍需单独指定代理地址，具体操作见订阅导入与首次连接步骤。
先打开“关于本机”，按芯片信息选择 DMG，而不是按设备购买年份判断。
桌面图形客户端，提供订阅分组、路由规则及系统代理管理。两个包的区别是处理器架构，配置前先完成应用安装。
“关于本机”的芯片栏显示 Apple M 系列时选此包，优先使用与硬件对应的原生架构。
“关于本机”的处理器栏显示 Intel 时选此包。系统版本名称不能用来判断处理器类型。
| 检查项 | 要求与处理 |
|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64。优先选择原生架构包。 |
| 系统版本 | 使用仍获安全更新的 macOS。具体最低版本由当前应用包的兼容性要求决定。 |
| 应用位置 | 打开 DMG，将应用复制到“应用程序”目录，再从该目录启动；不要长期从挂载映像中运行。 |
| 设置授权 | 修改系统代理或启用相关网络功能时，按实际弹窗授权。普通系统代理与 TUN 所需权限不同。 |
复制应用完成后，可以推出 DMG 挂载卷。若提示“无法验证开发者”，在确认应用来源后，打开“系统设置 → 隐私与安全性”，查看是否出现针对本次启动的放行入口。不同 macOS 版本的按钮位置可能不同，应按当前系统提示操作，不需要全局关闭安全检查。
首次配置先完成订阅导入与配置选择，再启用系统代理。若授权弹窗被取消，界面可能仍能正常显示，但系统代理没有写入成功。此时应返回客户端重新执行对应操作，并查看系统当前网络服务的代理设置，不要仅凭菜单的选中状态判断连接是否成立。
升级前先退出应用，避免新旧实例同时运行。更新后检查订阅分组、路由模式和本地端口是否保留，再用浏览器验证。若浏览器与其他应用表现不同，先确认该应用是否遵循系统代理；不要立刻更换协议或反复导入相同订阅。
先选 v2rayNG；已有明确 V2Fly 配置需求时，再考虑 v2flyNG。
Android 图形客户端，可导入订阅与分享链接，通过系统 VPN 授权接管流量，并按需设置路由和分应用代理。
2015 年后的主流手机通常选此包。还需确认系统支持 64 位应用，不能只看处理器宣传参数。
无法确认架构，或 arm64 包提示不兼容时选择。覆盖更多架构，文件体积通常也更大。
适合需要 V2Fly 内核行为的 Android 配置。不要仅凭订阅能导入就推断所有协议参数均可用，尤其需要检查服务端采用的扩展能力。
适用于支持 64 位应用的 ARM 设备。安装前先确认所用配置与 v2fly 内核兼容。
架构不明确时的备选包。选择通用版不会改变内核类型，也不会补齐另一内核的专有功能。
| 检查项 | 要求与处理 |
|---|---|
| 系统兼容性 | 系统版本需满足所选 APK 的最低要求。安装器提示系统过旧时，改选通用版不能解决版本限制。 |
| 应用架构 | 支持 64 位应用的 ARM 设备优先选 arm64；不确定时使用通用版并查看安装器提示。 |
| 安装权限 | 只为本次使用的浏览器或文件管理器开启“安装未知应用”权限，完成安装后可按需收回。 |
| 连接权限 | 首次连接需确认系统 VPN 请求。通常同一用户空间只能保持一个活动 VPN，其他 VPN 应先断开。 |
| 后台运行 | 需要持续连接时，在系统电池管理中允许客户端后台运行；各设备厂商的菜单名称可能不同。 |
下载 APK 后，通过系统安装器完成安装。若提示“应用未安装”，先阅读具体原因：架构不匹配、系统版本不足、存储空间不足和签名不一致是不同问题。升级安装失败时，不要立即卸载旧版；卸载可能同时删除本地配置，应先备份再处理。
打开客户端后，添加订阅分组并填写地址，再执行更新订阅。选中配置并点击连接，系统会请求创建 VPN 连接；确认后才会进入实际接管阶段。VPN 图标表示本地通道已建立，不代表远端服务一定正常。若仍无法访问，应先检查配置和日志，再检查路由与 DNS。
分应用代理会改变哪些应用进入代理通道。开启筛选后，要区分“仅代理选中应用”和“绕过选中应用”的方向；浏览器未被纳入范围时，可能出现客户端已连接但浏览器未走代理的情况。修改筛选后按客户端提示重建连接，确保新范围生效。内核选择与协议兼容性的区别可查看协议参考。
按发行版选择 deb 或 rpm，再核对 x64 与 ARM 64 位架构。
适用于具备图形桌面环境的 Linux 系统。deb 与 rpm 是不同的软件包格式，不是不同路由模式；能否安装还取决于发行版提供的依赖。
供 Debian、Ubuntu 系发行版优先检查。包名中的 amd64 对应常见的 x86_64 处理器架构。
供采用 RPM 包管理的发行版检查。当前文件带有 el10 构建标记，安装前需特别核对发行版与依赖兼容性。
| 检查项 | 要求与处理 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话。这里的安装包用于桌面客户端操作，不是服务端部署入口。 |
| 包管理体系 | 按发行版使用 deb 或 rpm；系统软件安装器需能够解析该包格式与依赖。 |
| 处理器架构 | x64、x86_64 与 amd64 指同一类常见桌面架构；ARM 64 位包使用 arm64 或 aarch64 标记。 |
| 依赖与授权 | 确认图形运行依赖、系统库及安装授权满足要求。不要忽略依赖报错强行安装。 |
在文件管理器中打开安装包，使用发行版的软件安装器查看包信息、架构与依赖。若提示包格式无法识别，先确认是否选错 deb 或 rpm；若提示依赖无法满足，应检查发行版版本与软件源状态。尤其是带特定发行版构建标记的 RPM，不能因为扩展名相同就认定适合所有 RPM 系统。
安装后从应用菜单启动 v2rayN，再导入订阅。Linux 桌面环境对系统代理的读取方式并不完全一致，部分应用会遵循桌面网络设置，另一些应用需要在自身设置中指定代理。验证时先选择一个明确支持代理设置的应用，确认本地监听地址与端口，再判断是否需要其他接管方式。
需要 TUN 功能时，应先完成普通配置验证，再检查客户端要求的权限与网络环境。不要把整个日常桌面会话长期以高权限运行。更新包前退出旧进程，保留个人配置目录；更新后若启动异常，优先区分图形依赖问题与配置问题，避免把两者混在一起反复修改订阅。
先确认配置有效，再接管应用流量。每次只调整一个环节，方便定位问题。
订阅地址用于批量更新配置，分享链接通常用于导入单项配置。两者都可能包含访问凭据，不要公开粘贴到评论区或截图中。先确认来源和有效期，再选择客户端支持的导入方式。
保存订阅地址之后，还需执行更新订阅。列表出现配置后，选择需要使用的一项，并核对协议类型、传输方式及安全层参数。导入报错时先查看格式兼容性，不要通过随意切换协议来修复。
桌面端设置系统代理，Android 确认 VPN 授权，再检查路由模式和应用范围。验证完成后记录可用设置。需要停止使用时，通过客户端清除系统代理或断开连接，避免留下失效的本地代理地址。
先核对系统、架构与安装方式，再处理连接设置。
首次使用可先选桌面版 Desktop，它采用新一代跨平台界面。经典 WPF 版采用 Windows 传统界面，适合熟悉原有操作路径的用户。两版不要同时运行；迁移前先备份配置，再确认订阅、路由与本地端口。
2015 年后的主流手机通常优先选择 arm64，但仍需确认系统支持 64 位应用。无法确定架构，或 arm64 包提示与设备不兼容时，可选择通用版。通用版覆盖更多架构，不代表连接更快。
打开苹果菜单中的“关于本机”。芯片栏显示 Apple M 系列时选择 Apple Silicon；处理器栏显示 Intel 时选择 Intel。应按设备的实际处理器下载，不按系统版本名称判断。
客户端不随安装包提供可用服务配置。需要先准备有效订阅地址或分享链接，导入后选择配置，再按平台开启系统代理或授权 VPN 连接。订阅导入成功也不等于服务端一定可连接。
先使用当前客户端提供的备份或导出功能，保留订阅分组、手动配置、路由规则及必要的 DNS 设置，并记录本地监听端口。退出旧实例后再更新。备份可能包含认证信息，应保存在个人可控位置。
先按发行版的软件包体系选择：Debian、Ubuntu 系通常使用 deb；采用 RPM 包管理的发行版使用 rpm。再确认处理器架构，x86_64 对应 amd64，ARM 64 位对应 arm64 或 aarch64。包格式一致不等于依赖一定满足，仍需查看包管理器提示。