Windows
v2rayN在下载中心选择桌面版或经典 WPF 版。桌面版采用新一代跨平台界面，WPF 版保留经典桌面操作方式。两者都应先确认系统与运行环境要求，不要仅凭文件大小判断适用性。
安装后先打开主窗口，检查日志是否出现内核启动错误，再导入订阅。已有配置的用户先保存订阅分组与自定义路由，避免迁移时只复制程序文件而漏掉实际设置。
订阅导入
到连接生效
按配置环节查看设置。先让一个节点完成实际请求，再逐步添加分流、接管与内核选项。
保存地址，按分组更新
打开订阅分组设置，为来源填写别名，将完整订阅地址放入可选地址 Url，并保持启用。保存后执行更新订阅，节点才会出现在服务器列表；只保存地址不等于已经导入。多个来源分别建组，便于筛选、更新与定位失效地址。首次配置先留空过滤(正则)和 User-Agent，避免筛选条件隐藏节点。自动更新间隔按来源说明设置，更新失败时再区分通过代理与不通过代理两条请求路径。
了解详情区分端口探测与实际请求
更新订阅后，先选中候选服务器，再执行真连接延迟测试。TCPing 主要反映到目标端口的连接情况，不能代替协议握手与实际访问；真连接延迟会经过代理链路请求测试地址，更接近首次连接的判断需求。结果仍受测试目标、当前网络与服务端负载影响，不应只按单次数字排序。选定节点后设为活动服务器，再打开目标应用验证。若测试失败，先查看日志中的握手或解析报错，不要直接开启更多代理选项。
了解详情按规则选择出站路径
路由分流决定进入内核的请求走 direct、proxy 还是其他已定义出站，不负责让应用流量自动进入客户端。先确认系统代理或 TUN 已生效，再检查规则是否命中。规则通常按顺序匹配，将局域网等明确例外放在前面，避免宽泛条件提前截获请求。域名策略 AsIs、IPIfNonMatch、IPOnDemand 影响域名解析参与匹配的时机，应结合规则类型选择。修改后分别访问直连与代理目标，并查看日志验证路径。
了解详情先选接管方式，再看分流
系统代理会修改操作系统的代理设置，适合遵循该设置的浏览器和应用；自行管理连接的程序可能不会使用它。TUN 通过虚拟网络接口接管流量，覆盖方式不同，也涉及权限、路由与 DNS 配置。首次使用建议先设置系统代理，确认节点可用后再考虑 TUN，不要把两个开关同时开启作为默认排错动作。切换方式前记录原设置，退出时确认代理已清理。若浏览器正常而其他应用失败，应先核对该应用采用的代理路径。
了解详情按协议能力匹配内核
图形客户端负责管理配置，内核负责处理协议、传输与路由。订阅能被识别，不代表当前内核一定支持其中全部参数。涉及 VLESS、XTLS Vision 与 REALITY 的配置，应核对 Xray 的对应支持；其他配置也要以实际内核能力为准。切换内核前保存订阅与自定义路由，切换后重新测试活动服务器并查看启动日志。不要把其他内核的字段直接复制进现有配置，也不要仅凭界面外观判断两款客户端的功能是否相同。
了解详情客户端下载入口
按系统选择安装格式
桌面端选择 v2rayN，移动端先看 v2rayNG。先核对处理器架构，再选择安装文件；订阅地址与安装包是两类内容，安装客户端并不会自动获得可用节点。
macOS
v2rayN根据“关于本机”显示的芯片选择 Apple Silicon 或 Intel 安装入口。芯片类型决定所需架构，不能用设备外观或购买年份替代判断。安装后按系统提示完成首次打开与权限确认。
先通过系统代理验证浏览器连接，再评估是否需要 TUN。若出现系统安全提示，核对应用来源与具体提示内容，不要为了启动程序而整体关闭系统安全机制。
Android
v2rayNG 优先优先选择使用 Xray 内核的 v2rayNG；需要 V2Fly 内核配置时，再考虑 v2flyNG。主流较新设备通常选择 arm64，无法确认处理器架构时查看通用版入口和设备系统信息。
导入订阅后更新服务器列表，启动连接时确认系统的 VPN 授权。其他占用同一 VPN 通道的应用可能影响启动；后台中断则继续检查省电策略和后台运行权限，而不是反复重新导入订阅。
Linux
v2rayN按发行版的软件包体系选择 deb 或 rpm，再核对 x64 与 arm64 架构。使用图形软件安装器完成安装后，从桌面应用菜单启动，先确认界面、内核与配置目录可以正常使用。
桌面环境的系统代理设置与应用自身设置可能分开生效。浏览器可用而其他程序不通时，先查看程序是否读取桌面代理；需要 TUN 时再按文档核对权限与路由，避免同时运行多个接管工具。
下载中心集中列出安装格式与系统要求。选型不确定时，先阅读客户端对比，确认所需内核与平台，再回到对应入口。
查看全部客户端快速上手
导入、测试、验证
把配置拆成三个检查点。每完成一步再继续，出错时就能区分订阅请求、节点连接和应用代理三个环节，避免在多个设置之间来回试错。
-
建立订阅分组并更新
准备可用的订阅地址，确认复制内容从协议头开始且没有遗漏查询参数。进入订阅分组设置，填写便于识别的别名与可选地址 Url，保存后选择更新订阅。首次更新可先尝试不通过代理；如果当前网络无法访问订阅源，且已经有可用代理，再尝试通过代理更新。
更新完成后按订阅分组筛选服务器列表，确认新条目属于正确来源。列表为空时先检查启用状态、过滤(正则)和更新日志，不要急着修改协议字段。订阅地址可能包含访问凭据，公开截图时遮住完整地址，换设备时通过可信方式转移。
-
测试节点并设为活动服务器
选择少量候选条目执行真连接延迟测试，观察是否能完成实际请求。TCPing 成功而真连接延迟失败，说明还需要检查协议握手、证书、目标可达性等环节；不能据此直接断言节点可用。先保留测试条件一致，再比较候选条目，避免把不同测试方式的结果混在一起。
将能正常完成请求的条目设为活动服务器，打开日志检查内核状态。如果出现端口占用，先查找同时运行的代理程序；如果出现 TLS 或配置解析报错，按日志关键词核对对应设置。一次只调整一项，调整后重测，便于判断哪个改动产生了影响。
-
设置代理并核对实际出口
桌面端先选择自动配置系统代理，用遵循系统代理的浏览器发起请求。观察访问是否恢复，再通过可信的出口 IP 查询服务核对当前请求路径。启用分流时，直连站点与代理站点可能显示不同出口，应按目标命中的规则判断，而不是要求所有站点都走同一条路径。
如果浏览器仍使用原出口，检查浏览器自身的代理设置、扩展和已有连接，再核对系统代理地址与客户端监听端口。需要覆盖不读取系统代理的程序时，继续阅读 TUN 配置。结束测试后正常退出客户端，确认系统代理已恢复，避免留下指向已关闭端口的设置。
Project V · V2Fly · Xray
区分客户端与代理内核
理解各层职责，再判断更新或换客户端能否解决问题。图形界面、内核、订阅来源与远端服务器共同影响连接结果，任何单独一层都不能替代其他环节。
订阅地址图形客户端代理内核远端服务器
从 Project V 理解生态
Project V 是围绕网络代理工具形成的项目生态，V2Ray 是其中的重要实现。日常搜索里的“V2Ray 客户端”经常泛指一组图形工具，但客户端名称不等于内核名称。界面中的订阅分组、托盘菜单和服务器列表属于配置管理层；实际建立连接、处理传输与执行路由的是内核。
因此，下载客户端只是准备工作的开始。还需要合法取得可用配置，确认远端服务参数与本地内核匹配，并选择适合应用的流量接入方式。界面可以正常打开，并不代表远端服务器已经可达。
分别核对 V2Fly 与 Xray
V2Fly 延续 V2Ray 的社区维护，Xray 是从相关技术基础发展出的另一条内核分支。两者存在共同概念，但协议、传输和配置字段的演进并不完全一致。涉及 XTLS Vision 与 REALITY 等能力时，需要按 Xray 的实际实现核对配置，不能只看订阅里是否出现 VLESS 字样。
阅读教程时同时记下客户端、内核与传输方式。某个字段在一条分支中有效，不意味着换到另一条分支仍可原样运行。遇到未知字段或不支持的协议错误，优先核对支持范围，再考虑调整配置。
按使用场景选择图形客户端
v2rayN 是开源桌面图形客户端，提供订阅管理、节点测试与路由配置等操作入口；桌面平台优先从它开始。v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 同样面向 Android，采用 V2Fly 内核，可在配置确有需要时作为备选。三者名称接近，但并不是同一应用的界面主题。
客户端和内核各有项目许可，相关信息可在应用随附的许可与关于说明中查看。开源描述的是代码与许可方式，不代表订阅服务由客户端提供，也不能代替对订阅来源、服务器权限和网络环境的判断。
分开处理程序更新与订阅更新
更新订阅是在已有来源获取服务器配置；更新客户端则会改变界面、内核集成或配置处理方式。前者可能增加、替换或移除节点，后者可能带来字段支持变化。遇到故障时先确认是哪一层发生变化，不要把所有问题都归结为“需要重新安装”。
升级前保存订阅地址、自定义路由和必要设置，阅读应用更新说明。升级后先用熟悉的节点完成真连接延迟与实际访问测试，再恢复复杂规则。若出现兼容问题，记录日志中的具体错误，保留可复现条件，而不是同时重置全部设置。
配置与排错记录
近期教程文章
首次配置完成后，再按实际遇到的现象深入阅读。日志错误、主界面操作与证书参数分别处理，避免把不同层级的问题混成一次大范围重置。
V2Ray TLS 握手报错原因：系统时间不同步与 SNI 伪装域名填写错误
证书过期、x509 校验失败等报错多数来自本机时间偏差或 SNI 与证书域名不一致，本文按平台给出校时与参数核对步骤。
阅读排查步骤v2rayN 主界面功能详解：服务器列表、订阅分组、日志面板与参数设置
按区块拆解 v2rayN 主窗口：服务器列表的右键菜单、订阅分组的筛选与更新、底部日志和状态栏，以及参数设置中的常用选项。
查看界面说明v2rayN 内核启动失败排查：从日志面板定位 config.json 配置错误
读懂日志里的端口占用、JSON 解析失败和未知协议字段等报错，按报错关键词逐项修正配置，让内核重新启动。
检查启动日志