v2rayN 桌面版与经典 WPF 版
桌面版采用新一代跨平台界面，经典 WPF 版保留熟悉的操作布局。初次使用可先看桌面版说明；已有稳定使用习惯时，再根据需求决定是否切换。两种界面都需要正确的节点资料，并不是安装完成就自动具备连接资源。
安装前到“设置 → 系统 → 系统信息”查看系统类型，确认设备架构。迁移时先保留订阅地址、路由设置和必要的自定义配置，别直接用旧目录覆盖新目录。首次启动先测试一个节点，再设置系统代理；浏览器可用之后，再考虑是否需要 TUN 模式接管其他程序。
订阅地址与节点链接分开导入
订阅地址是一组节点的更新入口，单个节点链接则只描述一条连接配置。在 v2rayN 中先打开“订阅分组设置”，添加地址并保存，再执行更新订阅；在 v2rayNG 中可从侧栏进入订阅分组设置。分组名称最好写清来源，方便以后只更新需要的那一组。导入后先确认列表出现节点，再选中一个进行连接测试。与手动逐条填写相比，订阅更适合集中维护，但更新是否成功仍要看日志，不能只看列表是否保留了旧节点。
阅读订阅导入步骤 →操作顺序
- 订阅分组设置 → 添加分组
- 填写名称与订阅地址 → 保存
- 更新订阅 → 查看更新结果
- 选中节点 → 启动连接
订阅地址通常包含访问凭据，分享截图时应遮住完整地址。
规则从上到下，先匹配先处理
路由决定已经进入内核的流量走哪个出站，不负责让所有应用自动使用代理。先在客户端选择合适的路由模式，再逐条添加特殊规则。域名条件和 IP 条件建议分开写，规则中的出站标签必须与出站配置一致。下面的片段只演示把私有地址交给直连出站，不是完整配置。相比一律走同一出口，按目标分流更便于保留局域网访问；如果规则没有命中，还需要检查 DNS 解析方式、规则数据库和规则位置，而不是反复更换节点。
查看 routing 字段说明 →{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}先验证系统代理，再考虑 TUN
v2rayN 的系统代理会修改系统代理设置，但有些程序并不读取这些设置。TUN 模式通过虚拟网卡接管更多 IP 流量，适合处理这类场景。启用前先让普通连接正常工作，再检查权限、路由和 DNS 设置，避免同时改动多项后失去排查线索。与系统代理相比，TUN 的影响范围更广，也更需要留意局域网、其他虚拟网卡和网络工具之间的冲突。安卓端 v2rayNG 使用系统 VPN 服务接管流量，不应照搬桌面端的菜单路径。
查看连接模式与验证方法 →启用前核对
- 节点在普通连接方式下可以使用
- 客户端获得所需权限
- 确认 DNS 与路由设置
- 暂时退出其他流量接管工具
- 测试浏览器和目标应用，而不只看开关状态
图形界面与内核是两个层次
客户端负责订阅管理、选项展示和启动控制，内核负责协议处理、路由与连接。v2rayNG 使用 Xray，v2flyNG 是采用 V2Fly 内核的安卓备选；v2rayN 的实际能力则要结合当前使用的内核判断。看到陌生字段时，先确认它属于哪一种内核及其配置格式，再查对应文档。与直接复制整段配置相比，从日志和已有字段逐步核对更容易找到问题。下面展示的是常见结构名称，不能作为可连接的完整文件，也不包含服务端参数。
打开 JSON 配置手册 →{
"log": {
"loglevel": "warning"
},
"inbounds": [],
"outbounds": [],
"routing": {
"rules": []
}
}设置名称可能随客户端界面调整。找不到同名选项时，先确认使用的是桌面端 v2rayN，还是安卓端 v2rayNG；两者可以使用相近的节点资料，但菜单、权限和流量接管方式并不相同。涉及服务端的传输参数，应以服务提供方给出的说明为准。
按设备选择
V2Ray 客户端下载入口
桌面端先看 v2rayN，安卓端先看 v2rayNG。平台相同还要核对处理器架构；文件格式决定安装方式，节点协议是否可用则取决于内核与配置，不能只靠安装包名称判断。
v2rayN 按芯片选择安装包
打开系统菜单中的“关于本机”，看到 Apple 芯片时选择 Apple Silicon 对应的 arm64 安装包；显示 Intel 处理器时选择 x64 安装包。先确认芯片，再看系统要求，能减少下载后才发现架构不合适的情况。
完成安装后，按系统提示处理应用启动权限，再导入订阅。系统代理、浏览器扩展代理和终端代理是不同层次的设置：浏览器能访问，并不意味着终端程序也会使用同一出口。遇到应用之间表现不一致时，先核对各自的代理来源，而不是立即重装客户端。已有其他网络工具时，也应避免同时修改系统代理。
v2rayNG 为主，v2flyNG 为备选
主流较新的安卓手机通常优先查看 arm64 安装包；不清楚设备架构时，再阅读通用版说明。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。选择备选客户端的依据是配置兼容需求，不是把两个客户端同时开启。
首次连接需要确认系统 VPN 授权，之后还要留意分应用代理是否排除了目标应用。若锁屏一段时间后连接中断，可检查系统的电池优化和后台运行限制。先用默认接管范围完成测试，再按需要缩小到指定应用；这样更容易区分节点问题和应用设置问题。更新前也应保留订阅及自定义规则，避免把重新安装当成常规排查步骤。
v2rayN 的 deb 与 rpm 安装方式
先看发行版采用哪种软件包格式，再看处理器架构。Debian、Ubuntu 系通常查看 deb，Fedora 等发行版通常查看 rpm；常见桌面电脑多为 x64，使用 ARM 设备时应选择对应的 arm64 文件，不能仅按发行版名称判断。
安装完成后先在图形界面导入订阅，确认内核能够启动。桌面环境的代理设置和终端环境变量并不一定同步，某个程序没有走代理时，应单独核对它读取的设置。若启用 TUN 后影响局域网或容器网络，先停用 TUN 恢复原网络，再检查路由与权限。下载页会将格式和架构分开列出，便于按自己的系统选择。
快速上手预览
订阅导入、连接与验证
先完成最短的连接路径，再调整高级选项。下面三步适合建立排查基线：每次只改一项，记录改动前后的结果，通常比同时切换内核、DNS 和路由更容易找到原因。
-
导入节点资料，确认来源与类型
准备可用的订阅地址或单个节点链接。订阅地址放到订阅分组设置中；单个链接则使用从剪贴板导入等节点导入入口。不要把网页地址、订阅地址和节点链接当成同一种内容粘贴。导入后核对节点是否出现、名称是否合理，再查看更新日志中有没有错误提示。
v2rayN 与 v2rayNG 都是客户端工具，不会因为安装完成就自动提供服务端。订阅更新失败时，应先检查地址是否完整、是否过期，以及当前网络能否访问更新入口。旧节点仍然显示在列表中，只能说明本地数据还在，不能证明本次更新成功。截图求助时，记得遮住地址中的凭据和节点认证信息。
-
选中节点，再确认流量接管方式
先选中一个节点作为当前连接，不要一次性修改多组配置。桌面端 v2rayN 可以先使用系统代理配合适当的路由模式；安卓端 v2rayNG 启动时，需要接受系统 VPN 连接请求。授权提示来自系统，确认后还要检查客户端是否正常启动，以及目标应用是否在接管范围内。
路由模式决定进入内核的流量怎样分配，系统代理或 VPN 服务则决定流量是否进入客户端。两者解决的是不同问题。若浏览器扩展单独指定了代理，或安卓端开启了分应用排除，目标程序可能绕开当前连接。先恢复容易理解的基础设置，验证成功后再逐步增加特殊规则。
-
验证目标应用，保留有效配置
打开实际需要使用的网页或应用，检查是否能够正常加载，再观察客户端日志。连接开关打开、节点测试有结果，都不能代替真实访问验证。若网页打不开，先确认系统时间，然后检查 DNS、节点参数和路由；若只有某个应用异常，再看这个应用是否使用了独立代理或被分应用规则排除。
测试通过后记录当前节点、路由模式和 DNS 设置，作为下一次调整的参照。后续启用 TUN 或添加自定义规则时，每做一项就重新测试。出现问题可以退回上一个有效状态，而不是把全部选项重置。需要逐屏操作说明时，可继续阅读教程；需要理解字段之间的关系时，再转到 JSON 手册。
客户端与内核的关系
Project V、V2Fly 与 Xray
理解生态关系，主要是为了看懂配置适用范围。产品名称相近，不代表所有选项都能互换；先分清图形客户端、运行内核和协议，阅读教程时就不容易把不同层次的操作混在一起。
生态历史：名称相近，职责不同
Project V 是理解 V2Ray 生态的起点，V2Ray 将入站、出站、路由等能力组织为可配置的网络工具。V2Fly 延续了 V2Ray 的社区开发，Xray 则由 V2Ray 相关代码发展而来，逐步形成自己的功能和配置演进方向。它们不是同一个产品的不同皮肤，也不应仅凭名称判断某项新协议或新字段是否受支持。
对普通使用者来说，最常接触的是图形客户端。客户端把订阅、节点列表、系统代理和日志入口组织成可操作的界面，内核在其后完成实际的数据处理。因此，界面上能看到一个选项，不一定意味着任意内核都接受同样的参数；复制教程前，先确认教程针对的是哪一类组合。
内核家族：按配置需求选择
v2rayNG 是使用 Xray 内核的安卓开源客户端，v2flyNG 则是使用 V2Fly 内核的安卓备选。v2rayN 面向桌面系统，实际协议能力还要结合所使用的内核及其支持情况判断。节点链接中的协议名称，只是配置的一部分；传输方式、TLS、服务器名称及其他参数同样会影响能否连接。
VMess、VLESS 和 Trojan 描述的不是图形界面的风格，也不能简单排成速度名次。实际表现受服务端实现、网络线路、传输配置和本地环境共同影响。已有能正常使用的配置时，不必为了名称更新而迁移；确实需要某项能力时，再核对客户端、内核和服务端是否同时支持。
开源协议：分层理解项目许可
v2rayN、v2rayNG 和 v2flyNG 都有公开源代码与社区维护背景，客户端可免费使用。内核层面，V2Fly 的 V2Ray core 与 Xray core 采用 MPL 2.0 许可；图形客户端则有各自的许可条款。客户端与所调用内核属于不同项目，不能拿一个项目的许可说明替代整套软件的所有条款。
日常安装使用与修改代码后再分发，是两种不同的场景。若涉及二次开发或重新打包，应分别阅读相关项目的许可文件，确认源代码、声明和分发方面的义务。本站侧重操作与配置说明，开源背景用于解释项目关系，不代替具体软件的许可文本，也不代表本站参与了这些项目的开发。
更新机制：界面、内核与规则分别看
一次客户端更新可能涉及界面和依赖，内核更新可能改变协议行为或字段支持，GeoIP、GeoSite 数据更新则会影响部分路由集合的匹配内容。这三类变化应分开理解。遇到升级后表现不同，先看变更说明和日志，再确认是否仍在使用原来的路由与 DNS 设置，不要直接把全部变化归因于节点。
更新前保留可恢复的配置，更新后先验证基础连接，再测试自定义规则。旧教程中的菜单名称可能变化，配置片段也可能只适用于特定内核。本站将轻量操作放在教程页，将结构与字段说明放在 JSON 手册，排查记录则按具体问题整理在使用心得中，便于从当前遇到的现象继续查找。
使用心得
连接异常与网速排查
同样是“不能用”，断点可能在应用、系统代理、DNS、路由或服务端。下面的文章按现象拆开检查路径，先找到受影响的范围，再决定改哪一项，避免用重复安装掩盖真正的问题。
V2Ray 网速慢分层排查：节点、线路与本地设置
把慢速问题拆成节点负载、线路质量、传输协议和本地设置四层，逐层对照测试，判断瓶颈在哪一层、该调整哪一项。
网页响应慢和大文件下载慢不一定出自同一原因。先固定应用与测试条件，再比较节点和网络环境，能减少偶然波动带来的误判；不要只凭一次连接测试就断定线路质量。
阅读分层排查方法 →节点已连接却打不开网页：逐项检查清单
从时间同步、DNS 设置、路由规则、分应用代理到节点本身，按顺序逐项核对，定位“显示已连接但无法上网”的断点。
先区分所有应用都异常，还是只有一个应用打不开。再结合日志判断请求是否进入内核，避免在尚未接管流量时反复更换节点；已经接管却解析失败，则沿 DNS 路径继续检查。
阅读连接检查清单 →v2rayN 系统代理不生效：浏览器与终端分开排查
浏览器不走代理多半与扩展或 PAC 设置有关，终端不走代理则要看环境变量。文章分两条线核对设置，并给出验证命令。
系统代理不是所有程序共同遵守的开关。排查时先确认应用读取哪一层设置，再检查本地监听地址与端口；浏览器扩展、终端环境和客户端中的路由规则，应分别验证。
阅读系统代理排查记录 →