客户端安装包 · 按系统选择
桌面选 v2rayN，安卓优先选 v2rayNG。先确认系统与架构，再选择安装包。
下载入口集中在下方卡片。安装包只提供客户端，连接前还需准备有使用权限的订阅或配置。
同一客户端，两种界面。下方均为 x64 安装包压缩文件。
桌面版 Desktop采用新一代跨平台 UI，适合新安装用户，以及希望在不同桌面系统上保持相近操作习惯的用户。经典 WPF 版是面向 Windows 的经典稳定版，适合熟悉原有窗口布局、希望延续操作路径的用户。两者的选择重点是界面与使用习惯，不是订阅服务的好坏。
入口文件是 ZIP 压缩包。下载后先完整解压到一个可写目录，找到其中的安装程序，再按照安装器提示继续。不要在压缩包预览窗口里直接启动，也不要只拖出单个程序而遗漏同包文件。若已有旧版运行，先退出客户端，再执行安装，以免文件占用或同时启用两份代理设置。
安装完成后，先打开订阅分组设置，添加订阅地址并保存，再执行更新订阅。列表出现配置不代表系统流量已经进入代理；还需选择活动配置，并根据使用场景设置系统代理。TUN 是后续可选项，建议先验证基础连接，再处理虚拟网卡权限与路由。
| 检查项 | 选择依据 |
|---|---|
| 系统类型 | 在“设置 → 系统 → 关于”查看系统类型。本页两个入口均为 x64，不是 32 位安装包。 |
| 系统兼容 | 以当前安装器的系统与运行时要求为准；旧系统应先确认兼容性，不应只根据文件后缀判断。 |
| 文件与权限 | 需要可写的解压目录和足够的安装空间；安装器、系统代理与 TUN 的权限要求可能不同。 |
| 网络配置 | 首次运行准备完整订阅地址或分享链接；启用 TUN 前检查现有 VPN 与虚拟网卡是否冲突。 |
如果安装器提示缺少运行时，应按具体提示补齐对应环境，而不是凭名称随意安装多个组件。能启动界面但无法连接时，问题通常已经进入配置阶段，可从订阅更新结果、活动配置和系统代理状态开始检查。
查看“关于本机”的芯片信息，选择 Apple Silicon 或 Intel。
打开系统菜单中的“关于本机”。如果显示 Apple 芯片，例如 M 系列，选择 Apple Silicon 的 arm64 包；如果显示 Intel 处理器，选择 x64 包。架构依据是设备芯片，而不是浏览器型号、系统语言或订阅协议。两种文件均为 DMG 磁盘映像，不需要同时安装。
下载完成后打开磁盘映像，按映像窗口提示将应用放入“应用程序”目录，再从该目录启动。不要长期从挂载映像中运行应用；安装完成、应用正常启动后，可推出映像。更新时先退出正在运行的客户端，保留现有设置，再替换应用，避免旧进程与新文件同时存在。
首次启动如果出现系统安全提示，先确认下载来源和文件类型，再阅读系统给出的原因。只针对已确认的应用处理授权，不要为了启动一个程序而关闭整个系统的安全机制。若设备受组织管理，安装与网络扩展权限可能由管理员控制，需要遵循设备策略。
v2rayN 的系统代理与 TUN 是不同的接管方式。浏览器可先通过系统代理验证连接，再决定是否让其他应用使用 TUN。订阅分组、路由选择与 DNS 设置仍需要单独配置；选对芯片包只能解决安装与启动问题，不能替代连接配置。
| 检查项 | 选择依据 |
|---|---|
| 芯片架构 | Apple Silicon 选择 arm64；Intel 选择 x64，以“关于本机”显示的芯片或处理器信息为准。 |
| 系统兼容 | 确认当前应用包支持已安装的 macOS 版本；不能启动时保留完整系统提示用于排查。 |
| 安装位置 | 需要对应用安装目录拥有写入权限，DMG 挂载成功不等于应用已经安装。 |
| 代理权限 | 系统代理与 TUN 可能需要额外授权；受管理设备应先确认组织的网络配置要求。 |
若应用正常启动但部分程序仍然直连，先确认该程序是否遵循系统代理。不要把这类流量接管差异误判为芯片包选错；涉及 TUN、DNS 或路由时，可继续阅读完整文档中的对应章节。
优先选择 v2rayNG；需要 V2Fly 内核兼容时，再考虑 v2flyNG。
v2rayNG 使用 Xray 内核，是本页安卓端的优先选择。2015 年后的主流手机通常可先选择 arm64 包，但“处理器支持 64 位”不一定代表设备系统允许运行 64 位应用。部分设备仍使用 32 位系统；无法确认应用架构时，可选择通用版，避免只凭手机上市年份作判断。
APK 下载完成后，通过浏览器下载记录或文件管理器打开安装。系统可能要求允许当前浏览器或文件管理器安装应用，应只给本次实际使用的来源授权。若出现应用未安装，先检查系统兼容性、剩余空间和旧版签名冲突，不要立即清除现有客户端的数据。
首次启动后添加订阅分组，粘贴完整地址并更新，再选择需要使用的配置。启动连接时，系统会请求 VPN 连接授权；该提示对应流量接管权限，不代表订阅已经有效。连接后应实际打开目标服务验证，不能仅凭状态栏图标判断连接结果。
v2flyNG 使用 V2Fly 内核，适合明确需要该内核行为或已有匹配配置的用户。它不是 v2rayNG 的另一个安装架构，而是独立客户端。两个应用的内核支持范围可能不同，尤其是配置包含特定协议扩展时，应先确认兼容性，不能只按名称相近就认为可以互换。
arm64 与通用版的选择方法和上方一致。更换客户端前保留原有订阅地址与必要设置，新应用安装后重新导入并验证。若同时保留两款应用，启动连接前先停止另一款的 VPN 服务，避免误把流量接管冲突当成订阅失效。备用客户端应按具体需求选择，不必为了尝试而反复迁移数据。
| 检查项 | 选择依据 |
|---|---|
| 应用架构 | 系统支持 arm64 应用时选 arm64；无法确认或设备使用其他受支持架构时，先选通用版。 |
| 系统兼容 | 以 APK 安装器的最低系统要求与设备提示为准；通用版不会降低应用的系统版本要求。 |
| 安装权限 | 为实际打开 APK 的应用授权，安装后可收回该来源的安装权限。 |
| 连接与后台 | 启动时需要 VPN 授权；长时间运行还应检查电池优化与后台限制，按需允许客户端后台工作。 |
如果连接在锁屏后中断，先检查系统是否暂停了后台应用，再查看客户端日志。电池策略、订阅失效与远端连接失败是不同问题，记录发生时机能缩小排查范围。
先匹配发行版的包格式，再匹配 x64 或 arm64 架构。
Debian、Ubuntu 等采用 deb 包管理体系的发行版通常选择 deb；采用 RPM 包管理体系的发行版选择 rpm。包格式相同不保证依赖与系统版本完全兼容，尤其是 RPM 包还可能面向特定发行版系列。安装前应查看软件安装器给出的依赖和兼容提示，不要强行忽略错误。
普通 Intel 或 AMD 的 64 位桌面电脑通常选择 x64，对应文件名中的 amd64 或 x86_64；运行 64 位 ARM 系统的设备选择 arm64，对应文件名中的 arm64 或 aarch64。架构依据是正在运行的系统，而不是仅看处理器品牌。本页提供的是图形客户端，需要可用的桌面会话。
下载后通过发行版的软件安装器打开文件，按提示完成安装。若软件安装器要求补充依赖，先确认发行版的软件源可用，再处理依赖。应用已经安装但无法打开时，可保留启动错误与桌面环境信息，按照文档排查；不要仅修改文件权限就认为兼容问题已经解决。
Linux 各桌面环境对系统代理的读取方式并不完全一致。客户端设置系统代理后，仍需验证实际使用的应用是否遵循该设置。TUN 可用于更广的流量接管，但涉及虚拟网卡权限、路由和 DNS，应在基础配置可用之后再开启，并留意现有网络管理工具的设置。
| 检查项 | 选择依据 |
|---|---|
| 包格式 | 根据发行版选择 deb 或 rpm；同时检查包所需的系统版本与依赖，格式不是唯一条件。 |
| 处理器架构 | x64 对应 amd64 或 x86_64；arm64 对应 aarch64，包与运行系统的架构需要匹配。 |
| 桌面环境 | 需要能运行图形应用的桌面会话，以及安装器要求的运行库。 |
| 安装与网络权限 | 安装系统包通常需要管理员授权；启用 TUN 时还需满足虚拟网卡与网络配置权限要求。 |
先完成安装并打开主界面，再导入订阅。若依赖尚未满足，应停留在安装问题的排查范围，不要同时修改 DNS、路由和订阅，以免把多个变量混在一起。
安装完成后的操作顺序
安装成功只是准备工作。先确认配置可用，再调整流量接管方式。
客户端用于管理配置并启动连接，安装包本身不提供可直接使用的订阅。准备服务提供方交付、且有使用权限的订阅地址或分享链接。订阅地址通常带有个人访问凭据，复制时保留完整参数，不要公开发送，也不要在截图中露出完整地址。
订阅链接与单条分享链接的导入入口可能不同。桌面端通常通过订阅分组设置管理订阅，安卓端通过订阅分组相关菜单添加；单条分享链接则使用相应的剪贴板或扫描入口。导入后执行更新，确认获得的配置类型能由当前客户端内核处理。
查看订阅导入操作选择活动配置后，桌面端可先启用系统代理，安卓端启动连接并确认 VPN 授权。使用实际需要访问的服务验证连接，观察是否可以正常建立请求。仅显示应用正在运行，不能证明目标应用的流量已经采用所选配置。
如果某些桌面程序不读取系统代理，再考虑 TUN。启用前记录原有网络设置，查看权限、路由与 DNS 要求。验证时尽量只改一个设置；遇到问题先关闭刚启用的功能，确认基础连接是否恢复，再继续定位原因。
查看系统代理与 TUN 配合更新客户端前，先查看现有客户端提供的备份或导出功能，保存订阅分组、路由规则、DNS 与个人偏好。不同界面版本或不同客户端之间不一定能直接复用所有配置文件；迁移时应以应用支持的导入方式为准，不能只复制整个目录就假定所有设置会生效。
保留现用包类型和安装位置，退出正在运行的客户端、关闭 TUN 后再更新。完成后先检查订阅分组是否保留，再更新订阅并验证活动配置。备份内容可能包含服务地址和访问凭据，应放在受控位置；向他人求助时，只提供经过隐藏敏感信息的报错和必要环境信息。
v2rayN、v2rayNG 与 v2flyNG 都属于开源客户端生态。Project V、V2Fly 与 Xray 是理解相关技术的重要背景，但客户端名称、内核名称和订阅服务不是同一件事。选包阶段关注系统与架构；连接阶段关注协议、配置和网络环境。两类问题分开处理，排查会更清晰。
桌面版 Desktop 使用新一代跨平台界面；经典 WPF 版使用面向 Windows 的经典稳定界面。新安装可先选择桌面版，习惯经典操作布局的用户可选择 WPF 版。两个入口均为 x64 包，安装前先确认系统类型。
macOS 在“关于本机”中查看芯片，Apple Silicon 选择 arm64，Intel 选择 x64。Android 在设备规格中确认系统支持的应用架构；2015 年后的主流手机通常可先选 arm64，但部分设备仍运行 32 位系统，无法确认时选择通用版。
客户端提供配置管理与连接功能，安装包不包含可直接使用的服务订阅。需要准备有使用权限的订阅地址或分享链接，导入后执行订阅更新，再选择配置并设置系统代理或连接模式。
先确认系统、处理器架构和包格式是否匹配，再查看系统或安装器的完整报错。Windows 的 ZIP 文件需要先完整解压，Android 要检查安装权限，Linux 要检查依赖与发行版兼容性。不要通过反复更换订阅来处理安装阶段的问题。
先使用客户端提供的备份或导出功能保存订阅分组、路由与 DNS 等设置，并记录现用包类型。退出客户端、关闭 TUN 后再更新。备份可能包含订阅凭据，应保存在受控位置，不要公开发送。
先查看浏览器下载记录，区分连接失败、下载被拦截和文件已保存。检查设备剩余空间及当前网络后重试；若遇到组织网络策略限制，应联系管理员。下载失败与订阅更新失败属于不同阶段，需要分别排查。