V2Ray 故障排查手册
先确认故障发生在哪一层,再改对应的设置。还没有完成安装、订阅导入和首次验证时,请从入门指南顺序操作;已经连过、现在遇到具体症状时,可直接从本页目录进入对应章节。入门指南讲正常流程,本页讲在哪一步停下、如何验证以及改动无效时怎样恢复。
连接后无法上网
客户端显示已连接,只能说明它完成了某个本地启动步骤,不能证明网页请求已经经过正确的出站。先把症状分为两类:关闭客户端仍然无法打开网页,优先处理本机网络或残留代理;关闭后恢复,只在运行客户端时失败,再检查本地入口、路由和出站。桌面以下以首推客户端 v2rayN 为例,菜单名称以当前界面为准。
先恢复一条可用的基础网络
在 v2rayN 中先用托盘菜单清除由客户端设置的系统代理,再退出程序。若设备原先由单位配置代理,应恢复原来的设置,不要一概改成关闭。安卓端先在客户端断开,再到系统的 VPN 页面确认状态;如果启用了始终开启或阻止未使用 VPN 的连接,断开后不能上网可能正是该策略的结果。受管理的设备不要自行修改策略,可请管理员协助确认。
用浏览器分别打开两个平时能访问、且不依赖同一服务的网站。不要只看已打开的旧标签页,缓存可能保留一部分页面,让失败显得时好时坏。如果两个站点在基本网络下也失败,先检查是否连对无线网络、是否需要完成公共网络登录,以及同一网络上的另一台设备是否正常。只有一台设备失败时,先看它的代理与网络设置;多台都失败时,先确认接入网络本身。
把本地监听和真实网页请求分开测
在桌面端重新启动内核,只保留一份客户端实例。打开参数设置查看本地 SOCKS 端口;下面以常见的 10808 为例,实际测试要使用界面显示的值。第二条命令显式把请求交给本机代理,不依赖浏览器是否采用系统代理;域名也随请求交给代理侧处理,适合检查这条路径能否完整访问网页。它不会改变系统设置。
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
第一条若显示端口不可达,先看内核有没有启动、监听地址是否为本机回环,以及端口是否填错,暂时不用反复切节点。第一条成功而第二条立即被拒绝,要核对端口对应的协议:本地 HTTP 代理和 SOCKS 代理即使都在监听,也不能互换。若第二条拿到来自目标站点的响应头,说明这次请求走通了;这不代表所有网站都可达,也不说明浏览器已经接入同一个入口。
根据日志判断请求停在哪一层
保持日志窗口可见,只发起一次测试请求并记下时间。如果对应时刻完全没有连接记录,先确认应用实际用的是哪个代理,再检查日志级别是否足以记录连接。如果能看到请求进入但没有按预期选择出站,核对当前启用的路由方案以及较宽泛的规则是否排在前面。如果日志已显示请求交给选定出站,再去看连接超时、名称解析或握手的第一条错误,不要用最后一行重试失败替代根因。
排查结束前,把先前有用的设置逐项恢复,再重复一次真实使用场景,例如同时打开一个走直连的常用网页和一个由代理处理的测试网页。若显式命令一直能成功、日常应用却仍打不开,直接进入系统代理不生效;若只有某一服务的域名不通,先看DNS 问题,不必重装整个客户端。
节点超时与握手失败
延迟测试报超时,含义取决于客户端使用的测试方法。有的测试只尝试连接目标端口,有的会通过节点访问测试网页;前者成功不能证明协议握手有效,后者失败也可能是测试站点本身不可达。先使用同一个节点发起一次普通网页请求,并让日志时间与点击时刻对上,再决定要检查地址、端口还是握手参数。
检查时钟、节点地址与目标端口
先查看系统日期、时间和时区,允许设备与可信时间源同步。证书有效期依赖系统时钟,长时间休眠或手动调过时间后尤其值得检查。如果同步后报错消失,保留正确时间,不用改协议参数。如果日志提示找不到服务器域名,先检查域名是否导入完整,再比较系统解析与客户端实际解析;不要为了测试而把订阅中的服务器名称永久换成某个临时地址。
若检查的是基于 TCP 的连接,且该服务由自己管理或已获授权,可在 Windows 用 Test-NetConnection 检查实际服务端口。明确收到拒绝时,检查服务是否在预期地址与端口监听,以及是否接错了入口;持续超时则还要考虑链路、访问规则和服务离线。端口能连只代表 TCP 建连成功,不能验证证书、传输路径和认证。使用基于 UDP 的传输时,不能把这项 TCP 测试的结果当成结论。
用同一次复现核对握手字段
打开节点详情,对照服务端给出的原始参数:协议、服务器端口、传输方式和安全类型先核对,再检查服务器名、主机标头和传输路径。服务器地址是建立连接的目的地;TLS 服务器名用于握手和证书身份判断,传输层的主机标头或路径则用于后续服务匹配。它们有时相同,却不该机械填成同一个值。导入后未显示的字段也不要凭经验补齐,应回到配置来源确认。
日志若先报证书名称不匹配、证书过期或链不受信任,就按具体条目处理,不要把跳过证书验证作为修复手段。TLS 报错前如果已有读取超时,超时也可能出在上游转发或服务等待,而不只是证书。遇到与内核能力有关的提示时,在横向评测确认客户端选择,再查看Xray 与 V2Fly 内核差异。换内核前保留原设置,避免同时换节点又换内核而无法比较。
做交叉复测,避免把相关性当成根因
保持设备和网络不变,比较另一个已经验证可用的节点;再保持问题节点不变,换到另一条已知正常的网络复测。如果只有同一节点在两条网络上都失败,重点核对该节点配置或服务端状态;如果多个节点只在一条网络上失败,重点检查接入网络。设备换网时有可能同时切换了地址族或名称解析服务,因此结果只能缩小范围,不能单凭一次成功认定故障原因。
交给服务维护方的记录,应包含失败时刻及其时区、所用传输类型、是否完成了到服务端口的连接,以及日志中最早的错误。不要公开认证字段、分享链接或截图里的订阅地址。想进一步阅读错误语义,可查常见日志报错说明;需要按 v2rayN 界面回看操作顺序,可对照节点超时排查顺序。
订阅更新失败或列表为空
订阅更新分成获取内容和解析节点两步。提示更新失败,先查网络请求;提示更新完成却看不到节点,先查当前分组、返回正文与格式。开始前保留仍可用的旧分组,不要先清空列表,也不要为了试验把个人订阅送到在线转换工具。许多订阅链接本身就具备访问权限,泄露整条地址与泄露单独的密码一样需要处理。
确认更新的是哪条地址和哪个分组
在 v2rayN 的订阅分组设置中查看当前分组及其地址,确认保存后选择了更新该分组,而不是看着另一个分组的结果。安卓端在 v2rayNG 或 v2flyNG 的订阅分组管理中核对相同信息,再回到节点列表执行更新。复制时留意首尾空白、换行和聊天应用自动追加的标点;地址里的查询参数通常是必要字段,不要手工截短,也不要随意重新编码。
如果列表仍显示旧项目,先检查是否开启了关键字搜索、分组筛选或仅显示当前分组。也要区分“添加了分组”和“更新了分组”:前者只是存入地址,不会自动证明内容已经成功导入。新增一个临时分组用来对照时,不要立即删掉原分组;先确认新分组能选中节点、能连接,再处理重复项。
根据获取结果分支处理
如果日志显示名称解析失败、连接超时或证书错误,先处理取得订阅内容的网络路径。核对客户端提供的是直接更新还是经代理更新,并确认后者所依赖的旧节点仍可用。若恰好所有节点都失效,经代理更新可能形成循环依赖。这时优先使用能够正常访问订阅服务的网络,或让维护方提供有效入口;不要不停重复同一种失败请求。
收到未授权或禁止访问时,先核对订阅是否过期、权限是否被重置,采用维护方提供的新地址。找不到资源时要检查路径是否被替换;提示请求过多时按服务规定等待。即使状态显示成功,也可能实际返回登录页、维护页或错误说明。只在可信设备上查看返回类型,不复制正文到论坛;若本机访问这个地址需要登录,图形客户端通常不会自动继承浏览器的登录状态。
验证返回格式与节点兼容性
区分单条节点分享链接、节点列表订阅和完整内核配置。三者入口不同,把完整配置粘进订阅地址栏不会得到有效列表。某些服务会按请求客户端返回不同格式,同一个地址能在浏览器下载文本,也不等于现用客户端能够解析。应向来源核对该地址对应的客户端格式,而不是手动拆改整段编码文本。出现部分条目时,记录具体缺少哪种协议或传输,再核对可用内核所支持的字段。
更新完成后先检查目标分组是否出现预期节点,再手动选一个节点发起网页请求。出现列表说明解析有结果,但不保证每条节点都能连通;反过来,旧节点能用也不能证明订阅已更新。如果反复读到旧内容,记录客户端显示的更新结果,确认是否存在服务端缓存或发布尚未完成的情况。确认新旧差异后再整理分组;若只是找不到对应菜单,可回到入门指南对照导入流程。
速度慢与间歇性卡顿
先把“慢”说清楚:是域名第一次打开等很久,还是开始下载后吞吐一直偏低,或者实时音视频隔一会儿就卡住。三个现象分别可能涉及解析与建连、持续传输、抖动或丢包。窗口里的单个延迟值只能反映某一次测试的响应时间,不代表大文件速度;测速网站快,也不能证明工作用的实际服务在相同路径上表现一样。
建立能重复的对照
暂停同步、备份和其他下载,选同一个可公开访问的测试资源,在相近时间记录基本网络和代理路径下的表现。用大小相当的资源重复几次,比较典型结果,不挑最快的一次。如果两条路径本来就不能访问同一站点,只比较各自可达的基准,不把它们当严格的同目标对照。分别记下首次打开等待、持续传输趋势以及是否发生中断,便于把原来看起来相似的卡顿分开。
先保持节点不变,在无线网络、网线或移动数据之间选两种条件复测;再保持网络不变,比较不同的可用节点。若基本网络和代理一起变慢,先查信号、后台竞争或接入线路。只有某一节点在同条件下持续偏慢,再向服务方确认带宽限制或负载。若只在一段时间出现,补测另外一个时段,别把晚间的偶发拥塞当成某个设置长期有误。
确认流量确实使用了正在比较的路线
让客户端日志记录一次实际请求,核对目标域名与出站标签。应用可能按自己的代理偏好直连,也可能匹配到当前路由中的兜底规则,结果和想比较的路线不同。有些系统的代理入口主要接收 HTTP 或 HTTPS 请求,不能据此推定实时应用的 UDP 流量也走了同一路径。先查文档和日志,看该应用是否支持当前接入方式,再判断协议差异是不是卡顿的原因。
网页要从多个域名加载脚本、图片和接口。主文档很快,而页面迟迟不能使用时,可查看浏览器网络面板中最慢的请求,区分解析等待、连接等待和内容下载阶段,再对应看客户端日志。如果只有一个资源域名持续慢,重点检查该域名的分流与目的服务;不要为单个资源重置全部路由。如果日志级别已经调到调试,只在复现窗口保持开启,完成后恢复日常级别。
检查设备负载和改变设置后的副作用
速度下降的同时观察系统任务管理器或资源监视器。若客户端下载时处理器持续繁忙、设备温度升高或写入磁盘成为瓶颈,可以先停止高负载程序、在设备温度正常时复测。用浏览器单独测试和多任务同时测试做对照,比仅看下载窗口更容易发现本机瓶颈。安卓设备若只在熄屏后不稳定,则先按安卓后台断连章节验证系统是否停止了服务。
不要在没有证据时同时改传输、开启复用和调整虚拟接口参数。遇到小页面正常而大传输频繁停顿,也不能只凭现象就认定报文大小有问题;先排除资源端限速和链路丢包,必要时让负责网络的一方查看路径。保留一项调整的条件是:相同测试可以重复改善,且没有引入新的超时、音视频异常或局域网访问问题。否则恢复改动,带着对照结果继续定位。
DNS 解析与分流异常
解析错误可能发生在两个不同对象上:服务器域名解析失败,会妨碍客户端建立出站连接;目标网站域名解析失败,则可能只影响少数请求。先从日志确认报错域名属于哪一类,再确认执行解析的是系统、应用还是内核。网页提示找不到服务器,并不自动等于系统 DNS 坏了,也可能是网页请求经代理发出后才遇到解析异常。
比较系统查询和实际应用请求
先用系统默认设置查一个公共域名,记录返回地址、错误或等待时间。Windows 可用下面的系统查询诊断工具;如果要复现具体域名,请将示例换成公开、可测试的目标。它只能说明这次查询的结果,不代表浏览器的安全 DNS、内核配置中的解析器或代理对端也得到了同样的回答。
Resolve-DnsName -Name example.com -Type A -DnsOnly
Resolve-DnsName -Name example.com -Type AAAA -DnsOnly
分别查询 IPv4 与 IPv6 地址是为了发现哪一类结果存在,而不是要求每个域名两种地址都返回。收到某类记录也不意味着当前网络能连到该地址。若系统查询成功而浏览器失败,检查浏览器是否使用自己的安全 DNS,并比较另一款使用默认网络设置的应用。若只有显式代理请求失败,则看内核或对端是否承担目标解析,再对照那条路径的日志。对照结束后应恢复原有安全 DNS 策略。
看清名称匹配和地址匹配的先后
内核在收到域名时,可以按域名规则决定出站;是否继续把域名解析成地址参与匹配,受路由域名策略影响。AsIs 不为路由匹配主动解析域名;IPIfNonMatch 可在域名请求未匹配到规则时尝试解析后匹配地址。如果应用早已自行解析,只把目标地址传给内核,那么域名规则未必能够匹配该请求。先看日志里的目标形态,再决定应核对哪类规则。
以下是适用于已设有 direct 出站标签的内核配置片段,只展示把一个本地管理域名交给直连的规则。用于自己的配置时应换成实际管理的域名,并合并到现有规则中;它不是完整配置,也不会自动指派解析器。若该域名只能通过内网解析,直连规则正确仍不足以让公网解析器返回可用地址。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:router.home.arpa"],
"outboundTag": "direct"
}
]
}
}
处理内网域名、缓存与启动依赖
家庭管理域名或单位内部域名应继续由对应网络认可的解析器回答。不要为了测试,把内部名称发送到外部公共解析器。修改规则后,先记录旧结果与新结果,再重启测试应用以排除旧连接复用;缓存还有生存时间,系统、应用和内核不一定在同一时刻刷新。若新旧结果交替出现,应先找出哪层给出哪条记录,而不是连续更换多个解析服务。
还有一种常见循环:节点地址依赖域名解析,而用于解析该地址的请求又被配置为走同一个尚未连通的节点。此时即使代理出站定义正确,也无法完成启动。先核对节点域名使用的初始解析路径,再核对目标域名的解析策略。修复后分别复测节点启动、普通网站和需要保留的内网名称。参数含义可在概念速查中对照,不要用一条新规则覆盖已有内网设置。
系统代理不生效
系统代理决定遵循系统设置的应用把请求交给谁,路由决定内核收到请求以后从哪个出站发出。两者需要分别验证。网页按路由走了直连,并不表示它没经过本地客户端;反过来,客户端的状态栏显示代理已设置,也不能保证每个应用都会读取系统设置。要判断是哪一层的问题,先查一次真实请求有没有进入本地监听。
在桌面系统核对实际入口
在 v2rayN 托盘菜单中选择自动配置系统代理,再打开系统网络设置查看结果。需要手动指定代理的应用,按其支持的协议填入客户端界面所示的监听地址和端口,不能把远端节点端口当作本地入口。在同一台电脑上测试时通常使用回环地址,不需要为了排查打开“允许来自局域网的连接”。本地入口若曾改过端口,也要同步检查手动配置的应用是否还指向旧端口。
| 系统 | 先查哪里 | 如何确认 |
|---|---|---|
| Windows | 设置 → 网络和 Internet → 代理 | 检查手动代理与自动配置脚本;某些服务使用不同于桌面应用的代理配置。 |
| macOS | 系统设置 → 网络 → 当前服务 → 详细信息 → 代理 | 确认查看的是正在使用的网络服务,再核对已选代理的类型与端口。 |
| Linux | 桌面网络代理设置、目标应用的偏好设置或启动环境 | 核对桌面会话和命令行进程是否采用同一入口;两者不一定共享代理状态。 |
系统页中若同时存在自动配置脚本和手动配置,先记录原来的值以及是否由单位策略管理。旧脚本可能针对某些域名返回直连,另一个网络工具也可能在客户端设置代理后又写回原值。若退出应用后仍留有指向本机端口的代理,先用客户端的清除系统代理功能恢复;对于受管理机器,按管理员提供的原始配置恢复,不要删除来源不明的管理项。
分清应用覆盖和路由结果
仍然表现异常时,选一个应用单独复测。检查应用设置是否选择了“使用系统代理”,是否启用了独立代理配置,或者是否有“直连”覆盖项。关闭测试标签页并重新发起请求,必要时重启该应用,避免已建立的连接沿用旧设置。命令行工具则可能从环境变量取得代理地址;显式指定本机代理成功,只能证明那条调用方式可用,不能替系统设置作验证。
如果客户端已经收到请求,在日志中检查所选出站。直连标签意味着请求达到内核后按规则直接发出,应检查路由而不是继续修改系统代理。核对较具体的目标规则是否被更宽的前置规则截获,以及最后命中的是否其实是默认出口。若明确要测试虚拟接口模式,先记录现有系统代理与其他网络工具的状态,分别测试,避免两个入口同时生效后判断不清。
检查退出、重启与切网后的状态
修好后做两轮接管验证:运行客户端时确认系统设置与实际监听一致,退出后确认应用回到原本的代理状态。再在常用网络之间切一次,看看系统是否改用另一个网络服务或加载了原来的脚本。如果每次重启都被其他程序覆盖,先处理谁在写代理设置,而不是在多个工具里重复配置同一个端口。只剩一款应用不生效时,可在疑难解答对照应用接入方式。
客户端崩溃与启动失败
先区分启动阶段:窗体还没出现就退出,通常要看打包形式、依赖和目录权限;窗体能打开但启动内核时失败,则先查日志、监听端口和当前配置;程序没有退出只是窗口消失,还要确认是否已缩到托盘。三类情况的修复顺序不同。不要在第一次闪退后就覆盖旧文件,先让旧数据保持原样,便于定位或恢复。
确认安装包和运行环境对应
桌面端从安装包页面重新核对操作系统、处理器架构与打包形式。Windows 的桌面版和经典 WPF 版界面不同,运行时要求也要看所选包的说明;如果错误明确指出缺少某个 .NET 运行时,核对要求的运行时类型与架构,桌面运行时和基础运行时不是同一个组件。对于压缩包,先完整解压到当前用户可读写的目录,不要直接在压缩预览里启动可执行文件。
在 macOS 先核对芯片类型与包的架构,查看系统提示说的是来源限制、架构不匹配还是权限不足;在 Linux 核对发行版适用的包格式与架构,按包管理器给出的缺失依赖处理。不要为图省事全局解除系统防护或长期用管理员身份运行。若错误指向某个不可写目录,优先选择正常的用户数据路径,而不是赋予整个程序目录不必要的权限。
分清内核退出、端口冲突和配置错误
窗体仍可用时,在客户端日志里找启动本地内核的第一条失败信息。出现地址被占用,先看是否旧实例仍在运行,或另一个正常服务已经使用此端口。在 Windows 可按实际端口用以下命令查看监听进程的编号,再在任务管理器确认该编号的进程。不认识的进程不要直接结束,可以为客户端选择一个空闲端口,然后同步更新依赖该入口的代理配置。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
如果日志指向无法读取内核文件,检查解压是否完整、该路径是否存在以及系统安全记录中是否有相应提示。若报未知字段、无效出站或配置解析失败,先切回之前可用的节点和默认路由。错误里提到的字段可能出自客户端生成的配置,此时回到图形界面修改来源设置,比直接编辑每次启动都会重写的文件更有效。
保留数据,再用独立环境复现
怀疑用户配置损坏时,先退出客户端和残留内核进程,备份软件实际使用的数据目录,备份应放在仅自己能访问的位置。如果软件明确支持用新目录和独立数据启动,可用空配置做对照;否则先根据说明核对实际数据路径,不要以为换一个程序目录就自动隔离了数据。空配置能启动时,优先恢复一条订阅或一个已知正常的节点,再逐项恢复路由和界面设置。
空配置仍失败时,记录操作系统与架构、打包形式、客户端是否出现窗体,以及本机事件记录中相同时间的异常模块。日志目录不存在不等于没有报错,故障可能发生在应用建立日志之前。安卓端清除应用数据会移除本地配置,应在备份和确认可重新导入后才考虑。桌面端的案例可对照v2rayN 闪退与运行环境排查。
安卓授权、分应用与后台断连
安卓端先按断开的时机排查:点连接就失败,先看系统授权与已有 VPN;只有一款应用不能联网,先看分应用名单和模式;锁屏一段时间才断,先检查后台运行和电池策略。用同一个节点,在前台、锁屏和切换网络三种条件下分别验证,避免把内核连接超时、系统撤销服务和应用未被纳入代理混作同一个问题。
确认 VpnService 授权与系统占用
v2rayNG 首次启动 VPN 模式时,由 Android 弹出连接请求,确认提示中显示的是准备使用的客户端,再决定是否授权。若点连接没有弹窗,可能此前已经授权,也可能有现有 VPN 或设备管理策略阻止新连接。到系统的 VPN 页面查看当前提供方;在同一用户或工作资料内通常只有一个 VPN 能处于活动状态,另一个网络应用接管后,先前的 VPN 可能被撤销。
开启始终开启 VPN,和开启阻止未使用 VPN 的连接,是影响不同的两项系统设置。前者决定系统是否维持或尝试重建 VPN,后者可能在 VPN 断开时阻止普通网络请求。测试基础网络前先弄清它们是否开启,不要把策略生效误认为无线网络坏了。工作资料或受管理设备上的选项可能被锁定,应让管理员协助,不能以关闭防护为长期修复方案。
检查分应用名单的含义
进入客户端的分应用代理设置,先看当前列表代表“仅让选中的应用使用 VPN”,还是“让选中的应用绕过 VPN”。开启绕过模式后,同一个勾选状态的含义可能正好相反。排查时选两款容易区分的应用作为对照,一款应使用 VPN,另一款应按原网络访问,保存后重新连接 VPN,再分别发起新请求。仅刷新已有页面可能沿用旧连接,测试时应打开新页面或重新启动目标应用。
若同一个应用近期被重装、装在工作资料内或由系统分身功能创建,列表里显示的相同名称不一定指向正在测试的实例。应核对图标标识、所属资料和客户端可见的应用项。登录页也可能由系统浏览器或另一个组件打开,实际请求不是由原应用发出。查明发请求的应用后再调整名单,不要为了使一款应用正常,就把所有应用长期放进同一条出站。
用锁屏和切网测试定位后台中断
先前台连接并确认可用,再锁屏等待到足以重现故障的时间。解锁后不要立刻重连,先看 VPN 标记、持续通知和客户端日志。服务已消失而没有相应的节点报错,应优先查看系统是否限制后台;服务仍在、日志却出现连接重建或解析超时,应检查待机后接入线路是否变化。可用相同节点在无线网络和移动数据之间切换一次,单独验证旧连接在切换后是否能正常重建。
如果确认是后台限制,在系统的应用信息里找到电池或后台用量设置,只对所用客户端尝试选择允许后台运行或“不受限制”。部分设备另有自启动或后台活动限制,名称随系统而异,应按设备说明查找。改一项就重复同样的锁屏测试,留意是否改善以及电量变化。v2flyNG 也可用这套检查顺序,界面字段按实际显示为准;更多操作细节见安卓授权、省电与分应用设置。