先选操作系统，再核对处理器架构与安装形式。桌面版和安卓客户端的设置入口不同，订阅地址通常可以复用，应用权限和代理接管方式则需要分别配置。
v2rayN 提供 Desktop 与经典 WPF 两类界面。首次安装先核对系统与运行环境要求；已有配置先备份，再决定是否切换界面，不必同时运行两套客户端。
前往下载 →v2rayN 按 Apple Silicon 与 Intel 芯片提供入口。在“关于本机”查看芯片或处理器名称，选择对应安装包；首次运行时按系统提示处理应用权限。
前往下载 →优先查看采用 Xray 内核的 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。根据设备架构选择 arm64 或通用包，并在连接时确认系统的 VPN 授权提示。
前往下载 →v2rayN 提供 deb 与 rpm 安装形式，并区分 x64 与 arm64 架构。先按发行版选择软件包，再检查桌面环境的系统代理是否已指向客户端监听地址。
前往下载 →安装包只决定客户端能否运行，不包含可直接使用的远程连接配置。请准备有权使用的订阅地址或分享链接；导入后还需选择活动服务器，并验证应用是否使用了本地代理。
查看全部客户端 →把客户端看作三层：订阅提供连接参数，内核负责连接与分流，代理模式决定应用流量如何进入内核。先定位所在层，再调整对应设置。
系统代理模式把本机代理地址写入操作系统设置，适合浏览器等遵循系统代理的应用。选择活动服务器后，在底部系统代理菜单选择“自动配置系统代理”，再用浏览器验证。它与路由模式分工不同：前者决定流量是否进入客户端，后者决定进入后的出站路径。部分程序使用自己的代理设置，需要单独指定监听地址；退出客户端前可清除系统代理，避免应用继续访问已经停止的本地端口。
系统代理：自动配置系统代理
应用代理地址：127.0.0.1
应用代理端口：以当前本地监听设置为准
路由：绕过局域网Tun 模式通过虚拟网卡接收流量，适合无法单独指定代理的应用。先在普通系统代理下验证节点可用，再按当前平台要求授予权限并开启 Tun。开启后应同时检查路由、DNS 与现有虚拟网卡，避免和其他网络接管工具冲突。Tun 不是提高节点带宽的开关，也不会修复错误的服务器参数。若启用后局域网访问异常，先关闭 Tun 对照测试，再逐项检查绕过规则与名称解析设置。
启用前：确认普通代理连接可用
权限：按操作系统提示授权
检查项：虚拟网卡 / 路由 / DNS
验证：目标应用与局域网分别测试订阅分组用于保存订阅地址，并集中更新该来源的服务器配置。先打开订阅分组设置，填写容易辨认的分组名称与完整地址，保存后更新对应分组。分享链接则包含单个连接的参数，不应当作订阅地址反复更新。更新后列表为空时，先看请求是否成功，再检查返回格式；请求失败与内容无法解析是两类问题。订阅地址可能包含访问凭据，排查时应遮盖完整地址，不要将其放入公开截图。
订阅分组
名称：按配置来源命名
地址：粘贴完整订阅地址
保存后：更新当前订阅分组
分享链接：使用剪贴板导入入口路由规则决定进入内核的连接走直连、代理还是阻断。匹配条件可以使用域名、目标 IP 和端口，通常按规则顺序查找，具体行为以所选内核为准。下方是 Xray 的局域网地址直连规则片段，不是完整配置；使用前必须确认当前配置存在名为 direct 的出站。首次配置建议从内置路由开始，只增加确有需要的例外。规则过宽或顺序不当会遮住后续规则，修改后应分别验证目标站点和局域网设备。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}真连接测速通过代理发起实际请求，比单纯检查端口更接近日常使用，但结果也受测试地址和当时线路影响。先选中服务器，再从右键菜单执行测试；批量比较时应保持测试地址一致。TCPing 主要反映目标端口建立连接的情况，不能证明协议认证和代理请求均已成功。测试通过后仍需设置活动服务器，并在目标应用中验证。若只有某个测试地址失败，可换用可信的测试目标对照，避免把单站问题误判为节点失效。
TCPing：检查 TCP 端口连通性
真连接测试：通过代理请求测试地址
应用验证：确认系统代理与实际访问
速度比较：保持同一下载目标与测试时段客户端界面负责编辑配置，内核负责协议处理、连接建立与路由执行。v2rayN 可按支持情况配置不同内核，但相同协议名称不代表所有扩展参数都能互换。切换前先确认协议、传输方式和安全参数是否受支持，并保留原配置作为对照。不要为了排查一个超时同时更换内核、DNS 和路由；先只改一个变量，再查看日志中的具体错误。安卓端的 v2rayNG 与 v2flyNG 则分别对应不同的内核选择。
客户端：配置管理与界面操作
内核：协议处理与流量转发
切换依据：协议 / 传输 / 安全参数
排查原则：一次只改一个变量菜单文字可能随桌面界面调整。遇到名称差异时，先按“系统代理、路由、订阅、内核”识别功能归属，再查对应入口；不要直接用其他客户端的配置片段覆盖当前设置。按症状查阅排查手册 →
先跑通最短路径，再增加分流与网络接管设置。安装完成、列表出现服务器、浏览器能够访问，分别是三个不同的检查点。
v2rayN 在“订阅分组”中添加订阅地址，保存后更新该分组；若拿到的是单个分享链接，则复制完整内容，使用服务器菜单中的剪贴板导入功能。v2rayNG 在订阅设置中添加地址，再返回主界面更新订阅。两类入口不要混用，二维码内容也应先分清是订阅还是单个连接。
导入后检查协议类型、服务器地址与端口是否齐全。手动补参数时，传输路径、服务名、服务器名称等字段必须与提供的配置一致，不能凭名称猜测。列表为空先看更新提示；已有列表但连接失败，则进入下一步测试，不必反复删除订阅。
从服务器列表选一条配置，执行真连接测试，再将其设为活动服务器。测试过程中暂时保留默认路由和 DNS，避免多个改动互相影响。若端口测试正常而真连接失败，应检查认证、传输和安全参数；若所有配置都失败，先确认本地网络与客户端内核是否正常启动。
桌面端先用“自动配置系统代理”验证浏览器访问，再考虑 Tun。安卓端点击连接后接受系统 VPN 授权，并留意是否有其他应用正在占用 VPN 连接。分应用代理先保持简单，确认基础连接正常后，再决定哪些应用需要加入或排除。
打开目标应用发起一次请求，同时查看客户端日志。浏览器正常而另一款应用失败，优先检查该应用是否读取系统代理；所有应用都失败，再回到内核启动、监听端口和活动服务器。日志中的地址、订阅内容和认证信息应先脱敏，再用于交流排查。
最后做一次可恢复的对照：记录原设置，临时关闭代理接管，比较相同目标的访问结果，再恢复设置。不要只凭界面开关或一次测速判断全部应用已生效。完成验证后再逐项开启自定义路由、Tun 或分应用代理，每次调整都保留明确的回退路径。
需要处理首次启动提示、本地端口冲突或后台断连时，沿教程中的检查点继续，不必从头重装。保留原配置与错误提示，通常比同时更改多项设置更容易找到原因。
查看完整教程 →区分项目、内核、客户端和订阅来源，才能判断一次更新究竟改变了什么。客户端名称相近，不代表设置文件和全部功能可以直接互换。
Project V
模块化代理工具生态
V2Fly / V2Ray
持续演进的内核实现
Xray
从 V2Ray 发展而来的内核分支
图形客户端在内核之上提供配置入口；连接参数由订阅或分享链接提供。
Project V 是围绕网络代理工具形成的项目生态，V2Ray 是其中的重要实现。它把入站、出站、路由和传输等能力拆成可配置模块，因此同一个图形界面可以呈现不同协议，也可以根据规则为不同目标选择出站路径。这里的“协议”描述连接双方如何交流，“传输”描述数据如何承载，两者不应混为一项设置。
日常使用通常不需要从头编写完整配置。图形客户端会依据订阅参数生成内核所需的配置，但这不意味着客户端能自动补全缺失信息。服务器地址、认证参数、传输选项和安全设置仍需相互匹配。理解这层关系，可以避免把订阅内容问题误当成安装问题，也能解释为什么重新安装客户端并不一定改变连接结果。
V2Fly 社区继续维护 V2Ray 相关实现；Xray 则从 V2Ray 发展而来，并形成自己的功能与发布节奏。两者有共同的技术背景，但各自支持的协议扩展、传输细节和配置字段可能存在差异。阅读教程时，应同时确认客户端名称与实际运行的内核，不要只看到“V2Ray 配置”就认为片段适用于所有实现。
遇到不支持的字段或无法识别的传输选项，先看内核启动日志，再对照连接配置要求。切换内核是一项兼容性选择，不是通用修复按钮。某个节点能否使用，取决于客户端能否表达其参数、内核能否处理这些参数，以及服务器端是否提供对应能力；其中任一环节不匹配，都可能导致连接失败。
v2rayN 是桌面图形客户端，提供服务器管理、订阅分组、代理模式与路由设置等入口。v2rayNG 面向安卓，采用 Xray 内核；v2flyNG 同样面向安卓，采用 V2Fly 内核。这三款客户端均以开源方式发布。选择时先看设备系统，再看配置要求，不需要为了同一份订阅把所有客户端都安装一遍。
桌面上的系统代理与安卓的 VpnService 接管方式不同，因此“已经连接”的界面提示也需要结合平台理解。安卓应用通过系统 VPN 服务接收流量，不代表远端配置必须是传统 VPN 协议；桌面应用遵循系统代理，则不代表每个后台进程都会自动使用它。平台权限决定接管范围，内核与节点参数决定后续连接过程。
开源意味着源代码按相应许可证提供，使用、修改与再分发仍应遵循各项目的许可条款。客户端、内核和附带组件可能采用不同许可；部署或二次分发时应分别阅读说明，而不是把一个项目的条款直接套到全部组件。普通使用者则应重点了解应用申请了哪些权限、配置文件保存在何处，以及日志中可能包含哪些连接信息。
客户端用于管理和执行配置，订阅来源负责提供远程服务器参数，两者是不同角色。开源属性不能替代对订阅来源的判断，也不能代表远程服务的可用性。保存配置、分享截图或提交问题时，尽量只保留复现所需的信息；订阅地址、用户标识和认证内容应妥善处理，避免在公开记录中暴露访问凭据。
客户端更新、内核更新和订阅更新分别影响界面能力、协议实现和服务器参数。更新订阅不会自动完成客户端升级；升级客户端也不代表订阅中的远端配置随之改变。准备更新前，先备份订阅分组、自定义路由和关键设置，记录当前使用的内核类型，并在更新后用原来的目标重复验证，避免只凭界面变化判断结果。
若更新后出现异常，先检查发行说明中的兼容性变化，再查看日志是否指向内核启动、配置解析或网络请求。保留一个已验证的简单配置作为基线，逐项恢复自定义设置，更容易找出差异。速度慢则应分开比较节点负载、线路质量和本地设置；一次更改多项参数，往往会让偶然改善被误认为长期有效的解决办法。
不确定“订阅”“节点”“路由”“DNS”的区别时，先查术语表；已经出现明确报错时，直接进入排查手册。前者用于理解设置，后者用于按现象收敛问题，两种阅读路径不必混在一起。
围绕实际操作展开：订阅怎样导入、首次运行先检查什么、安卓连接为什么会在后台中断。每篇只处理一组关联问题，便于对照当前界面逐项验证。
分别演示 v2rayN 订阅分组和 v2rayNG 订阅设置的导入入口，说明 Base64 订阅与分享链接的格式差异，以及更新订阅后节点为空的排查方向。
阅读订阅导入说明 →梳理 v2rayN 在 Windows 与 macOS 上首次运行的准备工作，包括运行环境、内核文件、本地端口和系统代理模式，并列出启动失败与权限提示的处理办法。
阅读初始设置说明 →针对安卓系统讲 v2rayNG 的三个关键设置：VPN 连接请求授权、各品牌系统的后台省电白名单，以及按应用选择是否走代理的配置思路。
阅读安卓设置说明 →