PLATFORM / 01
Windows
选择 v2rayN。桌面版采用跨平台界面，经典 WPF 版保留传统操作方式，可按使用习惯决定。
04 支持平台
03 图形客户端
CORE Xray · V2Fly
PROTO VMess · VLESS · Trojan
启用清单
V2Ray 客户端配置的四项关键检查
先确定客户端，再处理订阅、系统代理和连通状态。左侧选择检查项，右侧查看操作范围与判断标准。
检查 01
先按系统确定客户端，不混用安装说明
Windows、macOS 与 Linux 的桌面使用路径以 v2rayN 为主，Android 则先看 v2rayNG；需要 V2Fly 内核时，再把 v2flyNG 作为对应平台的备选。客户端界面、内核和安装包架构是三个不同问题，应按顺序判断。先选系统，再确认处理器架构，最后选择客户端，能避免把桌面操作步骤套到移动端，也能减少导入后找不到菜单的情况。
下载页把四个平台分开陈列，并标出桌面版、经典界面、arm64、通用包、deb 与 rpm 等差异。无需先理解全部协议，完成平台选择即可进入下一项。
platform=Windows → client=v2rayN
检查 02
导入订阅后，手动更新并确认节点列表
订阅链接不是普通网页地址，它需要从客户端的订阅管理入口添加。粘贴前先检查首尾是否完整，避免聊天工具换行或复制多余空格。保存之后执行一次手动更新，再观察客户端是否显示分组或节点。如果列表仍为空，应先查看更新提示，而不是反复切换系统代理；订阅尚未解析时，代理开关不会补齐节点数据。
二维码导入与剪贴板导入的结果应当一致。出现重复分组时，先整理旧订阅，再保留一个明确来源，后续更新和故障定位会更清楚。
subscription → save → update manually → select node
检查 03
区分系统代理、TUN 模式与路由规则
系统代理负责让遵循操作系统代理设置的应用进入客户端；TUN 模式处理范围更广，但通常需要额外权限。两者都不是节点协议本身，也不应在问题尚未定位时同时频繁切换。初次配置建议先使用系统代理，确认浏览器能够按预期工作，再根据应用是否读取系统代理决定是否评估 TUN 模式。
分流规则决定哪些请求直连、代理或拦截。先使用客户端提供的基础规则，再按域名、地址段和应用需求逐步增加规则。一次只改一组条件，修改后立即验证，避免多条规则互相覆盖。
mode=system-proxy · route=rule-based
检查 04
从进程、日志、代理状态三层确认连通
点击连接只代表客户端开始执行配置，不等于所有应用都已经使用代理。检查时先确认内核进程是否正常启动，再查看日志中是否存在端口占用、证书名称、DNS 解析或配置字段错误。随后核对系统代理是否开启，以及目标应用是否遵循该设置。按层排查能把“客户端未启动”和“应用未走代理”分成两类问题。
验证完成后记录当时使用的节点、模式和规则。后续出现变化时，只比较最近一次改动，不需要重装客户端或同时重置所有设置。
core running → log clean → proxy enabled → app test
平台入口
按系统选择 V2Ray 客户端
平台、处理器架构与安装包类型分别核对。首页只负责分流，具体文件入口统一放在下载页。
-
01
添加订阅并手动更新
在订阅管理中粘贴完整链接，保存后执行更新。看到分组与节点列表，才说明导入阶段结束。如果客户端提示格式错误，先重新复制原始链接，并检查是否带有空格或换行。
-
02
选择节点与代理方式
先选中一个节点，再启动内核。桌面端初次使用可从系统代理开始；Android 连接时按系统提示授予网络连接权限。暂时保持默认路由规则，减少额外变量。
-
03
查看日志并验证目标应用
确认客户端没有端口、DNS、证书名称或配置字段错误，再打开目标应用测试。若只有个别应用不生效，应检查该应用是否读取系统代理，而不是直接更换订阅。
内核与生态
Project V、V2Fly 与 Xray 的关系
客户端负责界面和系统集成，内核负责协议、传输、路由与连接处理。区分这两层，选型会更准确。
从 Project V 配置体系到两个常见内核家族
Project V 形成了以配置驱动代理连接的技术生态，常见概念包括入站、出站、路由、DNS、传输层与协议参数。V2Fly 延续 V2Ray 的社区化维护路线，保留大量既有配置习惯和协议组合；Xray 在同一技术脉络上扩展了部分协议与传输能力，并形成独立的更新节奏。两者存在共同来源，也有各自支持范围，不能只按名称判断优劣。
对普通客户端用户而言，首先需要确认订阅里的协议与客户端内核能否匹配。VMess、VLESS、Trojan、Shadowsocks 等类型在不同内核中可能具有不同参数要求；REALITY 等能力也依赖具体内核和客户端实现。订阅能够导入，只表示文本被识别，不代表每个字段都能被当前内核执行。出现连接失败时，应把“订阅格式兼容”和“协议能力兼容”分开检查。
客户端、内核与订阅是三层独立对象
v2rayN 是桌面图形客户端，负责订阅管理、系统代理、路由设置、日志查看和内核调用。v2rayNG 面向 Android，通常采用 Xray 内核路线，并通过系统网络接口建立连接。v2flyNG 同样面向 Android，但更适合需要 V2Fly 内核兼容性的配置。三款客户端都属于开放源代码软件，功能变化由各自维护周期、平台权限和底层内核共同决定。
订阅则是配置分发方式，不等同于客户端或内核。相同订阅在不同客户端中显示的字段可能略有差异，原因通常是界面命名、默认值和内核支持范围不同。排查时先记录客户端名称、内核类型、协议和代理模式，再讨论具体错误，信息会比一句“连接不了”更有用。
OPEN SOURCE
开放源代码便于理解实现边界
公开代码让协议处理、配置转换和平台集成具备可审阅基础。用户仍应根据自己的系统权限、配置来源和使用场景做选择，不把“开源”简单等同于所有配置天然正确。
UPDATE PATH
客户端与内核可能分别更新
图形界面更新不一定同步改变内核能力，内核更新也可能影响协议参数和默认行为。遇到升级后的差异时，先阅读客户端提示，再核对当前内核类型与配置字段。
DOCUMENTATION
按问题层级查阅文档
安装问题查平台说明，导入问题查订阅格式，连接问题查日志和内核，应用不生效再查系统代理与分流。按层阅读比反复重装更容易找到原因。
常见问题精选
配置前先确认的四个问题
这些问题通常出现在下载、导入和首次连接阶段。先看判断方法，再进入对应文档处理。
v2rayN 应该选择哪个桌面版本？
希望使用新一代跨平台界面时选择桌面版；习惯传统 Windows 操作方式时可查看经典 WPF 版。两者都应先核对系统架构和运行环境。
查看相关问答 →订阅导入后没有节点怎么办？
先确认链接完整并手动更新订阅，再查看客户端提示。没有生成节点列表之前，不需要切换系统代理或修改分流规则。
查看相关问答 →系统代理和 TUN 模式如何选择？
初次配置先用系统代理完成基础验证。只有目标应用不读取系统代理，且已确认节点与内核正常时，再评估 TUN 模式。
查看操作步骤 →连接后仍无法使用应先查哪里？
按内核进程、客户端日志、系统代理、目标应用四层检查。一次只改变一个条件，并保留最近一次能够工作的设置记录。
进入故障排查 →使用心得
近期 V2Ray 配置与排查文章
围绕证书错误、Android 后台连接与桌面客户端启动问题，给出可执行的检查顺序。