v2rayN 首推
解压、安装与配置读取
两个入口都以 ZIP 压缩包提供。下载完成后先解压到独立目录，再运行包内安装程序，不要直接在压缩包预览窗口中启动。安装路径应保持稳定；如果程序需要写入配置，应确认当前账户具有相应目录权限。
Desktop 与 WPF 的差异主要在界面技术与交互布局，不能据此判断节点是否更快。切换界面前备份订阅和自定义规则，退出旧客户端，再启动新客户端。不要同时运行两套程序争用本地监听端口；导入配置后还需重新确认活动节点、系统代理和路由模式。
桌面端 v2rayN · 安卓端 v2rayNG / v2flyNG
V2Ray 客户端下载平台、架构与安装包
先选操作系统，再选处理器架构。桌面使用 v2rayN，安卓优先选择 v2rayNG；需要 V2Fly 内核时查阅 v2flyNG。
Windows 安装包
v2rayN 提供 Desktop 与经典 WPF 两种界面。以下入口均为 x64 包，下载前先查看系统类型。
Windows 安装条件
| 检查项 | 本页安装包条件 | 检查位置与操作 |
|---|---|---|
| 处理器架构 | x64 | 打开系统设置中的“系统 → 关于”，检查系统类型。 |
| 系统与运行环境 | 需满足所选客户端发行包要求 | 结合安装器提示确认系统及运行环境，不能仅凭“64 位”判断兼容。 |
| 文件与权限 | 解压后运行安装程序 | 选择可正常写入的目录；TUN 功能可能需要额外权限。 |
| 连接准备 | 有效节点或订阅 | 导入配置，选中节点，再设置系统代理并检查日志。 |
系统代理只对遵循系统代理设置的应用生效。需要覆盖其他应用时，再按客户端实际功能评估 TUN；不要把安装完成、服务启动与流量已被接管视为同一件事。详细操作见 Windows 安装配置章节。
macOS 安装包
v2rayN 按 Apple Silicon 与 Intel 提供 DMG。芯片类型决定架构，订阅和节点类型不影响这一选择。
v2rayN
DMG 安装与首次启动
打开磁盘映像后，按窗口提示把应用放入“应用程序”目录，再从该目录启动。不要长期从挂载的磁盘映像运行应用，以免更新或卸载映像后找不到程序。首次启动时阅读系统提示，确认应用名称、来源与实际执行的操作，不要为绕过提示而关闭整机安全机制。
导入订阅后先选择一个节点，检查客户端是否成功启动内核，再启用系统代理。系统代理与 TUN 是不同的流量接管方式：前者依赖应用遵循代理设置，后者涉及虚拟网络接口和额外权限。首次连接建议先验证系统代理路径，再逐项增加功能，便于区分权限、DNS 与路由问题。
macOS 安装条件
| 检查项 | 本页安装包条件 | 检查位置与操作 |
|---|---|---|
| Apple Silicon | arm64 DMG | “关于本机”显示 Apple M 系列芯片。 |
| Intel 处理器 | x64 DMG | “关于本机”显示 Intel 处理器。 |
| 系统兼容性 | 以发行包要求与系统提示为准 | 架构匹配后，继续确认当前系统能否运行此应用。 |
| 网络权限 | 按所启用功能授权 | 核对系统代理；使用 TUN 时单独检查接口和权限。 |
更新前先退出正在运行的应用，避免新旧进程并存。若替换程序后设置未出现，先检查是否启动了另一个目录中的副本，而不是立即重复导入全部订阅。平台细节见 macOS 安装配置章节。
Android 安装包
v2rayNG 使用 Xray 内核，作为安卓首选；v2flyNG 使用 V2Fly 内核，作为备选。两款应用分别安装、分别管理配置。
v2rayNG 首推
安装与 VPN 连接授权
下载 APK 后，通过系统安装器打开文件；如果系统要求允许当前浏览器或文件管理器安装应用，只为实际使用的来源授予权限。安装完成后打开 v2rayNG，添加订阅分组并更新节点列表，也可导入与内核兼容的分享链接。
选择节点后启动连接，首次运行会出现系统 VPN 授权提示。授权用于建立本地流量接管接口，并不表示节点已经连通。继续检查应用日志与实际访问结果；如果服务在熄屏后中断，再查看电池优化和后台运行限制，避免把后台终止误判为订阅失效。
v2flyNG 备选
跨客户端迁移检查
v2flyNG 与 v2rayNG 的名称相近，但默认内核不同。订阅能被读取，不代表其中每个协议、传输参数或内核扩展字段都可直接使用。迁移时先导入一个明确兼容的节点进行测试，再迁移自定义 DNS 和路由规则；不要把原生配置文件直接覆盖到另一款应用中。
切换连接应用时先停止上一款客户端的 VPN 服务，再启动目标应用。Android 通常只允许一个常规 VPN 服务处于活动状态，多个应用轮流申请接管可能造成连接状态反复变化。需要比较两款客户端时，保持节点、网络和目标请求一致，再结合日志判断差异。
Android 安装条件
| 检查项 | 本页安装包条件 | 检查位置与操作 |
|---|---|---|
| 应用架构 | arm64 或通用包 | 依据设备系统支持的架构选择，不只看处理器宣传名称。 |
| 系统版本 | 满足对应 APK 安装要求 | 在设备设置中查看 Android 版本，并阅读安装器提示。 |
| 安装权限 | 允许当前来源安装应用 | 按系统引导授权，安装结束后可收回该来源权限。 |
| 连接与后台 | VPN 授权及正常后台运行 | 检查其他 VPN 服务、节电限制与客户端日志。 |
若出现“应用未安装”，先确认是否已有同名应用、安装签名是否一致以及设备空间是否足够。需要卸载重装时，应先导出可恢复的配置，避免丢失订阅分组。后续操作见 Android 安装配置章节。
Linux 安装包
v2rayN 提供 deb 与 rpm 包。先按发行版选择包格式，再按处理器选择 x64 或 arm64。
v2rayN
图形安装与依赖检查
把安装包交给发行版的软件安装器打开，先阅读依赖和架构提示，再确认安装。deb 与 rpm 不能通过重命名互换；相同包格式也不保证所有发行版版本都满足依赖。出现安装失败时保留错误明细，优先定位缺失组件或系统兼容条件，不要强制忽略依赖继续安装。
v2rayN 是图形桌面客户端，本页的包选择面向具备图形会话的使用环境。安装后从应用菜单启动，导入订阅并确认本地监听端口。不同桌面环境对系统代理的读取方式可能不同，浏览器代理生效不能代表所有程序都已接管。启用 TUN 前还需检查当前客户端功能、接口权限与已有网络规则。
Linux 安装条件
| 检查项 | 本页安装包条件 | 检查位置与操作 |
|---|---|---|
| 软件包体系 | deb 或 rpm | 依据发行版文档或图形软件管理器确认。 |
| 处理器架构 | x64 或 arm64 | x86_64、amd64 对应 x64；aarch64 对应 arm64。 |
| 桌面与依赖 | 图形会话及发行包所需组件 | 阅读安装器的依赖提示，核对发行版版本。 |
| 代理与权限 | 按桌面环境及模式配置 | 系统代理、TUN 和应用独立代理分别检查。 |
若桌面图标可以打开但内核未启动，应查看客户端日志中的具体报错。端口占用、配置字段不兼容与权限不足需要分别处理，重复安装客户端通常不能解决这些配置层问题。详见 Linux 安装配置章节。
安装之后
订阅、节点与代理按顺序验证连接
01 / 导入
读取自己的配置
客户端安装包不附带可用节点。准备有效订阅或分享链接，导入后检查节点列表是否生成。订阅链接、分享链接与原生 JSON 的导入方式不同，返回内容不匹配时应先确认格式，不要只反复点击更新。
02 / 启动
选择节点与接管模式
选中活动节点后启动服务，先确认日志没有启动错误。桌面端设置系统代理，安卓端批准 VPN 连接；需要 TUN 时再单独检查权限。初次配置尽量只启用一条明确的连接路径，减少多层代理叠加。
03 / 验证
检查实际请求结果
通过浏览器访问与出口 IP 检查验证连接，再观察日志中的请求和路由记录。系统显示连接中，只代表服务或接口已启动，不代表远端节点可用。异常时先区分节点连接、域名解析与应用接管三个环节。
下载常见问题
包格式与安装条件下载前后的六个问题
Windows 桌面版与经典 WPF 版怎么选？
首次安装可先选择 Desktop 桌面版，它采用新一代跨平台 UI；习惯既有 Windows 界面和操作流程时，可选择经典稳定的 WPF 版。两者都需导入自己的节点或订阅。切换前先备份配置，关闭旧程序，再在新程序中确认监听端口与代理设置。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但最终以设备系统支持的应用架构为准。无法确认架构时可选择通用版；若安装器提示不兼容，应先核对系统版本、处理器架构与已有应用签名，而不是反复下载同一个包。
macOS 如何区分 Apple Silicon 与 Intel 安装包？
打开苹果菜单中的“关于本机”，查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon 的 arm64 包，显示 Intel 处理器时选择 Intel 的 x64 包。架构按本机硬件选择，不按订阅格式或所用节点选择。
下载并安装客户端后，能直接连接吗？
客户端负责读取配置和转发流量，安装包不包含可直接使用的订阅或节点。安装后需要导入有效配置，选择活动节点，启动服务，再按平台启用系统代理或批准 VPN 连接。最后通过浏览器请求、出口 IP 和客户端日志确认实际连接结果。
更新安装前需要保留哪些设置？
先备份订阅分组、自定义路由、DNS 与本地监听设置，并记录当前使用的内核和代理模式。更新前退出正在运行的客户端，更新后先检查原配置是否被正确读取，再测试连接。订阅地址和配置可能包含访问凭据，备份文件应保存在受控位置。
Linux 的 deb 与 rpm 可以互换安装吗？
应按发行版的软件包体系选择，不能只修改扩展名。Debian、Ubuntu 系通常使用 deb，Fedora、RHEL 系通常使用 rpm；还需匹配 x64 或 arm64 架构。包格式相同不代表依赖一定满足，安装器报告缺少依赖时，应先查看发行版版本与错误明细。