先确认操作系统与处理器架构，再选择对应安装包。
v2rayN
按使用习惯选择桌面版或经典 WPF 版。桌面版采用跨平台界面；WPF 版保留经典窗口布局，两者均可管理订阅与系统代理。
前往下载 →v2rayN
打开“关于本机”查看芯片信息。Apple Silicon 与 Intel 使用不同安装包；完成安装后，按系统提示确认启动和网络相关权限。
前往下载 →v2rayNG / v2flyNG
优先查看采用 Xray 内核的 v2rayNG；需要 V2Fly 内核时再了解 v2flyNG。按设备架构选择安装包，首次连接需确认系统 VPN 授权。
前往下载 →v2rayN
按发行版选择 deb 或 rpm，再区分 x64 与 arm64。这里介绍带桌面环境的图形客户端，安装后需单独确认桌面系统代理是否生效。
前往下载 →下载客户端只完成了本地工具准备。服务器地址、协议参数和订阅地址需要由配置提供方给出，客户端本身不会自动生成可用的远端连接。拿到配置后，先确认它是订阅地址、单条分享链接还是完整配置文件，再选择对应导入入口。把订阅地址当成分享链接粘贴，或把网页地址当成订阅地址更新，都可能导致列表为空。
首次安装建议保留默认监听设置，先导入一份来源明确的配置，选中服务器，再启用一种接入方式。不要同时修改端口、DNS、路由与内核；出现问题时很难判断是哪一项造成变化。桌面端可先用系统代理验证浏览器，安卓端先确认 VPN 授权和连接通知。待基础连接可用后，再按应用需求调整分流和后台运行策略。
查看全部客户端 →按任务找到设置项。示意卡用于说明，不会改变本机配置。
按配置来源建立订阅分组，再填入订阅地址并执行更新。分组能保留来源关系，后续刷新时不必逐条重新导入；单条分享链接则适合临时测试。更新前检查网络是否能访问订阅地址，更新后核对服务器列表和当前选中项。若列表为空，先看日志，不要反复删除全部配置。订阅地址可能包含访问凭据，截图与求助时应遮住完整地址。与手动维护多条连接相比，分组更新更便于统一管理，但是否可用仍取决于配置来源。
用路由规则决定请求交给直连、代理还是阻断出口。先选择客户端提供的基础路由，再按需求补充域名或地址规则，避免一开始就维护庞大规则集。匹配通常按规则顺序进行，更具体的条件应放在合适位置；局域网设备访问异常时，先检查私有地址是否被送入代理。系统代理只解决流量如何进入客户端，路由才决定进入后的去向。调整后使用同一应用、同一目标复测，并核对日志中的出口，不能只根据模式名称判断实际行为。
先用系统代理接入遵循系统代理设置的应用；需要覆盖其他流量时，再评估 TUN。系统代理通常不要求虚拟网卡权限，但部分程序会忽略它。TUN 通过虚拟网络接口接入流量，涉及权限、路由和 DNS，开启前应确认当前平台支持及所需组件。排查时先只启用一种方式，避免多个代理工具同时接管网络。关闭客户端前清除系统代理，关闭 TUN 后检查网络是否恢复。两种方式不是速度档位，也不代表所有流量必然走同一个出口。
把客户端界面与实际处理连接的内核分开理解。界面负责编辑、导入和启动，内核负责解析配置、建立传输及执行路由。选择内核前先核对协议、传输方式和参数是否受支持；同一协议名称下的扩展能力也可能不同。v2rayN 可按所选配置与客户端支持范围使用对应内核，安卓端则需区分 v2rayNG 与 v2flyNG 的内核家族。切换后重启连接并查看启动日志。不要把内核切换当作通用修复按钮，配置不兼容时应回到具体参数检查。
先记录失败时间，再打开日志复现一次操作。启动错误优先检查监听端口、权限和配置解析；连接阶段再区分域名解析、远端连接及握手失败。看到超时不应立即更换所有设置，先确认失败的是订阅更新还是实际代理请求，两者使用的网络路径可能不同。临时提高日志详细程度可以辅助定位，完成排查后再恢复常用级别。分享日志前隐藏地址、订阅凭据和个人路径，只保留与失败有关的上下文，比单独截取最后一行更容易判断原因。
沿着“导入配置 → 选中服务器 → 设置接入方式 → 验证实际请求”的顺序操作。界面名称会随平台和客户端更新略有变化，找不到入口时，先查看主窗口的设置菜单、托盘菜单和日志区域，不要直接套用其他平台的权限处理方法。
查看代理模式设置步骤 →区分项目、内核和界面，按配置要求选择工具。
V2Ray 属于 Project V 相关的代理工具生态，核心思路是将入站、出站、传输与路由等能力组合起来。日常使用时，用户通常不需要直接编辑整份底层配置，而是通过图形客户端填写参数或导入订阅。搜索“V2Ray”时看到的名称可能指项目、内核，也可能泛指这一类客户端；先分清讨论对象，才能判断一份教程是否适用于当前设备。
把连接过程拆成几层会更容易理解：应用先将请求交给本地入口，本地内核按规则选择出口，再使用服务器配置建立连接。客户端的服务器列表只是配置管理界面，并不等于远端服务本身。界面能正常打开，不能证明服务器可达；连接按钮处于开启状态，也不能代替实际网页或应用请求测试。这些区别是后续排查的基础。
V2Fly 社区延续 V2Ray 相关内核的开发维护，Xray 则从相关代码基础发展出独立的内核项目。二者共享部分技术背景，但支持能力、配置细节与更新节奏并不完全相同。选择时应核对当前连接所需的协议、传输和安全参数，而不是只比较项目名称。涉及特定扩展时，还要确认客户端是否已经提供对应的编辑与导入支持。
导入成功只表示客户端识别到了配置，不一定代表所有参数都已经被当前内核正确使用。如果某条配置能在一款客户端连接、换到另一款却失败，应先比较内核家族、传输设置和生成配置的差异。不要把其他平台的底层片段直接覆盖到正在使用的配置中；先备份，再根据该客户端支持的入口逐项调整。
v2rayN 面向桌面平台，提供服务器列表、订阅分组、路由与日志等图形管理入口。跨平台桌面版和 Windows 经典 WPF 版的界面与运行环境不同，选择时先看系统支持，再看窗口布局和使用习惯。同一台电脑测试不同版本前，建议分别保存程序与配置目录，避免直接混用文件造成设置覆盖或迁移误解。
v2rayNG 面向 Android，采用 Xray 内核，适合在手机上完成订阅导入与系统 VPN 接入。v2flyNG 同样面向 Android，采用 V2Fly 内核，可作为有对应内核需求时的备选。两款应用需要各自确认连接权限与后台运行设置；切换测试时先停止另一款的连接，避免系统 VPN 接入状态相互影响。手机休眠后断连，应结合电池策略和日志判断，而不是只重复导入订阅。
这三款客户端均以开源方式开发，源代码的公开使功能实现与配置处理具有可讨论、可检查的基础。开源并不意味着整个生态采用同一份许可证：v2rayN 与 v2rayNG 采用 GPL 系列许可，V2Ray 内核采用 MIT 许可，Xray 内核采用 MPL 2.0。客户端、内核及随附依赖应分别查看对应项目的许可文本，涉及修改、分发时尤其如此。
对普通使用者而言，更直接的关注点是安装包适用平台、所需权限、配置来源和更新说明。代码公开不能替代对订阅提供方的判断，也不能保证每一种网络环境都能正常连接。分享配置、截图或排错材料时，仍应保护订阅地址及连接凭据。需要他人协助时，描述系统、客户端类型、失败步骤和相关错误即可，不必公开完整配置。
客户端更新、内核更新与订阅更新是不同任务。客户端更新可能改变界面和配置生成方式；内核更新可能影响协议与传输行为；订阅更新则用于刷新服务器配置。遇到“更新后不能连接”，先确认发生变化的是哪一层。下载页集中提供安装入口，首页只负责平台选择与操作导航，具体安装要求以下载页及相应说明为准。
升级前备份订阅分组、手动配置和自定义路由，关闭正在运行的连接，再按平台要求完成安装。升级后先用原有可用配置验证一次，确认正常后再调整新功能。若出现异常，记录变更前后的操作与日志，避免连续更新多项内容后失去对照。恢复旧配置时也要注意兼容性，不要将新旧程序文件随意合并到同一目录。
验证时先确定测试应用是否遵循系统代理，再访问可用于确认网络出口的页面。浏览器可用而某个桌面应用不可用，往往需要先检查该应用的代理行为；只有部分域名异常，则应继续检查路由和 DNS。日志中的成功启动信息只表明内核运行起来，不能作为所有应用均已接入的依据。测试应尽量固定应用与目标，保持前后结果可比较。
端口占用时先退出重复运行的客户端或其他监听程序；更改本地端口后，还要同步使用该端口的应用设置。退出客户端后网络异常，则先确认系统代理是否仍指向已经停止的本地监听。按“入口、路由、解析、远端连接”的顺序检查，通常比反复重装更有针对性。完整文档按平台整理安装、订阅、代理与常见问题，可在基础配置完成后继续查阅。
从界面选择、端口冲突到安卓后台策略，按遇到的问题阅读。
对比 v2rayN 的 Avalonia 跨平台桌面版与仅限 Windows 的 WPF 版，从界面风格、系统支持、托盘行为到运行依赖，说明不同用户该选哪个。
阅读版本选择说明 →v2rayN 启动提示端口占用时，用系统命令查出占用 10808 等端口的进程，再在参数设置中改本地监听端口并同步系统代理。
阅读端口排查步骤 →分析 v2rayNG 在安卓上耗电偏高的常见原因，讲清电池优化白名单、后台运行限制与 VPN 常驻通知的取舍，按机型给出调整思路。
阅读后台设置建议 →