v2rayN
首推两版都用于管理节点、订阅与代理设置，主要区别在界面实现和平台适用范围，而不是“选了某一版就会更快”。桌面版采用 Avalonia 跨平台界面，WPF 版沿用 Windows 专用界面。已有稳定配置的用户可以先保留原设置，不必只为界面变化迁移；确需切换时，先备份配置，再在新界面中核对分组与路由。
客户端安装包
V2Ray 客户端下载
v2rayN、v2rayNG 与 v2flyNG。先选操作系统，再按处理器架构选择安装包；桌面端与手机端的首次配置方法在下载入口下方说明。
按设备选择
平台与安装入口
桌面系统使用 v2rayN；Android 优先选择基于 Xray 内核的 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。切换平台后，页面地址会保留当前选择，方便下次继续查看。
系统与安装准备
| 检查项 | 选择依据 |
|---|---|
| 处理器 | 本页提供 x64 包；在“设置 → 系统 → 系统信息”查看系统类型。 |
| 系统兼容性 | 使用仍受支持的 Windows；具体最低版本与运行环境以安装提示为准。 |
| 文件处理 | 保留解压后的完整目录，不只拖出其中一个可执行文件。 |
安装后的检查顺序
从浏览器下载记录打开压缩包，将内容完整解压到可写目录，再运行安装程序。若系统提示缺少运行环境，先读清组件名称与体系结构，不要反复更换客户端包来绕过同一个提示。启动后先导入订阅或节点，选定可用配置，再从“系统代理”菜单选择“自动配置系统代理”。
测试另一版时先退出原进程，避免两个客户端争用监听端口。关闭客户端前，可先选择“清除系统代理”，以免系统仍指向已经停止的本地服务。若安装成功却不能访问，下一步应检查配置与日志，而不是直接重新安装。
安装后无法连接的排查顺序 →
v2rayN
桌面客户端打开苹果菜单中的“关于本机”：显示 Apple 芯片名称时选择 Apple Silicon，显示 Intel 处理器时选择 Intel。优先使用与硬件一致的原生架构，避免依赖兼容转换来运行另一种包。下载完成后打开 DMG，按磁盘映像中的提示将应用放入“应用程序”，再从该位置启动，而不是长期从临时挂载的映像运行。
系统与权限准备
| 检查项 | 选择依据 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64；Intel 对应 x64。 |
| 系统兼容性 | 最低系统版本以当前应用的启动提示与发行说明为准。 |
| 安装与授权 | 将应用放入“应用程序”；首次运行时按系统提示确认相关权限。 |
首次打开与代理设置
首次打开若被系统阻止，先确认下载来源和文件类型，再进入“系统设置 → 隐私与安全性”查看对应的拦截说明。只有确认要运行此应用时才使用系统提供的放行选项，不需要为安装客户端整体关闭系统安全机制。若提示架构或系统版本不匹配，应返回核对安装包，而不是反复授权。
客户端运行后，先导入配置并选定节点，再启用系统代理。系统代理只对遵循该设置的应用生效，并不代表所有进程都会自动使用代理。测试时先用浏览器访问已知目标，再对照客户端日志；遇到局域网访问权限提示时，按实际使用场景决定是否授权。
查看 macOS 首次打开与权限说明 →
v2rayNG
首推v2rayNG 是 Android 上的图形客户端，使用 Xray 内核处理连接。首次安装可先选它，并根据订阅所需的协议与传输参数检查兼容性。安装后通过“订阅分组设置”添加地址，再执行订阅更新；也可以导入自己有权使用的节点配置。准备好节点后点击连接按钮，阅读并确认系统 VPN 连接请求。
v2flyNG
备选v2flyNG 使用 V2Fly 内核，适合已有对应配置或需要对照内核行为的用户。不要把更换客户端理解为所有连接问题的通用修复方法：服务端不可达、订阅过期或参数错误时，切换内核未必改变结果。迁移前先保存原配置，并确认新客户端支持其中的协议与传输组合，再逐项导入和测试。
设备与安装准备
| 检查项 | 选择依据 |
|---|---|
| 应用架构 | 主流手机通常选 arm64；不确定时可考虑通用版。 |
| 系统兼容性 | 以 APK 安装器给出的最低系统版本与兼容提示为准。 |
| 安装权限 | 仅为打开 APK 的浏览器或文件管理器按需授权安装。 |
| 连接权限 | 启动连接时确认系统 VPN 请求，避免与其他同类连接冲突。 |
安装提示与后台运行
下载 APK 后，从下载记录或文件管理器打开。若系统要求允许此来源安装应用，确认来源后只为当前使用的应用授权，安装完成可按需收回。提示“应用未安装”时，先看是否存在签名冲突、系统不兼容或空间不足；不要未经备份就卸载原客户端，否则本地配置可能随之删除。
首次连接成功后，还应测试锁屏一段时间是否保持连接。部分系统会限制后台活动，可在电池与后台管理中按需调整客户端策略；具体名称因设备厂商而异。如果已运行另一个 VPN 应用，应先停止原连接，再启动当前客户端。测速结果只反映当时测试目标的响应，不代表所有应用都已正确分流。
继续查看订阅导入与连接步骤 →
v2rayN
图形桌面版先判断发行版使用哪种包管理体系，再确认机器架构。deb 与 rpm 的区别不在功能，而在安装和依赖管理方式；amd64、x86_64 通常指同一类 x64 架构，arm64、aarch64 则对应另一类架构。包格式匹配只是第一步，仍需检查当前发行版能否满足该包依赖，不能把任意 rpm 或 deb 包视为适用于所有同类系统。
桌面环境与依赖
| 检查项 | 选择依据 |
|---|---|
| 运行环境 | 需要可用的图形桌面会话，本页提供图形客户端安装包。 |
| 包格式 | 按发行版包管理体系选择 deb 或 rpm。 |
| 处理器架构 | x64 选择主入口，arm64 使用对应的小字入口。 |
| 依赖兼容性 | 由系统软件安装器检查依赖，存在冲突时先处理提示。 |
安装后确认应用代理
使用系统的软件安装器打开下载的包，阅读依赖列表和安装结果。若软件安装器报告依赖无法满足，先确认发行版版本与包的适配范围，不要直接强制忽略依赖。安装完成后从应用菜单启动，在正常用户会话中导入配置；日常使用不应仅为绕过权限错误就把整个客户端长期以高权限运行。
不同桌面环境对系统代理的读取方式不完全一致。客户端已监听端口，并不等于浏览器、终端工具和所有桌面应用都会自动接管。先选择一个明确支持代理设置的应用测试，再确认它的地址与端口是否对应客户端。局域网共享属于另一个场景，初次安装不需要为此扩大监听范围。
查看系统代理与本地端口排查 →从安装到连接
安装完成后的三项检查
客户端是配置管理与流量转发工具。程序可以正常打开，只说明安装阶段基本完成；订阅、节点和代理接管仍需分别确认，按顺序操作更容易定位问题。
先确认订阅内容
在“订阅分组设置”中填入有使用权限的地址，保存后更新订阅。若导入的是分享链接，应保留完整内容，避免聊天软件换行或遗漏字符。订阅地址可能包含访问凭据，不要将完整地址贴到公开截图或日志中。
更新后先确认出现节点，再检查分组、协议和必要参数。订阅请求成功与节点连接成功是两个不同环节；若列表为空，优先看更新日志，不要直接开启更多代理模式。
再设置代理入口
桌面端选定节点后，可从系统代理开始测试。应用若单独填写了代理地址，应确认端口与客户端一致。Android 需要在启动连接时确认系统 VPN 请求；同一时间运行其他 VPN 应用可能导致当前连接被替换。
初次使用先保持路由设置简单，不要同时修改 DNS、监听地址和多套分流规则。一次只改一项，才能把现象与具体设置对应起来。
最后对照访问与日志
用实际需要访问的网站或应用验证连接，并同时查看日志是否出现错误。节点测速可用于初步筛选，但一次测试成功并不能证明所有协议、目标和应用都正常；浏览器缓存与已有连接也可能影响观察。
如果无法连接，记录出错时的操作和提示，按本地监听、代理设置、节点配置、服务端可达性的顺序排查，比反复更换安装包更有针对性。
下载与安装答疑
安装包常见问题
Windows 应该选桌面版还是经典 WPF 版？
首次使用可选 v2rayN 桌面版，其采用新一代跨平台界面；熟悉原有 Windows 操作布局的用户可选经典稳定的 WPF 版。两个入口均为 x64 安装包，迁移前先备份订阅与路由设置，不要让两版同时占用同一本地监听端口。
Android 的 arm64 与通用版怎么选？
2015 年后的主流手机通常优先选择 arm64，但仍需以设备实际支持的应用架构为准。若系统提示安装包与设备不兼容，先确认系统版本与架构，再尝试通用版；通用版覆盖更多架构，下载体积通常更大。
下载并安装客户端后就能连接吗？
不能仅凭安装完成判断连接已就绪。客户端负责读取配置和转发流量，还需要自行准备有使用权限的订阅地址或节点配置。导入后选择节点，再设置系统代理或在 Android 上启动 VPN 连接，最后通过实际访问与日志确认结果。
下载中断或安装包打不开怎么办？
先查看浏览器下载记录，确认任务已结束而不是仍在下载；中断时可重试当前入口。Windows 的 ZIP 文件需先完整解压，再运行其中的安装程序。其他系统应先确认包格式与处理器架构匹配，若仍被拦截，阅读系统提示后再决定是否授权安装。
升级客户端会保留原来的订阅和规则吗？
是否沿用配置取决于原安装方式、配置目录和新旧版本的兼容性，不能一概保证。升级前通过客户端可用的导出或备份功能保存设置，退出旧进程后再安装。升级完成先检查订阅分组、当前节点、监听端口与路由模式，再恢复日常使用。