Windows
选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面;已有操作习惯、正在对照旧版菜单的人,也可以查看 WPF 入口。先在系统信息中确认是否为 x64。
若发行包需要解压,先完整解压到有写权限的目录,再启动程序。遇到运行库提示,记下缺少的组件名称,按下载页说明补齐后再试。
前往下载01 配置层次
看到节点只说明条目已导入。应用是否使用代理、内核能否与节点握手、请求是否按规则分流,分别由不同的设置决定。按症状切换下方刻度,先找到该查的那一层。
节点导入正常却总是握手失败,先核对协议、传输方式和安全层是否与服务端一致。VMess、VLESS、Trojan 与 Shadowsocks 的参数不能互换,同一种协议也可能搭配不同传输方式。在支持多内核的桌面客户端里,打开节点编辑面板只读核对,再确认实际启用的内核。相比只提供单一协议的工具,多协议客户端方便集中管理,但切换内核不会自动改写已有参数;应只调整确认不一致的一项,再做一次真连接测试。
对应排查章节:无法上网 →相比逐条粘贴节点链接,订阅把同一来源集中到一组,刷新时由该来源维护列表。在 v2rayN 的订阅分组设置中添加地址后,先手动更新一次,观察该组是否新增或替换条目,再考虑自动更新。超时说明请求还没拿到结果;若日志显示请求完成但列表为空,应检查返回内容是否为客户端可识别的格式。更新请求与节点连接是两条链路,后者成功不代表订阅地址也能访问。
对应排查章节:订阅失败 →只有部分站点异常时,先查请求命中了哪条规则。与只提供全局开关的工具相比,规则分流可以让局域网请求直连,同时给其他流量指定不同出站。客户端通常按顺序匹配规则,命中的第一条决定去向。把范围窄的例外放在宽泛规则前;规则指向的标签必须在出站里定义。测试时分别选一个预期直连和一个预期代理的目标,用同一应用复测,再对照日志判断改动是否生效。
对应排查章节:路由分流 →{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}浏览器能访问、另一款应用仍走直连,先检查应用是否读取系统代理。系统代理把本地地址和端口写入系统设置,与虚拟网卡接管不同,不必然覆盖所有程序。用 v2rayN 设置系统代理后,先用读取系统设置的浏览器做对照,再确认目标应用有无独立代理选项。若关闭客户端后所有网页都打不开,检查系统是否还指向已停止监听的本地端口。改路由预设不能修复应用没有交付流量的问题。
对应排查章节:系统代理不生效 →换设备时可以先用同一订阅和同一节点建立对照,通常不用把另一端的本地设置整份迁移。相比只在单个平台排查,跨设备对照能区分共享配置问题和单机问题。两台都失败,先看节点和当前网络;只有移动端锁屏后断开,优先核对系统的电池限制与后台权限。桌面的代理端口和系统开关不适用于移动端的 VPN 接入,别因为名称相似就照抄;应在实际出问题的设备上单独验证。
对应排查章节:移动端专项 →02 平台入口
程序打不开时,先核对系统、处理器架构和包格式,不要先换节点。安装与连接是两个环节:至少能正常打开客户端、进入设置页之后,再导入配置排查网络。
选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面;已有操作习惯、正在对照旧版菜单的人,也可以查看 WPF 入口。先在系统信息中确认是否为 x64。
若发行包需要解压,先完整解压到有写权限的目录,再启动程序。遇到运行库提示,记下缺少的组件名称,按下载页说明补齐后再试。
前往下载选择 v2rayN 的对应芯片包。在「关于本机」里查看芯片或处理器:Apple 芯片对应 arm64,Intel 处理器对应 x64。仅凭系统版本号无法判断架构。
从磁盘映像安装后,从「应用程序」重新启动客户端。若系统弹出提示,先区分架构不匹配、系统版本要求和权限提示,这几种情况的处理方式不同。
前往下载常用入口是基于 Xray 的 v2rayNG;已有明确的 V2Fly 配置需求时,再看 v2flyNG。先确认设备支持的应用架构;支持 arm64 选对应包,不确定时可查看通用包。
安装后先在前台完成首次 VPN 授权。如果连接只在切换网络或锁屏后中断,保留同一节点重测,再逐项检查其他 VPN 会话和后台电池限制。
前往下载先看发行版使用哪种包格式:Debian、Ubuntu 系通常选 deb,Fedora 系通常选 rpm。再用系统信息判断 x64 或 arm64;包名中的体系架构不能互换。
该入口是图形客户端。能安装不代表当前桌面环境会接管所有应用的代理设置。配置后用浏览器建立对照,再检查实际出问题的程序是否继承桌面代理。
前往下载03 首次连接
首次配置只验证一条链路:用一台设备、一张网络、一个节点。记录每一步看到的结果,后续即使更换设备,也能复现成功条件或定位失败点。
在桌面 v2rayN 里新增订阅分组并保存链接,再手动更新该组;使用 v2rayNG 时,从订阅分组管理添加后也需要执行更新。节点列表出现条目后,核对条目属于刚才更新的分组,避免把旧节点误当成新订阅的结果。
若节点数没有变化,查看更新时的提示。超时先查获取路径,提示格式不支持就核对订阅类型。订阅地址可能携带访问凭据,排障截图中应遮住完整地址。
从刚导入的分组选一个与客户端内核兼容的节点,桌面端确认已选为活动配置,再启用系统代理;移动端启动连接并完成系统的 VPN 授权。首次测试先用默认规则,暂时不叠加自定义分流和 DNS。
如果启动按钮很快回到未连接状态,先看日志中的首条错误。端口占用、配置不被识别和握手失败是不同问题;先处理启动错误,再做访问测试。
在会读取系统代理的浏览器里发出新请求,记录连接前后的访问结果,必要时对照出口地址和客户端日志。节点延迟能测出,并不说明这个浏览器的请求走了同一条路径。
若仅有一个网站失败,用同一浏览器另测一个预期走相同出站的目标,再检查规则命中和域名解析。若关闭代理也无法访问,先恢复基础网络,不要同时更换多个节点和规则。
04 开源生态
项目、内核、客户端和节点协议不是同一级名称。阅读教程或提交问题前,先确认说的是哪一层;特别是报错出现在启动阶段时,界面名称不能替代实际运行的内核名称。
V2Ray 源于 Project V。它把接收请求的入站、负责转发的出站,以及决定请求去向的路由拆成独立配置。入站负责把浏览器或其他应用的请求交给内核;路由按条件挑选出站;出站才负责直连、代理或其他处理。
这三个位置也对应三类常见现象:内核没有收到连接,先看本地接入;连接进入内核但走错出口,查路由顺序;请求已到预期出站却失败,再核对服务端参数和网络可达性。把问题分到这三层,比单凭「网页打不开」判断原因更准确。
V2Fly 社区延续 V2Ray 核心项目;Xray 从这一代码脉络派生后独立演进,两者由各自的社区维护。常见配置概念有重叠,但支持的传输方式、安全层和字段可能不同。标着同一种协议,不代表两边接受同一套完整参数。
遇到「条目能导入,内核却无法启动」时,先看日志指到哪个字段,再判断是该内核未实现这个选项,还是客户端生成配置时该项缺失。切换内核前记下原选择;复测时保留同一节点和网络,才好判断差异来自哪一层。
VMess、VLESS、Trojan 与 Shadowsocks 都可以在开源代理生态中找到实现。协议规定两端如何交换数据,传输方式和安全层则决定这些数据如何承载、如何保护。以 VLESS 为例,不能从协议名本身推断连接已经配置了 TLS,也不能把 TLS 和传输方式当成同一项。
读共享条目时先看协议,再看传输与安全层,把它们按各自字段与服务端设置逐项比对。若只从另一份教程抄一个参数,可能把两端原本相同的设置改成不一致。协议公开便于对照实现和排障,但不代表某份订阅或第三方服务属于客户端项目。
v2rayN 是桌面图形客户端,提供节点、订阅与路由管理,可按配置选用相应内核。v2rayNG 以 Xray 为核心,提供移动端订阅和 VPN 接入;v2flyNG 以 V2Fly 为核心,适合需要确认 V2Fly 兼容性的移动端配置。三者是开源客户端,界面负责组织配置,真正建立连接的是底层内核。
订阅服务与客户端也是两件事。安装客户端不会自动获得节点,客户端能打开也不代表订阅仍有效。远端返回错误、条目过期、应用缺少权限,分别要查订阅来源、节点配置和设备设置。先认清报错来自哪一方,再决定该查教程的哪一段。
客户端更新可能调整界面、系统支持或打包方式;内核发行可能增加字段、修复连接行为;订阅刷新只同步来源所提供的节点列表。订阅更新成功不能代替软件升级,重新安装客户端也不能让失效的订阅重新可用。
升级前备份自定义路由与配置,记下当前内核和正常使用的接入模式。升级后先验证原节点,再逐项恢复可选配置。如果出现回归,记录发生时间、平台与架构、所选内核、可复现的步骤和脱敏日志,比只提供一张连不上网的截图更容易定位。
05 专题速读
先按故障发生的位置选文章:更新订阅失败,查获取与解析;节点已经出现但首次连接失败,查节点和出口;只有部分应用表现不同,再区分系统代理和路由。
梳理订阅更新失败的常见原因:链接失效、更新请求未走代理、返回内容解析为空,并说明自动更新间隔与更新时是否走代理的设置方法。
从导入订阅后的第一次连接讲起:如何挑选节点、真连接测试和 TCPing 有什么区别,以及怎样确认流量确实经过代理出口。
厘清「系统代理设置」和「路由规则」是两层开关,对比全局、绕过局域网及大陆、直连三种预设分别适合哪些使用场景。