排障手册 · 08 类症状

V2Ray 问题诊断手册

先确定故障影响一个应用、一条节点,还是整台设备。再检查对应环节,不要同时改动节点、路由和 DNS。

第一次安装或还没有完成订阅导入,先走快速上手的主线:导入订阅、选择接入方式、连接并验证。已经能复现具体问题,就从下方选症状。本手册按故障环节组织,修复后可回到教程完成连接验证。

01 · 连接基线

无法上网:先恢复直连基线

启用客户端之后网页打不开,先确认设备本身还能不能联网。关闭客户端的接管功能,再访问平时可直接打开的站点。关闭后仍然失败,就先查无线网络、网关或系统设置;关闭后立即恢复,才检查客户端链路。用同一设备、同一网络、同一网址做前后对照,别拿两台设备的结果互相代替。

把退出程序和停止接管分开检查

桌面端使用 v2rayN 时,如果启用了系统代理,先在客户端内清除系统代理,再退出程序;如果还启用了虚拟网卡,也要单独停用。随后打开操作系统的网络代理设置,确认没有指向已关闭客户端的本地地址。若设备原先使用单位提供的代理或自动配置脚本,按原记录恢复,不要一律改成关闭。移动端则到系统网络设置确认 VPN 会话是否确实断开。

基线仍失败时,先看其他应用能否访问同一个站点,再用同一网络的另一台设备验证。若两台设备都失败,检查接入网络是否要求登录,或联系网络管理员。若只有当前设备失败,观察是否刚从有线切到无线、刚从睡眠唤醒,或者仍在使用旧的静态网络设置。测试时用一个新的浏览器标签发起请求;旧页面能显示,可能只是因为内容已经在本地缓存。

重新接入时只打开一种方式

直连恢复后,启动客户端,选一条以前确认可用的有效节点,等待内核完成启动。先用系统代理或 VPN 接管之一完成测试,不同时改变分流预设。桌面端可先用遵循系统代理的浏览器访问目标站点,再用平时直连的网站作对照。如果两者都失败,先看内核是否成功监听;如果只有一个网站失败,则记录该网址对应的日志,区分路由选择、域名解析和目标站点响应。

查看日志时,从发起新请求前开始记录。启动日志只证明进程走到了相应阶段,不代表浏览器已经把请求交给它。若已确认日志级别会记录访问,但请求期间没有对应记录,优先查应用接入方式。若日志明确显示连接远端超时,转到节点超时;若出现域名解析错误,转到DNS 问题。不要因为同一条日志重复出现,就把它当成多种独立故障。

直连与接管结果对照

对照结果优先判断下一步
停止接管后仍然失败问题可能早于客户端检查系统代理残留、网络认证和设备连通性。
直连正常,启动接管后多个站点失败查本地入口或节点确认内核启动,再用已知可用的节点复测。
仅一个应用失败应用代理或连接复用问题重启应用,核对它实际使用的代理与解析设置。
仅一个域名失败目标解析、规则或站点问题用该域名的新请求对照 DNS、出站名称和响应状态。

修复后先重复原先失败的操作,再测试先前能正常访问的站点,确认修复没有改变其他流量的处理方式。如果每次只有重启设备才能恢复,下一次故障先保留日志,单独测试停止接管、重启应用和重新连接网络。记录哪一步最先恢复,才能区分残留系统设置、应用连接未重建和网络本身不通。不要把一次重启后的成功视为已经定位根因。

02 · 节点路径

节点超时:区分端口、握手和目标请求

延迟列显示超时,不等于节点已经停用。端口测试、协议连接和网页探测检查的是不同环节,还可能使用不同的测试地址。先记录失败的是哪一种测试,以及浏览器中的实际请求是否也失败。若只有批量测试报错,先挑一条节点单独测,不要立即删除整个分组或用同一批结果给所有节点下结论。

先检查超时影响的是一条还是一组

在同一设备、同一网络,用两条此前正常的节点访问同一个目标。如果只有一条失败,优先核对这条节点的生效配置和服务状态。如果整个分组失败,但其他分组正常,检查这些节点是否共用服务器地址、端口或服务入口。如果所有分组一起失效,则回到内核启动、网络切换和域名解析,尤其要确认问题是否恰好发生在切换连接方式之后。

核对节点时,以服务提供方给出的参数为准:服务器地址、端口、协议、传输方式与安全设置要成套匹配。TLS 使用的服务器名称不一定与连接地址相同;反过来,也不要为了让报错消失,凭猜测替换服务器名称或忽略证书验证。若日志给出证书时间异常,先检查设备时钟和时区,再请服务方核对证书。若错误在订阅覆盖后出现,比较更新前后的协议字段,不要只比较备注名。

单独验证 TCP 端口与本地监听

启动失败和远端超时是两件事。若内核没有成功监听,本地检查会更早失败。下面是 Windows PowerShell 的交互式检查,只适用于基于 TCP 的节点端口;按提示输入客户端里已有的服务器地址和端口。它发起普通 TCP 连接,不会验证代理协议,也不经过浏览器的系统代理。不要填订阅链接、带路径的网址或认证信息。

$server = Read-Host '节点服务器地址'
$port = [int](Read-Host '节点 TCP 端口')
Test-NetConnection -ComputerName $server -Port $port -InformationLevel Detailed

结果里的 TcpTestSucceeded 为真,只说明此次 TCP 连接成功;为假也不能独自判定服务下线,因为解析结果、当前网络路径和服务监听状态都会影响它。若端口可通但客户端报握手失败,查看协议、安全层和内核支持;若握手成功但网页探测仍失败,检查测试网址是否可达,以及路由规则是否把该请求发到预期出站。没有收到普通 ping 回包同样不能推出端口不可用。

保留一组可供对照的复测结果

如果客户端的探测地址不可达,改用自己能够确认状态的测试目标,再发起一次真实请求。先测小页面,再打开最初失败的资源;记下端口、握手、页面三项中最先失败的环节。可参考真连接测试与首次验证。若只在某个网络失败,在具备使用权限时换一个已知正常的接入网络重复同一组操作,结果只说明问题与网络环境有关,不能仅凭这一项确定具体故障点。

修复时,若服务方已确认旧入口停用,就更新订阅或重新导入准确配置;若内核不识别协议字段,按客户端支持范围选用相符的配置。把旧配置保留到新配置完成网页测试,再清理重复条目。不要用延长超时来掩盖每次都在同一字段报错的情况;只有连接偶尔成功、日志没有固定配置错误时,超时设置才有对照测试的价值。

03 · 订阅更新

订阅失败:区分拉取、解析和写入

更新订阅失败,先不要删除旧分组。一次更新包括向订阅地址发请求、解析响应、把结果写入分组三步。能完成下载不代表响应可解析,列表数量增加也不代表选中的节点已经替换。先记录当前分组、上次成功更新时间和当前可用节点,再只更新出问题的组,避免把其他分组的结果混进日志。

拉取失败:检查更新请求实际走哪条路径

确认订阅地址来自当前有效的服务入口,复制时没有混入引号、换行或尾部空格。查看客户端报错属于解析域名失败、连接超时,还是服务器已经返回状态码。收到未授权或禁止访问响应时,先在服务方提供的管理入口核对授权与链接是否更换;服务器返回重定向时,也要确认最终响应是订阅内容,不是登录页面。别反复手动改写地址中的参数。

v2rayN 中,如果当前版本区分直接更新和经代理更新,先保留现有配置,分别做一次对照。直连不可达但已有可用节点时,可以用那条节点验证代理更新;当前节点本身已失效时,不要依赖它去拉取替代节点。此时优先确认订阅地址能否通过经授权的可用网络访问,或从服务方取得可用配置。浏览器能加载某个页面,也不证明客户端更新请求采用了同样的代理设置和身份状态。

拉取成功但结果为空:检查内容与分组

服务端可能返回正常状态码,却把登录页、错误提示或其他客户端专用配置当成响应体送回。先看客户端给出的识别结果,再请服务方确认订阅格式和适用客户端。不要把订阅全文提交给在线转换或解码页面;这类内容可能包含可直接使用的认证字段。若能在客户端中隔离试验,可保留原组,另建临时组验证同一链接,避免可用列表被空响应覆盖。

列表里有条目但界面看不到时,先清除搜索词、切换到刚更新的分组,核对是否有隐藏条目的筛选。若只有少数节点导入成功,比较成功与失败条目的协议、传输设置和客户端识别提示。服务方新增了当前内核不识别的字段,不等于整个订阅无效。手机上可对照服务方支持说明选择 v2rayNG 或 v2flyNG,而不是把三款客户端能否导入视为完全相同。

先修手动更新,再恢复自动更新

手动更新稳定后,再检查自动更新间隔与更新时使用的代理方式。自动任务执行时,电脑可能已休眠、客户端未启动,或原先选中的节点已失效。要验证间隔设置,记录保存设置时间与下一次实际执行时间,再比对日志。若手动正常却一直没有自动任务,查运行状态和对应分组的自动更新设置;若任务已经执行且返回错误,则沿拉取或解析环节继续排查。相关操作见v2rayN 订阅更新失败排查。

最终验收不只看「更新成功」。打开目标分组,核对条目确实写入,再选一条新配置完成实际连接。若界面当前选择指向旧条目,需要重新选择后发起请求。自动任务恢复后,也要确认它更新的是同一个分组,并且没有把手工保留的条目覆盖。不确定分组如何建立时,先回看订阅导入步骤。

04 · 性能对照

速度慢:分别测首包与持续传输

网页打开慢、文件下载慢和视频频繁缓冲,不一定是同一种性能问题。页面长时间空白之后突然加载完,往往值得先查 DNS、连接和握手;下载一开始就能传输,但整个过程速率低,应先查链路吞吐、并发和两端负载。先选能稳定复现的任务,不要拿一次很快的延迟测试反驳大型文件传输中的持续卡顿。

固定目标,再更换一个条件

使用同一设备访问同一个已获授权的测试目标,尽量在相近时间内测试。先暂停系统更新、云盘同步和其他大流量任务,再记录直连或现有配置下的表现;如果目标本身无法直连,不把直连失败记作速度为零,换成一个双方都能验证的目标来做通用路径对照。下载测试可使用同一个资源,记录启动等待与稳定阶段速度,单位要统一,避免把每秒字节与每秒比特当成同一数值。

同一节点在有线连接正常而在无线连接慢,先检查无线信号、距离和同网其他设备的占用状况。同一网络只有一个节点慢,则检查该节点到目标的路径、服务状态和高峰时段表现。若不同节点访问同一个资源都慢,但访问另一个来源正常,应先考虑资源端限速或服务响应异常。更换节点和更换资源不要在同一轮测试里同时做,否则无法判断改善来自哪个变量。

用计时数据定位慢在哪一段

如果桌面端已安装 curl 并启用了本地 HTTP 代理入口,可用下列命令测试 HTTPS 请求。示例使用公开示例域名,只用于观察时间分段,不用于测吞吐;若本地端口不是 10809,替换为客户端实际显示的 HTTP 代理端口。Windows PowerShell 中可将命令名写为 curl.exe,并将输出目标 /dev/null 改成 NUL。

curl --proxy http://127.0.0.1:10809 --max-time 20 --silent --show-error --output /dev/null --write-out 'connect=%{time_connect}s tls=%{time_appconnect}s first_byte=%{time_starttransfer}s total=%{time_total}s http=%{http_code}\n' https://example.com/

这些数值是从执行开始累积的时间,不是可以直接相加的四段耗时。使用显式本地代理时,连接时间主要对应 curl 连到本地入口;代理何时连到远端并不由该字段直接表示。TLS 完成时间可能包含代理建立隧道所用的时间,首字节又包含目标处理时间。对照浏览器行为时,记住浏览器可能复用连接或使用缓存,不能要求两者每次读数相同。若命令报错,先读错误信息和响应状态,不解读零值。

根据复测结果决定是否改设置

首包慢且日志频繁出现解析重试,转到 DNS 章节;持续传输慢,则在相同任务下观察设备处理器使用率、网络占用和内核日志。错误日志稳定出现时先修错误,不把长期开启详细日志当成优化方法。若问题只在多任务并发出现,先降低并行任务数量做对照,确认是一条连接受限还是所有任务一起争用链路。能改善才保留改动,不能改善就回退。

若速度只在某个时段下降,把该时段和正常时段的结果分别记录,并确认当时使用的是同一节点、同一目标和同一路由。服务方可据此核对负载;设备侧则可查是否有定时更新或备份任务。未能复现时,先保留原配置和观察记录,不建议为了改善一次测速而更换传输参数、随意启用多项优化或覆盖原先可用的配置。

05 · 域名解析

DNS 问题:确认谁解析了哪个域名

域名打不开而其他服务正常,不能直接归因于 DNS。先观察报错属于域名不存在、解析超时,还是域名已经解析但后续连接失败。还要确认出问题的是节点服务器域名,还是网页目标域名:前者可能让节点根本无法建立连接,后者通常只影响特定站点或一类出站请求。两个域名出错的位置不同,不能用同一个设置盲目覆盖。

分别检查系统、应用和内核的解析路径

系统代理不等于所有域名都由内核解析。浏览器可能启用独立的安全 DNS;应用可能自己解析;接管模式、代理协议及路由设置也会影响域名是在本机还是在远端解析。先看失败请求的日志是否仍保留域名,是否已记录目的地址,以及发起解析的是应用、内核还是系统。没有相关日志时,先检查当前日志级别与接入方式,不要把日志里的空白直接写成「未发送 DNS 请求」。

在桌面系统上可用下列命令观察系统环境里的常规 DNS 查询。把示例域名换成发生故障、允许测试的域名。记录解析服务器、返回的地址和错误类别,然后与客户端日志对照。该命令不代表浏览器安全 DNS,也不等于内核使用了同一个解析器。若看到服务器名称未识别但域名正常返回地址,应以此次查询结果为准,不把显示名称缺失当成故障。

nslookup -type=A example.com
nslookup -type=AAAA example.com

把查询失败与地址不可达分开处理

如果查询超时,先看当前网络是否能访问所用解析服务器,以及客户端是否把对解析器的连接又交给了尚未连通的节点。如果收到域名不存在响应,重新核对完整域名,检查私有域是否需要单位网络或特定解析器。若只缺一种地址记录,不一定异常;某些站点本来只发布一种地址。若能返回地址但连接仍失败,应继续查返回地址对应的网络路径、证书和路由,不要反复更换解析服务。

定位到地址族差异时,分别记录两个查询结果和实际连接采用的地址。双栈设备上,返回 IPv6 地址并不意味着本机具备稳定的 IPv6 路径;浏览器能自动换用另一地址族,也不代表内核或目标应用采取同样的策略。先用客户端现有选项做局部对照,观察实际请求是否好转,再决定是否保留。不要把关闭整台设备的 IPv6 当作默认处理,否则可能伤及原本正常的服务。

检查分流依赖的域名与解析顺序

某些规则按域名匹配,另一些规则按地址匹配。若应用交给内核的只是一个已经解析的地址,域名规则能否命中取决于内核是否取得域名信息和实际配置。若路由又需要把域名解析为地址,解析阶段的失败便可能表现为分流异常。先对照规则命中或实际出站,再判断是哪个环节改变了请求。术语之间的关系可查概念速查,修改顺序见系统代理与分流。

复测时关闭旧标签并重启受影响的应用,必要时等缓存到期,再测最初失败的域名和一个原本正常的域名。如果是单位私有服务,还要确认修复后内部域名仍走规定的解析路径。每次只改一处解析设置,写下变更前后的预期与结果。若要回退,恢复的是原解析器与原接入模式,而不只是把刚添加的地址从列表里删掉。

06 · 接管与出站

系统代理不生效:分开检查接入与分流

系统代理决定部分应用是否把请求交给客户端,路由规则决定内核收到请求后使用哪个出站。开启系统代理不代表每个应用都会读取它;选择一套路由规则也不会让未进入内核的流量自动进入。先判断请求有没有到达内核,再判断它是否走了预期出站。两个开关一起改,容易造成「网页恢复了,但不知道为什么」的结果。

验证本地代理入口与应用设置

桌面端首选 v2rayN。先在客户端查看监听地址、端口和代理类型,再对照系统代理设置。若应用提供独立的代理选项,检查它是否明确选择遵循系统设置,或者是否仍写着以前使用的端口。系统代理生效后,重启该应用或发起全新连接再验证。已有连接可能继续使用旧路径;只刷新页面而不重新建立连接,无法排除这种影响。

本地监听端口填对了,也要区分 HTTP 和 SOCKS。如果应用使用 HTTP 代理却填入仅供 SOCKS 使用的端口,可能连到本地进程却不能完成请求。可用受信任的测试目标,对照显式指定本地代理的请求和应用自身的请求。前者正常、后者不经过内核时,先回头查应用设置或进程环境,不急着更换节点。若代理本来只供本机使用,不要为了解决接入问题把监听地址改成对所有网络接口开放。

已进入内核:核对规则顺序与出站标签

路由规则通常按列表顺序匹配。宽泛规则放在前面,后面的例外可能永远到不了;多个条件写在同一条规则里,也不等于随便满足其中一项就命中。先找出失败请求实际使用的出站,再检查它是否被更宽泛的规则提前匹配。若修改的是客户端预设,确认保存后选择的仍然是刚修改的配置;有些更改需要重新载入内核才会生效。

下面是核心配置中可合并的路由片段,用一个保留示例域名演示精确匹配。它不是完整启动配置;仅在已有出站的标签确实为 direct,并且该目标按你的网络规则允许直连时使用。full: 匹配完整域名,不会同时匹配其子域名;AsIs 在这里表示路由匹配阶段不主动为了匹配地址规则而解析域名,不表示应用完全不需要解析。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

在现用配置中测试时,只合并需要的规则,不要用整个片段覆盖原有 routing,也不要顺手更改现网的域名策略。规则出站标签应与定义完全一致。验证时分别请求示例规则目标、一个原本由节点处理的目标和一个原本应直连的目标,检查三者是否仍符合预期。若仅某个域名规则不生效,先确认内核收到的是域名还是地址。

根据失效范围选择修复方式

只有一个应用不遵循系统代理,优先使用该应用支持的接入设置。大范围应用都没有进入内核,就核对系统代理入口、客户端运行状态,或按单位管理要求配置设备级接管。有流量进入但出站不对,才调整规则。预设的名称只能帮助识别用途,不能代替实际规则与日志对照。相关概念见系统代理与路由模式区别。

07 · 启动与进程

客户端崩溃:拆分界面退出与内核退出

双击没有窗口、界面一闪消失、界面还在但无法连接,是三个不同的现场。先确认有没有界面进程和内核进程,记录问题发生在启动程序、加载配置还是点击连接之后。若崩溃导致网络中断,先恢复原有系统接入设置,再做后续试验。连续重开程序可能冲掉上一轮日志,先保存第一次可辨认的错误。

核对平台、架构和安装方式

桌面端首选 v2rayN。安装包的架构要与设备和系统环境匹配:Windows 按Windows 下载区区分桌面版与经典 WPF 版;macOS 到macOS 下载区按芯片选包;Linux 到Linux 下载区同时核对处理器架构和发行版适用的包格式。遇到缺少运行环境的提示,以实际发行包说明为准,不要从其他程序目录拼接运行库。

对于需要解压的包,把整个包解压到自己有权限维护且路径稳定的目录再运行,不要直接从压缩文件的预览窗口启动。如果程序只能写入一部分配置文件,界面可能启动后退出,或下一次启动丢失设置。先检查目录权限、可用磁盘空间和安全软件给出的实际记录。设备受管理时,遇到系统阻止执行应由管理员核查,不通过调整整机安全策略来试错。

界面存在但内核停了:先读第一个错误

内核启动失败时,最后一条日志常是通用的退出通知,真正的原因在更前面。看到地址已被使用,先核对本地监听地址与端口,看是否有重复启动的客户端实例或其他已知服务占用。只关闭明确识别且允许停止的进程,或者改用空闲端口并同步相关应用设置。看到配置解析错误,则从指定字段或规则位置入手,而不是先尝试切换系统代理。

若只有选中某个节点才退出,可暂时不接管系统,选一条之前可用的节点复测。前者失败而后者成功,先比对传输参数、协议字段及关联规则。所有节点都失败,则检查通用配置、文件读写和内核是否能被当前客户端调用。若启动和第一次连接都正常,只有睡眠恢复或网络切换后退出,应保存该时刻前后的日志,同时记录网络是否在进程退出之前已经发生变化。

干净环境测试与配置回迁

重置之前先备份配置和可用节点,记录界面设置及系统原有接入方式。按客户端支持的方法隔离旧配置,在新环境中只导入一条确认可用的节点,验证启动、停止、再次启动。若已经能稳定运行,再分批迁回订阅和基于旧配置的规则,每次复测一步。如果搬回某一批后复发,就缩小到该批内容;不要把整个旧配置覆盖回去再重复同一轮故障。

若新环境也复发,补做一次仅启动界面、不连接的测试,再做一次连接后立即主动退出的测试。界面刚启动便退出,多查界面运行环境和应用数据;只有接管网络时失败,则查相关权限、内核日志和系统网络组件。只有旧环境失败时,保存可复现问题的那部分配置供诊断,不必回退整台设备或删除其他正常配置。更换安装包后的验收至少包括重启应用和一次完整的连接验证。

08 · 移动端专项

移动端断连:检查 VPN 接管与后台状态

Android 上常见三类现象:点连接后系统会话未建立,切到后台或锁屏后断开,切换无线网络与移动数据后不能恢复。先分开测试,不要边锁屏边切换网络。v2rayNG 使用 Xray 内核,v2flyNG 是 V2Fly 内核备选;安装包与适用架构见Android 下载区。换客户端之前,先确认问题是否来自系统会话管理。

连不上:检查授权、现有会话和应用范围

首次启动 Android VPN 接管时,系统会请求授权。若界面显示正在连接,但系统设置里没有对应会话,先查看授权提示和客户端日志,再核对是否已有其他 VPN 正占用当前用户的接管位置。设备如果处于受管理状态,始终开启的 VPN 或工作资料的接入策略可能由管理员控制。不要强行关闭受管配置;先确定当前应用所在的用户或工作资料,再按系统策略处理冲突。

若系统会话已建立,但只有个别应用打不开或不走预期路径,则检查客户端的按应用接管列表。要分清列表表示「仅处理选中的应用」还是「排除选中的应用」。修改后重新连接并重启受影响应用,确认在同一用户环境下复测。状态栏出现 VPN 标识,只说明存在会话;应用是否被纳入、内核是否连通节点、路由是否正确,仍需用实际请求验证。

锁屏断开:区分进程被回收和节点掉线

先保持设备亮屏,连续打开页面并记录客户端状态。随后在同一网络锁屏一段可重复的时间,解锁后先查看系统会话和客户端日志,再打开原目标。会话消失、进程重启或日志重新出现启动段,优先查系统对后台活动的限制;会话仍在但请求超时,先查网络切换、空闲超时或节点状态。不要仅凭仍显示通知就判断连接一定有效。

若问题和后台限制有关,在系统允许的范围内,仅调整该客户端的电池使用或后台活动选项;不同设备的设置名称可能不同。调整前写下原值,略过无关应用和整机省电策略。若系统还启用了省流量设置,分别对照前台与后台的移动数据访问,不把电池限制和数据限制混在一次改动里。对照无效就恢复原值,并检查是否存在固定时间发生的客户端重启或接入网络变化。

切网失败:先验证新网络的基础连通性

从无线网络切到移动数据后,原连接可能已失效,新的连接需要等系统拿到可用路径才会建立。先停用个人客户端的接管功能,在新网络上验证一个原本可访问的目标。若新网络本身不可用,检查接入认证或移动数据设置;若直连正常,再连接同一条节点复测。若仅从某个方向切换会失败,记录切换前后网络类型、重连时间和第一条错误,区分移动网络路径与客户端未能重建连接。

最后用同一个应用复测前台连接、锁屏恢复和切网三种情况,再用第二个应用检查影响是否只限于单一应用。若连接能自动恢复,但每次都要等待一段时间,记录从网络可用到请求成功所需的时间,不要把等待期直接记作持续断连。若只有域名请求在切网后失败,回到 DNS 章节核对应用、系统和内核实际使用的解析路径。

返回症状目录 ↑