v2rayN 有跨平台界面的桌面版,也有经典 WPF 版。初次使用可先看桌面版;若手头的操作说明以经典界面为例,选 WPF 版更容易对照。先到系统的「关于」查看「系统类型」,确认设备适用下载页列出的架构。
应用若在窗口出现前就退出,先查发行说明列出的桌面运行环境。此时尚未进入订阅或连接阶段,修改节点参数不能解决启动失败。
前往下载先找出故障发生在哪一步:更新订阅只负责取得配置,启用系统代理才会改变部分应用的连接入口,路由规则则决定接入客户端的流量怎么走。这三步互不替代。排查时只改一项,用同一个应用重试,才容易判断是哪项设置生效。
路由规则片段:目标命中私有地址集合时,从标记为 direct 的出站发送。这个标记需与现有出站的名称一致。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
订阅分组适合维护一批会变动的连接配置,单条链接则适合一次只导入一条。桌面 v2rayN 可先在「订阅分组」保存地址,再更新当前分组;安卓 v2rayNG 则从侧边菜单进入订阅分组设置,保存后回到主列表执行更新。确认新条目出现在正确的分组后,手动选定一条连接配置。若刷新后自定义条目被覆盖,应改在独立分组保存本地条目,而不是在订阅分组里反复编辑。
路由分流处理的是已经进入内核的请求。它依据域名或目标地址决定直连还是交给代理出站,与是否启用系统代理是两回事。先用现有预设测试一条需要直连的请求,再在「路由设置」查找对应规则。规则一般按顺序匹配,覆盖范围小的例外应排在宽泛规则之前。若域名规则没有生效,先确认客户端拿到的是域名还是地址,再决定检查解析行为还是调整匹配条件。
v2rayN 中的「自动配置系统代理」会设置操作系统的代理入口,适用于遵循该设置的桌面应用。它与安卓通过系统 VPN 服务接入应用流量的方式不同,也不保证所有桌面进程都走同一入口。需要验证时,用浏览器发起新请求,再看客户端是否记录这次连接;应用如果有独立的网络选项,要在那里确认代理来源。结束临时测试后,可用「清除系统代理」撤销客户端设置的代理入口。
在 v2rayNG 的 VPN 模式中,「分应用代理」可按应用限定接入范围。启用后,先确认勾选列表代表纳入还是排除:打开「绕过模式」时,勾选的应用将不经过这个 VPN。保存后断开并重新连接,再分别用已选和未选的应用发起新请求。应用名单只决定谁进入 VPN,进入之后去往哪个出站仍由路由规则判断;同一应用内不同域名的请求可能走不同出站。
内核解释连接配置并建立会话,客户端负责界面与系统接入。桌面 v2rayN 可在支持的配置中选用相应内核;安卓端若要从 Xray 系方案改用 V2Fly 系方案,通常应重新选择对应客户端。导入前先确认服务端使用的协议、传输与安全选项,而不只看链接能否识别。采用 REALITY 的配置应选择支持该功能的内核;切换后若有字段报错,先比对原配置,不要用逐项删除字段的办法强行启动。
界面示意把分散设置放在一起,便于对照,不代表实际菜单顺序。若当前客户端的用词不同,可先查概念速查:确认要调整的是流量入口、目标匹配,还是连接配置本身,再回到对应菜单。
先确定安装在哪台设备上,再对照系统类型和处理器架构。同一架构的安装包也不能跨系统使用;已经安装的设备,更新前还要确认当前使用的是哪个客户端和发行形式。
v2rayN 有跨平台界面的桌面版,也有经典 WPF 版。初次使用可先看桌面版;若手头的操作说明以经典界面为例,选 WPF 版更容易对照。先到系统的「关于」查看「系统类型」,确认设备适用下载页列出的架构。
应用若在窗口出现前就退出,先查发行说明列出的桌面运行环境。此时尚未进入订阅或连接阶段,修改节点参数不能解决启动失败。
前往下载在「关于本机」查看「芯片」或「处理器」。显示 Apple 芯片的机型选 Apple Silicon 包,显示 Intel 处理器的机型选 Intel 包。不要按电脑的购买年份猜测,同一时期可能有两种架构的机型。
打开磁盘映像后,按其中的安装说明将应用放到「应用程序」。若从映像窗口直接试用了客户端,先退出,再从实际安装位置启动,避免安装和测试时打开不同副本。
前往下载优先看基于 Xray 的 v2rayNG;已有明确的 V2Fly 配置要求时,再比较 v2flyNG。多数近年的设备可选 arm64 包,拿不准系统支持哪种架构时可先看通用包,并核对最低系统要求。
若系统提示与已安装应用冲突,先区分是不是覆盖安装失败。卸载可能清除本地配置,排查前应备份订阅分组和手动建立的条目,不要将卸载作为第一步。
前往下载安装桌面版 v2rayN 时,先按发行版的包管理体系选 deb 或 rpm,再核对架构。Debian、Ubuntu 一般使用 deb,Fedora 一般使用 rpm;使用 ARM 设备时,也要选对应架构的包。
能启动客户端不等于桌面应用会采用系统代理。安装后先查当前桌面环境的网络代理设置,再用一个会读取该设置的应用做验证;个别应用仍需要在自身设置中指定连接方式。
前往下载第一次连接,先保留默认设置,用一条已知可用的配置建立基线。确认能用之后,再调整分流、分应用名单或后台设置;这样即使后续出现问题,也能回到上一步重试。
有订阅地址时,在客户端新建一个分组,填写便于辨认的名称与订阅地址,保存后更新该分组。只有一条分享链接时,使用从剪贴板导入的入口,不必先建订阅。导入结束后,检查主列表有没有出现预期条目,并选定用于测试的一条。若客户端提示没有找到配置,先确认复制的内容是完整地址或分享链接,不是二维码旁边的说明文字。订阅地址可能含有访问凭据,不要把完整地址贴到公开截图或问题反馈里。
桌面端在 v2rayN 选中配置后,设置「自动配置系统代理」,再打开一个沿用系统代理的浏览器。安卓端在 v2rayNG 点连接,首次出现系统 VPN 权限确认时,核对由哪个应用发起,再确认授权。测试期间先别改分应用名单,必要时确认没有其他 VPN 正在占用系统连接。若在启用代理或系统授权前就遇到错误,先处理客户端启动、运行环境或授权问题,不急着修改路由规则。
打开日常访问的页面,发起一次新请求并记下时间,再回到客户端观察这一刻的运行日志。没有对应记录时,先复查测试应用是否接入;记录显示已直连但预期应走代理时,再看规则匹配;已经尝试建立连接却超时时,依次检查本机网络、连接配置和服务端状态。验证结束后,可恢复原来的系统代理或断开安卓 VPN,再用同一应用重试一次,确认连接状态确实随设置变化。
项目、内核和客户端是三个层次。先弄清文档说的是哪一层,才能判断一项能力属于连接协议、内核实现,还是界面提供的设置。
Project V 是 V2Ray 早期所属的项目生态,V2Ray 的核心负责处理入站、出站与路由。V2Fly 社区延续维护 V2Ray 核心,Xray 则从这一代码谱系分出,沿自己的方向演进。日常讨论里,「V2Ray」既可能指内核,也常被当作这一类工具的泛称。遇到一份教程说「支持 V2Ray」时,应再核对实际指的是能导入某种分享格式,还是能按所用协议和传输参数完成连接。
两条内核路线共享部分配置概念,但协议名相同并不代表所有传输、安全设置都兼容。尤其要把协议类型与附加字段分开确认:一份使用 VLESS 的配置,还可能要求特定的传输或安全选项。若换内核后客户端能显示条目,启动或握手仍失败,应拿原配置逐项与受支持的字段对照,并确认服务端预期,而不是把「已导入」当成「已兼容」。
v2rayN 面向桌面,管理订阅、参数与系统代理;v2rayNG 将基于 Xray 的连接接入安卓系统 VPN 服务;v2flyNG 采用 V2Fly 内核,为有相应配置需求的安卓设备提供另一种选择。三款图形客户端均以 GPL-3.0 开源许可发布,可以免费使用。客户端许可不等同于内核及其他组件的许可,也不包含可用的服务器或订阅服务;已有配置仍应按其实际参数选客户端。
客户端、内核和用于路由的规则数据可能分别更新。客户端更新可涉及界面或系统接入,内核更新则可能改变配置解析和连接行为。如果只是个别域名的出站不符预期,优先看正在使用的路由规则与数据,而不是同时更换客户端和内核。更新前记录启用的分组、路由预设和应用范围;更新后先复现一条原本可用的连接,再测试新增配置,便于区分迁移问题与原有问题。
窗口打不开、单条连接超时、日志出现握手错误,分别对应不同的检查起点。先选与当前现象最接近的一篇;如果多个应用同时异常,建议从问题诊断中按症状逐项排除。
针对客户端启动即崩溃或闪退,依次检查 .NET 桌面运行库、解压路径与目录权限、安全软件拦截和损坏的配置文件,并附安卓端闪退的处理办法。
按本机系统时间、端口占用、系统代理模式、订阅参数、传输层与 TLS 设置的顺序,逐层排查节点超时与无法连接,每步附检查方法。
讲清日志级别设置与日志结构,逐条解读 connection refused、i/o timeout、tls handshake failure 等常见报错,给出对应的定位方向。