适合使用 Windows 版 v2rayN、遇到内核启动失败或网页超时的读者。先用一条请求把日志和故障对上,再看报错指向本地监听、节点连接、域名解析还是 TLS 验证。每次只改一个设置,用同一条请求确认改动是否有效。
日志级别设置:只复现一次故障
v2rayN 界面的消息既可能来自客户端,也可能来自运行中的内核。订阅下载、配置生成和内核转发是不同环节:更新订阅时报超时,不等于已导入的节点无法建立连接。以下以 Windows 上 v2rayN 7.x 配合 Xray 为例;不同构建的选项排布可能不同,先确认正在运行的内核,再判断日志级别是否适用。
开启诊断日志
进入「设置」→「参数设置」→「Core: 基础设置」,找到「日志等级」,临时选
info;若同页有日志开关,一并确认已启用。保存后观察是否出现新的内核启动消息。只有现有信息不足时,才短时切到debug。固定测试条件
保持当前节点和路由模式不变,记下测试时间。排查 Windows 系统代理时,可在托盘菜单的「系统代理」中选择「自动配置系统代理」,再用遵循系统代理设置的浏览器打开一个之前失败的网址。若原故障出现在 TUN 模式,先按原模式复现,不要同时切换代理入口。
截取首条错误
在主窗口的消息区域找测试时间附近的记录。先留启动结果,再留本次请求的第一条具体报错和前后几行。记录错误针对哪个地址、哪个端口、哪个操作,不要只复制最后一行重试失败。
恢复日志级别
复测结束后恢复原级别,避免长期记录访问目标。对外分享时遮住订阅地址、用户 ID、令牌、节点地址和真实访问域名;保留端口类别及完整错误短语,才能判断是哪一段链路失败。
本地端口:先确认请求进了内核
客户端窗口能打开,不代表本地代理已监听。先在「设置」→「参数设置」中核对「本地监听端口」,再对照 Windows 系统代理中填写的地址与端口。下面的数字用于示范读日志,并不是每台机器的固定配置。
结论:先读地址,再读错误
看到 connection refused 时,先圈出错误行中的地址。若目标是 127.0.0.1:10808,先查本地监听;若目标是节点地址与端口,改 Windows 系统代理端口无法修复这次远端拒绝。
在 PowerShell 中可查询本机监听状态。把命令里的 10808 换成实际端口;这项检查不发起远端连接。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
- 没有该端口的监听记录:回到启动日志,找配置解析失败、内核退出或绑定失败;若命令本身报权限错误,不能据此判断端口未监听。
- 有记录,但进程不是预期内核:在任务管理器「详细信息」中按 PID 核对
OwningProcess。先辨认占用者,再决定退出重复实例还是更换监听端口;不要直接结束未知进程。 - 内核已监听,但测试时没有对应入站记录:确认当前日志级别能显示入站,再检查应用是否遵循系统代理、目标是否命中绕过规则,以及应用所用的代理类型是否与入站匹配。不要把仅支持 SOCKS 的入口当成 HTTP 代理填写。
常见报错:区分拒绝、超时和 TLS 验证
同一个错误短语可以出现在不同阶段。以下以错误行附近的操作和地址为判断依据;如果只看到外层的失败提示,继续读同一请求的内层错误,而不是先换协议。
报错:bind: address already in use
原因:本机端口无法绑定,常见于其他进程或另一实例已监听;Windows 上也可能显示系统自己的套接字错误文本。
解法:按端口查 PID,退出确认不再使用的重复实例,或换一个未占用端口并同步修改手工配置的代理入口。
报错:connection refused
原因:这次连接收到了拒绝响应,可能是目标未监听,也可能是链路上的设备主动拒绝。
解法:本机地址先查监听进程;节点地址则核对导入的端口,并让服务维护方确认对应入站是否在监听。
报错:i/o timeout
原因:某次操作超过等待期限;dial tcp 后的超时与已建立连接后的 read tcp 超时不是同一个阶段。
解法:建连超时先核对节点地址和端口;读取超时则保留握手与首条读错误,在同一网络下用另一条已知可用的节点做对照。
报错:no such host
原因:当前查询链路没有解析出所需主机名,出错的可能是节点域名,也可能是访问域名。
解法:先抄下 lookup 指向的名称并检查拼写,再区分系统解析与内核 DNS;系统能解析不代表内核使用的解析器一定能解析。
报错:x509: certificate has expired or is not yet valid
原因:普通 TLS 证书验证发现证书当前不在有效期内,本机时钟偏差也会触发这个错误。
解法:在 Windows「设置」→「时间和语言」→「日期和时间」同步时钟,复测仍失败则请维护方检查证书及证书链的有效期。
握手与路由:TCP 连通不等于网页可用
节点端口可达,只说明传输层可能走通。对普通 TLS 节点,后续仍须验证服务端名称和证书;握手通过后,也还要看请求是否命中预期出站。不要为消除报错而关闭证书验证,也不要把普通 TLS 的证书排查原样套到 REALITY 配置上。
- 先核对安全类型。打开当前节点编辑窗口,对照可信来源的原始配置核对传输方式和安全类型。普通 TLS 若提示证书有效名称与请求名称不符,核对服务器名称(SNI)以及证书覆盖的域名;连接地址能解析,不代表该地址就是应填写的服务器名称。
- 再核对实际出站。在同一请求的日志里找路由或出站信息。若该域名实际走了直连,先检查 v2rayN 当前选用的「路由」规则与匹配顺序,而不是反复更换代理节点。看到
accepted只表示内核接到了请求,不代表目标网站已经返回响应。 - 最后用对照缩小范围。同一个目标在两条节点上都失败,再换另一个测试目标;仅一个域名失败时,优先检查域名解析和分流。不改节点而换网络时,保持测试地址不变并记录结果,避免把网络变化误认为设置修复。
日志排查常见问题
测速有数字,为什么浏览器还是打不开?
测速与浏览器未必经过同一个入口,也未必访问同一个目标。记下浏览器刷新时间,确认内核接到这次请求,再读出站结果。没有入站记录时,优先查系统代理和浏览器的代理设置。
最后一行说找不到可用目标,该看哪一行?
failed to find an available destination 常是多次尝试失败后的汇总,不单指域名解析失败。沿同一请求向前找 lookup、dial 或证书错误;若多条日志交错,关闭其他测试页面后只复现一次。
为什么打开调试日志还是看不到网页请求?
先确认更改级别后内核成功启动,再用一个明确遵循系统代理的应用测试。若系统代理模式能看到请求,而原来的 TUN 模式看不到,就分别核对两种入口的设置,不要把它们的日志混作一次测试。
发给维护方的日志要留哪些信息?
从 v2rayN 的版本信息记录完整客户端版本号,从启动消息记录内核名称和版本,再附运行模式、复现时间及脱敏后的第一条具体错误。说明同一节点换网络、同一网络换节点的结果;没做过的对照注明未测。