下载页分别列出 v2rayN 桌面版与经典 WPF 版。桌面版采用跨平台界面;已有操作习惯或正在对照旧版教程时,可优先查看经典 WPF 版的说明。两者界面位置可能不同,按功能名查找订阅分组、路由和系统代理,不必逐项对照截图。
下载前在「设置 → 系统 → 关于」核对系统类型。首次连接时,可先选择一个服务器,用读取系统代理的浏览器验证;需要覆盖其他应用时,再考虑 TUN。退出后若系统仍尝试连接本地代理,检查系统代理是否已恢复。
配置图层
订阅决定服务器列表从哪来,系统代理或 TUN 决定哪些流量进入客户端,路由再决定这些流量往哪走。遇到问题时,按这三层分别检查,比同时重设所有选项更容易定位。
订阅分组 → 订阅分组设置 → 添加
把不同来源的订阅分别保存,给每一组起便于识别的别名。更新前先选中目标组,再使用更新当前订阅的入口;需要统一刷新时才更新全部。与逐条粘贴服务器不同,订阅更新会重新读取来源返回的列表,手动修改的记录可能被覆盖。需要长期保留的手动配置应单独保存。更新失败时先看提示是下载出错还是内容无法解析,再决定是否调整配置。
查看订阅与服务器过滤说明"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
这段规则把匹配指定域名集合的请求交给名为 direct 的出站;要使用它,配置中必须定义对应出站并具备所需规则数据。路由不是系统代理开关:应用流量进入内核之后,才会按规则顺序匹配。把较具体的例外放在通用项之前,每次只改一处,再分别用应直连和应走代理的地址确认结果。遇到请求落入默认出站时,先核对收到的是域名还是地址。
"dns": {
"servers": ["https://1.1.1.1/dns-query"]
}
这段配置为内核指定一个 DNS over HTTPS 解析端点,不会自动改写所有应用的解析设置。浏览器启用安全 DNS 时,仍可能使用自己的解析器。排查域名访问异常,先确认应用是否把域名交给客户端,再检查内核能否访问解析端点,并记录受影响的域名。不要同时更换解析端点与路由策略,否则修复后也很难判断是哪项调整生效。
查看 DNS 配置章节开启 Tun · 清除系统代理
系统代理依赖应用主动读取代理设置,TUN 则通过虚拟网络接口接收由系统路由送入的流量。先确认当前平台支持该模式,并完成要求的系统授权;再在关闭其他接管工具的情况下启用 TUN,核对目标应用和局域网访问。若关闭 TUN 后故障就消失,先查虚拟接口、默认路由和局域网例外,不必直接重装客户端或更换订阅。
查看 TUN 设置与排查说明核心类型 · Xray / v2fly
导入服务器后,先核对协议、传输和安全机制,再判断当前内核能否处理这些字段。即使两个内核都识别某个协议,具体组合和配置字段也未必相同。切换前保留原来的选择和配置,只测试一个服务器,并查看启动日志是否有未识别字段。遇到启动错误时,先处理日志中的配置问题,不要把列表能显示记录当作配置已兼容。
对照 Xray 与 V2Fly 的差异平台与安装包
桌面端使用 v2rayN。安卓端在 v2rayNG 和 v2flyNG 之间按内核需求选择。下载前先查设备的处理器架构;同一个客户端名下的安装包,可能适用于不同芯片或安装工具。
下载页分别列出 v2rayN 桌面版与经典 WPF 版。桌面版采用跨平台界面;已有操作习惯或正在对照旧版教程时,可优先查看经典 WPF 版的说明。两者界面位置可能不同,按功能名查找订阅分组、路由和系统代理,不必逐项对照截图。
下载前在「设置 → 系统 → 关于」核对系统类型。首次连接时,可先选择一个服务器,用读取系统代理的浏览器验证;需要覆盖其他应用时,再考虑 TUN。退出后若系统仍尝试连接本地代理,检查系统代理是否已恢复。
在「关于本机」查看芯片或处理器。显示 Apple 芯片时选择 arm64,显示 Intel 处理器时选择 x64。两种安装包对应不同架构,不能仅凭系统名称选择。安装后先打开客户端,确认能够进入主界面,再导入订阅。
打不开应用与打开后无法设置代理,是两类问题。前者先看系统的应用打开提示,后者再查网络相关授权和代理设置。在受管理的设备上,系统可能限制这些设置;不要把管理策略误判为安装包选错。
需要 Xray 内核时选 v2rayNG;需要对照 V2Fly 配置时选 v2flyNG。确认系统支持 arm64 后再选相应安装包,不确定时查看通用版。安装包架构决定能否在设备上安装,内核选型决定能否处理订阅中的协议和传输字段。
如果系统提示安装冲突,先确认正在更新的是同一个应用,以及系统提示的具体原因。若考虑卸载重装,先确认能否恢复订阅和本地设置。首次申请 VPN 权限时,也要检查设备是否已有另一个应用占用该连接。
按发行版选包格式:Debian、Ubuntu 通常使用 deb,Fedora、openSUSE 通常使用 rpm;再按系统架构区分 x64 与 arm64。格式匹配并不等于依赖一定齐全,安装器若提示缺少组件,应先解决依赖,再检查桌面菜单入口。
教程以图形桌面会话为前提。能打开窗口但应用不走代理时,先确认当前桌面环境是否应用了系统代理设置,再看目标应用是否读取它。浏览器测试成功,也不能直接证明另一个应用会沿用同一套设置。
迁移前先分清订阅地址、手动添加的服务器和本机设置。订阅地址可在新设备上重新添加;独立于订阅的手动记录要另行保存;系统代理、虚拟网卡和应用分流通常与原设备有关,需要在新设备上重新确认。备份中若包含订阅链接或连接信息,应与公开的排障截图分开存放。
先在新设备上完成最小配置:导入一个来源、选择一个已知可用的服务器,再用一种接入模式测试。确认基础连接成功后再恢复自定义 DNS 和路由规则。新设备如果连基础配置都过不了,应先核对架构、内核和权限,不要依赖整套旧配置来碰运气。
生态与维护
客户端负责呈现设置与管理配置,内核负责建立连接和运行路由规则。两层的项目可以独立发布,因此遇到连线问题时,既要会找界面上的设置,也要知道实际由哪个内核处理。
Project V 是早期项目生态的名称,V2Ray 是其中的核心代理程序。原有项目逐步由社区接续之后,V2Fly 延续了 V2Ray 的维护与发布;Xray 则从相关代码基础分出,独立演进。今天在客户端里看到的名称,可能指整个生态,也可能指某一个正在运行的内核,阅读教程时要结合上下文区分。
图形客户端将订阅条目整理为可选的服务器配置,并把路由和网络模式转换成内核能使用的设置。看不见服务器列表,往往先查导入或更新;列表能选、内核却起不来,则更值得先查日志,而不是再把同一个地址导入一遍。
判断 V2Fly 和 Xray 是否适合一份配置,要同时看协议、传输和连接安全机制。VMess、VLESS 或 Trojan 是协议名称,WebSocket 是传输方式,REALITY 是连接安全机制。只看到列表里的协议缩写,无法判定其余字段是否也受支持。
例如,服务端要求 VLESS 与 REALITY 及特定流控组合时,应使用支持整套组合的内核,并按服务端参数配置,而不是只把协议菜单改成 VLESS。迁移完整配置时还要核对 DNS 和出站字段,因为连接参数兼容,不代表同一份自定义路由也能原样使用。
v2rayN 是以 GPL-3.0 发布的桌面图形客户端,提供订阅、内核选择、路由和网络模式设置。v2rayNG 与 v2flyNG 是开源安卓客户端,分别面向 Xray 和 V2Fly。它们处理的是本机连接配置,不替用户提供订阅或远端服务器。
阅读许可证时,应区分客户端与随客户端使用的内核、组件。客户端的开源许可证说明适用于其代码的条款;内核与其他组件仍应分别查看其许可。免费获取客户端也不等于拥有某项远端服务,后者由实际服务提供方决定。
客户端发布可能调整界面与平台适配,内核发布可能改变配置字段与协议支持,订阅刷新则重新读取服务端提供的服务器列表。这三种更新彼此独立:订阅成功并不表示程序已经升级,同一个软件下载包也不能保证不同来源的订阅表现一致。
更新前记录当前所用内核、路由方案和接入模式。更新后先重测一项原本正常的操作,再启用自定义设置。若异常始于一次订阅刷新,优先比对该组的配置变化;若异常始于程序升级,则先查设置迁移或内核启动提示。
使用心得
正在选安卓客户端,先看 Xray 与 V2Fly 的差异;想弄清一个名称指图形客户端还是内核,先看生态关系。已拿到 REALITY 配置时,再对照安全机制和流控字段,避免把两处选项当成同一件事。
用握手流程图解 REALITY 如何借用目标站点的 TLS 特征,讲解 XTLS Vision 减少重复加密的思路,以及在客户端里填写 flow 与公钥参数的要点。
从 Project V 的起源讲到 V2Fly 社区接手与 Xray 分支,再说明 v2rayN、v2rayNG、v2flyNG 如何调用内核,以及各自采用的开源协议。
梳理 Xray 与 V2Fly 的分叉缘由、协议支持差异和配置兼容性,结合订阅协议类型,给出安卓端选 v2rayNG 还是 v2flyNG 的判断依据。
更新成功只表示客户端拿到了服务器列表;选中一条记录后,检查内核是否启动、应用是否把流量交给客户端,再按故障排查说明区分连接失败与域名解析失败。
先确认该应用是否读取系统代理、是否配置了自己的代理,或在 VPN 模式下是否被排除;只有确认流量已经进入客户端后,才需要检查路由规则与出站标签。
恢复到最近一次可用的模式,保持服务器不变,先检查常用应用和局域网访问,再逐项恢复 DNS 或 TUN 设置;若某一步复现异常,就按常见问题继续查该层设置。
能否读取订阅取决于返回的格式,导入后能否连接还取决于实际内核和配置字段;两台设备能否同时使用,则要另外看服务提供方的规则,可先参照订阅与节点相关术语区分这三件事。